074a65669b
- Fix update ring inventory filter using isof() - Hydrate + restore Windows Update Ring via derived-type endpoint - Add Windows Feature/Quality Update Profile support - Stabilize tenant selection in tests
78 lines
4.8 KiB
Markdown
78 lines
4.8 KiB
Markdown
# Feature Specification: Windows Update Rings (012)
|
|
|
|
**Feature Branch**: `feat/012-windows-update-rings`
|
|
**Created**: 2025-12-31
|
|
**Status**: Draft
|
|
**Input**: `config/graph_contracts.php` (windowsUpdateRing scope)
|
|
|
|
## Overview
|
|
Add reliable coverage for **Windows Update Rings** (`windowsUpdateRing`) in the existing inventory/backup/version/restore flows.
|
|
|
|
This feature also extends coverage to **Windows Feature Update Profiles** ("Feature Updates"), which are managed under the `deviceManagement/windowsFeatureUpdateProfiles` endpoint and have `@odata.type` `#microsoft.graph.windowsFeatureUpdateProfile`.
|
|
|
|
This feature also extends coverage to **Windows Quality Update Profiles** ("Quality Updates"), which are managed under the `deviceManagement/windowsQualityUpdateProfiles` endpoint and have `@odata.type` `#microsoft.graph.windowsQualityUpdateProfile`.
|
|
|
|
This policy type is defined in `graph_contracts.php` and uses the `deviceManagement/deviceConfigurations` endpoint, identified by the `@odata.type` `#microsoft.graph.windowsUpdateForBusinessConfiguration`. This feature will focus on implementing the necessary UI normalization and ensuring the sync, backup, versioning, and restore flows function correctly for this policy type.
|
|
|
|
## In Scope
|
|
- Policy type: `windowsUpdateRing`
|
|
- Sync: Policies with `@odata.type` of `#microsoft.graph.windowsUpdateForBusinessConfiguration` should be correctly identified and synced as `windowsUpdateRing` policies.
|
|
- Snapshot capture: Full snapshot of all settings within a Windows Update Ring policy.
|
|
- Restore: Restore a Windows Update Ring policy from a snapshot.
|
|
- UI: Display the settings of a Windows Update Ring policy in a readable, normalized format.
|
|
|
|
- Policy type: `windowsFeatureUpdateProfile`
|
|
- Sync: Feature Update Profiles should be listed and synced from `deviceManagement/windowsFeatureUpdateProfiles`.
|
|
- Snapshot capture: Full snapshot of the Feature Update Profile payload.
|
|
- Restore: Restore a Feature Update Profile from a snapshot.
|
|
- UI: Display the key settings of a Feature Update Profile in a readable, normalized format.
|
|
|
|
- Policy type: `windowsQualityUpdateProfile`
|
|
- Sync: Quality Update Profiles should be listed and synced from `deviceManagement/windowsQualityUpdateProfiles`.
|
|
- Snapshot capture: Full snapshot of the Quality Update Profile payload.
|
|
- Restore: Restore a Quality Update Profile from a snapshot.
|
|
- UI: Display the key settings of a Quality Update Profile in a readable, normalized format.
|
|
|
|
## Out of Scope (v1)
|
|
- Advanced analytics or reporting on update compliance.
|
|
- Per-setting partial restore.
|
|
|
|
## User Scenarios & Testing *(mandatory)*
|
|
|
|
### User Story 1 — Inventory + readable view
|
|
As an admin, I can see my Windows Update Ring policies in the policy list and view their configured settings in a clear, understandable format.
|
|
|
|
**Acceptance**
|
|
1. Windows Update Ring policies are listed in the main policy table with the correct type name.
|
|
2. The policy detail view shows a structured list/table of configured settings (e.g., "Quality update deferral period", "Automatic update behavior").
|
|
3. Policy Versions store the snapshot and render the settings in the “Normalized settings” view.
|
|
|
|
### User Story 2 — Backup/Version capture
|
|
As an admin, when I back up or create a new version of a Windows Update Ring policy, the snapshot contains all its settings.
|
|
|
|
**Acceptance**
|
|
1. The backup/version payload in the `snapshot` column contains all the properties of the `windowsUpdateForBusinessConfiguration` object.
|
|
|
|
### User Story 3 — Restore settings
|
|
As an admin, I can restore a Windows Update Ring policy from a backup or a previous version.
|
|
|
|
**Acceptance**
|
|
1. The restore operation correctly applies the settings from the snapshot to the target policy in Intune.
|
|
2. The restore process is audited.
|
|
|
|
### User Story 4 — Feature Updates inventory + readable view
|
|
As an admin, I can see my Windows Feature Update Profiles in the policy list and view their configured rollout/version settings in a clear, understandable format.
|
|
|
|
**Acceptance**
|
|
1. Feature Update Profiles are listed in the main policy table with the correct type name.
|
|
2. The policy detail view shows a structured list/table of configured settings (e.g., feature update version, rollout window).
|
|
3. Policy Versions store the snapshot and render the settings in the “Normalized settings” view.
|
|
|
|
### User Story 5 — Quality Updates inventory + readable view
|
|
As an admin, I can see my Windows Quality Update Profiles in the policy list and view their configured release/content settings in a clear, understandable format.
|
|
|
|
**Acceptance**
|
|
1. Quality Update Profiles are listed in the main policy table with the correct type name.
|
|
2. The policy detail view shows a structured list/table of configured settings (e.g., release, deployable content).
|
|
3. Policy Versions store the snapshot and render the settings in the “Normalized settings” view.
|