WindowsUpdates.Read.All
Allows the app to read all Windows update deployment settings for the organization on behalf of the signed-in user.
Merill's Note
For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the
WindowsUpdates.Read.Allpermission.If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the
Export-MsIdAppConsentGrantReportcommand. See How To: Run a quick OAuth app audit of your tenant
| Category | Application | Delegated |
|---|---|---|
| Identifier | 50a8bf5f-b06a-4ac7-881f-3ca0c4be7550 | e09fef2d-bf5e-4439-affa-7c48d23bb1c2 |
| DisplayText | Read all Windows update deployment settings | Read all Windows update deployment settings |
| Description | Allows the app to read all Windows update deployment settings for the organization without a signed-in user. | Allows the app to read all Windows update deployment settings for the organization on behalf of the signed-in user. |
| AdminConsentRequired | Yes | Yes |
Graph Methods
→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)
| Methods |
|---|
→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)
| Methods | |
|---|---|
→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)
| Commands |
|---|
→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)
| Commands | |
|---|---|
Resources
Granting this permission allows the calling application to access (and/or update) the following information in your tenant.
- applicableCatalog
- applicableCatalogSummary
- applicableContent
- applicableDevice
- azureADDevice
- catalog
- catalogEntry
- complianceChange
- contentApproval
- deployment
- deploymentAudience
- deviceProfile
- driverUpdateDeviceStatus
- driverUpdatePolicy
- driverUpdateReport
- driverUpdateRing
- featureUpdateCatalogEntry
- featureUpdatePolicy
- featureUpdateRing
- mdmAppSetting
- operationalInsightsConnection
- policyApproval
- policyAssignment
- product
- qualityUpdateCatalogEntry
- qualityUpdatePolicy
- qualityUpdateRing
- resourceConnection
- ring
- tenantSetting
- updatableAsset
- updatableAssetGroup
- updatePolicy
Graph reference: applicableCatalog
| Property | Type | Description |
|---|---|---|
| deviceCount | Int32 | The number of devices for which the catalog entry is applicable. Read-only. |
| hasRecommendedDevice | Boolean | Indicates whether the catalog entry is recommended for at least one applicable device. Read-only. |
| id | String | The identifier of the associated catalog entry. Read-only. |
Graph reference: applicableCatalogSummary
| Property | Type | Description |
|---|---|---|
| aggregatedDeviceCount | Int32 | The number of devices included in the summary. Read-only. |
| hasRecommendedDevice | Boolean | Indicates whether the catalog entry is recommended for at least one device in the summary. Read-only. |
| id | String | The identifier of the associated catalog entry. Read-only. |
| policies | String collection | The identifiers of Windows Autopatch policies for which the catalog entry is applicable. Read-only. |
Graph reference: applicableContent
| Property | Type | Description |
|---|---|---|
| catalogEntryId | String | ID of the catalog entry for the applicable content. |
Graph reference: applicableDevice
| Property | Type | Description |
|---|---|---|
| id | String | The Microsoft Entra device identifier. Read-only. |
| isRecommended | Boolean | Indicates whether the catalog entry is recommended for the device. Read-only. |
Graph reference: azureADDevice
| Property | Type | Description |
|---|---|---|
| enrollment | microsoft.graph.windowsUpdates.updateManagementEnrollment | Specifies the update management enrollment for the device. Read-only. Returned by default. |
| errors | microsoft.graph.windowsUpdates.updatableAssetError collection | Specifies any errors that prevent the device from being enrolled in update management or receiving deployed content. Read-only. Returned by default. |
| id | String | An identifier for the device. Key. Not nullable. Read-only. Returned by default. Inherited from updatableAsset |
Graph reference: catalog
| Property | Type | Description |
|---|---|---|
| id | String | An identifier for the catalog. Read-only. |
Graph reference: catalogEntry
| Property | Type | Description |
|---|---|---|
| deployableUntilDateTime | DateTimeOffset | The date on which the content is no longer available to deploy. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. |
| displayName | String | The display name of the content. Read-only. |
| id | String | The unique identifier for the catalog entry. Read-only. |
| releaseDateTime | DateTimeOffset | The release date for the content. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. |
Graph reference: complianceChange
| Property | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | The date and time when a compliance change was created. |
| id | String | The unique identifier for the compliance change. Returned by default. Not nullable. Read-only. |
| isRevoked | Boolean | True indicates that a compliance change is revoked, preventing further application. Revoking a compliance change is a final action. |
| revokedDateTime | DateTimeOffset | The date and time when the compliance change was revoked. |
Graph reference: contentApproval
| Property | Type | Description |
|---|---|---|
| content | microsoft.graph.windowsUpdates.deployableContent | Specifies what content to deploy. Deployable content should be provided as one of the following derived types: microsoft.graph.windowsUpdates.catalogContent. |
| createdDateTime | DateTimeOffset | The date and time when a compliance change was created. Inherited from microsoft.graph.windowsUpdates.complianceChange. |
| deploymentSettings | microsoft.graph.windowsUpdates.deploymentSettings | Settings for governing how to deploy content. |
| id | String | The unique identifier for the compliance change. Returned by default. Not nullable. Read-only. Inherited from microsoft.graph.windowsUpdates.complianceChange. |
| isRevoked | Boolean | True indicates that a compliance change is revoked, preventing further application. Revoking a compliance change is a final action. Inherited from microsoft.graph.windowsUpdates.complianceChange. |
| revokedDateTime | DateTimeOffset | The date and time when the compliance change was revoked. Inherited from microsoft.graph.windowsUpdates.complianceChange. |
Graph reference: deployment
| Property | Type | Description |
|---|---|---|
| content | microsoft.graph.windowsUpdates.deployableContent | Specifies what content to deploy. Cannot be changed. Returned by default. |
| createdDateTime | DateTimeOffset | The date and time the deployment was created. Returned by default. Read-only. |
| id | String | The unique identifier for the deployment. Returned by default. Key. Not nullable. Read-only. |
| lastModifiedDateTime | DateTimeOffset | The date and time the deployment was last modified. Returned by default. Read-only. |
| settings | microsoft.graph.windowsUpdates.deploymentSettings | Settings specified on the specific deployment governing how to deploy content. Returned by default. |
| state | microsoft.graph.windowsUpdates.deploymentState | Execution status of the deployment. Returned by default. |
Graph reference: deploymentAudience
| Property | Type | Description |
|---|---|---|
| id | String | The unique identifier for the deployment audience. Returned by default. Not nullable. Read-only. |
Graph reference: deviceProfile
| Property | Type | Description |
|---|---|---|
| azureAdDeviceId | String | The Microsoft Entra device identifier. Read-only. |
| deviceModel | String | The hardware model of the device. Read-only. |
| deviceName | String | The device name. Read-only. |
| hotpatchReadiness | windowsUpdates.hotpatchReadiness | The device's readiness for hotpatch updates. The possible values are: ready, notReady, unknownFutureValue. Read-only. |
| id | String | The unique identifier for the device profile. Read-only. |
| osBuild | String | The Windows build installed on the device. Read-only. |
| osStatus | windowsUpdates.osStatus | The servicing status of the device's Windows version. The possible values are: endOfServicing, inServicing, nearEndOfServicing, unknownFutureValue. Read-only. |
| osVersion | String | The Windows version installed on the device. Read-only. |
| serialNumber | String | The device serial number. Read-only. |
Graph reference: driverUpdateDeviceStatus
| Property | Type | Description |
|---|---|---|
| aadDeviceId | String | The Microsoft Entra identifier of the device. Read-only. |
| clientState | windowsUpdates.deviceClientState | The rollout state reported by the device. The possible values are: offering, onHold, installing, installed, cancelled, uninstalling, uninstalled, notOffering, unknownFutureValue. Read-only. |
| clientSubstate | windowsUpdates.deviceClientSubstate | The detailed rollout substate reported by the device. The possible values are: deferred, offerReady, paused, offerReceived, downloadStart, downloadComplete, installStart, installComplete, restartRequired, restartInitiated, restartComplete, updateInstalled, rollbackComplete, userCancelled, deviceCancelled, uninstall, rollback, updateUninstalled, notSupported, previousUpdateInProgress, unknownFutureValue. Read-only. |
| deviceName | String | The device name. Read-only. |
| id | String | The composite identifier for the driver update status. Read-only. |
| lastEventDateTime | DateTimeOffset | The date and time of the latest status event. Read-only. |
| policyId | String | The identifier of the driver update policy. Read-only. |
| policyName | String | The display name of the driver update policy. Read-only. |
| ringId | String | The identifier of the Windows Autopatch ring. Read-only. |
| ringName | String | The display name of the Windows Autopatch ring. Read-only. |
| serviceState | windowsUpdates.deviceServiceState | The rollout state maintained by the service. The possible values are: unknown, pending, offering, onHold, cancelled, notOffering, unknownFutureValue. Read-only. |
| serviceSubstate | windowsUpdates.deviceServiceSubstate | The detailed rollout substate maintained by the service. The possible values are: unknown, scheduled, offerReady, adminPaused, adminCancelled, removedFromDeployment, notOffering, unknownFutureValue. Read-only. |
Graph reference: driverUpdatePolicy
| Property | Type | Description |
|---|---|---|
| approvalRules | microsoft.graph.windowsUpdates.approvalRule collection | The rules that determine how matching driver and firmware update content is approved. Inherited from policy. |
| createdDateTime | DateTimeOffset | The date and time when the policy was created. Read-only. Inherited from policy. |
| description | String | The policy description. The maximum length is 1,500 characters. Inherited from policy. |
| displayName | String | The policy display name. The maximum length is 200 characters. Inherited from policy. |
| id | String | The unique identifier for the policy. Read-only. Inherited from policy. |
| lastModifiedDateTime | DateTimeOffset | The date and time when the policy was last modified. Read-only. Inherited from policy. |
Graph reference: driverUpdateReport
| Property | Type | Description |
|---|---|---|
| class | String | The device class targeted by the driver update. Read-only. |
| displayName | String | The display name of the driver update. Read-only. |
| id | String | The catalog entry identifier of the driver update. Read-only. |
| manufacturer | String | The manufacturer of the driver update. Read-only. |
| releaseDateTime | DateTimeOffset | The date and time when the driver update was released. Read-only. |
| version | String | The driver version. Read-only. |
Graph reference: driverUpdateRing
| Property | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | The date and time when the ring was created. Read-only. Inherited from ring. |
| deferralInDays | Int32 | The number of days to defer the update offer. Inherited from ring. |
| description | String | The ring description. The maximum length is 1,500 characters. Inherited from ring. |
| displayName | String | The ring display name. The maximum length is 200 characters. Inherited from ring. |
| excludedGroupAssignment | microsoft.graph.windowsUpdates.excludedGroupAssignment | The Microsoft Entra groups whose devices are excluded from the ring. Inherited from ring. |
| id | String | The unique identifier for the ring. Read-only. Inherited from ring. |
| includedGroupAssignment | microsoft.graph.windowsUpdates.includedGroupAssignment | The Microsoft Entra groups whose devices are included in the ring. Inherited from ring. |
| isPaused | Boolean | Indicates whether update offers for the ring are paused. Inherited from ring. |
| lastModifiedDateTime | DateTimeOffset | The date and time when the ring was last modified. Read-only. Inherited from ring. |
Graph reference: featureUpdateCatalogEntry
| Property | Type | Description |
|---|---|---|
| buildNumber | String | The build number of the feature update. Read-only. |
| deployableUntilDateTime | DateTimeOffset | The date on which the content is no longer available for deployment. Read-only. Inherited from softwareUpdateCatalogEntry. |
| displayName | String | The display name of the content. Read-only. Inherited from softwareUpdateCatalogEntry. |
| id | String | The unique identifier for the catalog entry. Read-only. Inherited from softwareUpdateCatalogEntry. |
| releaseDateTime | DateTimeOffset | The release date for the content. Read-only. Inherited from softwareUpdateCatalogEntry. |
| version | String | The version of the feature update. Read-only. |
Graph reference: featureUpdatePolicy
| Property | Type | Description |
|---|---|---|
| approvalRules | microsoft.graph.windowsUpdates.approvalRule collection | The rules that determine how matching feature update content is approved. Inherited from policy. |
| createdDateTime | DateTimeOffset | The date and time when the feature update policy is created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Inherited from microsoft.graph.windowsUpdates.policy. |
| description | String | The feature update policy description. The maximum length is 1,500 characters. Inherited from microsoft.graph.windowsUpdates.policy. |
| displayName | String | The feature update policy display name. The maximum length is 200 characters. Inherited from microsoft.graph.windowsUpdates.policy. |
| id | String | The policy unique identifier. Inherited from microsoft.graph.windowsUpdates.policy. |
| lastModifiedDateTime | DateTimeOffset | The date and time when the feature update policy was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Inherited from microsoft.graph.windowsUpdates.policy. |
Graph reference: featureUpdateRing
| Property | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | The date and time when the feature updates ring is created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from ring. |
| deferralInDays | Int32 | The feature update deferral period in days. The value must be between 0 and 30. Inherited from ring. |
| description | String | The feature update ring description. The maximum length is 1,500 characters. Inherited from ring. |
| displayName | String | The feature update ring display name. The maximum length is 200 characters. Inherited from ring. |
| excludedGroupAssignment | microsoft.graph.windowsUpdates.excludedGroupAssignment | Governs the update deployment audience with excluded groups. Groups are logical containers of devices represented by Microsoft Entra groups. Inherited from ring. |
| id | String | The unique identifier for the feature update ring. Inherited from ring. |
| includedGroupAssignment | microsoft.graph.windowsUpdates.includedGroupAssignment | Governs the update deployment audience with included groups. Groups are logical containers of devices represented by Microsoft Entra groups. Inherited from ring. |
| isOfferOptional | Boolean | Indicates whether the feature update is offered to end users as optional rather than required. Default is false. |
| isPaused | Boolean | Represents the pause action for the feature update ring policy. Inherited from ring. |
| lastModifiedDateTime | DateTimeOffset | The date and time the feature updates ring was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from ring. |
| offerDurationInDays | Int32 | The total length of the gradual-rollout window, in days, from when the update is first offered to when the rollout completes. The minimum is 1. Only used when offerIntervalInDays is 1 or greater; ignored when offerIntervalInDays is 0. Default is 1. |
| offerIntervalInDays | Int32 | How often, in days, a new subset of devices is offered the update. Accepted range is 0 to 30. Set to 0 to offer the update to all devices at once. When the value is 1 or greater, the rollout advances one subset at each interval until every device has been offered the update. Must be less than or equal to **o |
Graph reference: mdmAppSetting
| Property | Type | Description |
|---|---|---|
| isHotpatchEnabled | Boolean | Whether hotpatch is enabled for this MDM application. The default is true. |
| mdmAppId | String | The unique identifier of the MDM application as a GUID-formatted string. This property is the resource key and can't be updated. |
Graph reference: operationalInsightsConnection
| Property | Type | Description |
|---|---|---|
| azureResourceGroupName | String | The name of the Azure resource group that contains the Log Analytics workspace. |
| azureSubscriptionId | String | The Azure subscription ID that contains the Log Analytics workspace. |
| id | String | An identifier for the resource connection. Key. Not nullable. Read-only. Returned by default. |
| state | microsoft.graph.windowsUpdates.resourceConnectionState | The state of the connection. The possible values are: connected, notAuthorized, notFound, unknownFutureValue. |
| workspaceName | String | The name of the Log Analytics workspace. |
[windowsUpdates policy](#tab/windowsUpdates policy22)
Graph reference: windowsUpdates policy
| Property | Type | Description |
|---|---|---|
| approvalRules | microsoft.graph.windowsUpdates.approvalRule collection | The approved rule of the policy that determines which published content matches the rule on an ongoing basis. |
| createdDateTime | DateTimeOffset | The date and time when the policy is created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. |
| description | String | The policy description. The maximum length is 1,500 characters. |
| displayName | String | The policy display name. The maximum length is 200 characters. |
| id | String | The policy unique identifier. |
| lastModifiedDateTime | DateTimeOffset | The date and time when the policy was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. |
Graph reference: policyApproval
| Property | Type | Description |
|---|---|---|
| approvedBy | windowsUpdates.approvedBy | Identifies who approved the content. The possible values are: system, user, unknownFutureValue. This property is set by the service. Read-only. |
| catalogEntryId | String | The catalog entry ID to approve. |
| createdDateTime | DateTimeOffset | The date and time the policy approval is created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. |
| id | String | The unique identifier for the policy approval. Read-only. |
| lastModifiedDateTime | DateTimeOffset | The date and time the policy approval was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. |
| startDateTime | DateTimeOffset | The date and time when the approved content can start being offered. If omitted when the approval is created, the service uses the current time. |
| status | windowsUpdates.approvalStatus | The approval status. The possible values are: approved, suspended, unknownFutureValue. |
Graph reference: policyAssignment
| Property | Type | Description |
|---|---|---|
| azureAdDeviceId | String | The Microsoft Entra identifier of the assigned device. Read-only. |
| id | String | The unique identifier for the assignment. Read-only. |
| policyId | String | The identifier of the assigned Windows Autopatch policy. Read-only. |
| policyName | String | The display name of the assigned Windows Autopatch policy. Read-only. |
Graph reference: product
| Property | Type | Description |
|---|---|---|
| friendlyNames | String collection | The friendly names of the product. For example, Version 22H2 (OS build 22621). Read-only. |
| groupName | String | The name of the product group. For example, Windows 11. Read-only. |
| id | String | The unique identifier for the product. Read-only. |
| name | String | The name of the product. For example, Windows 11, version 22H2. Read-only. |
Graph reference: qualityUpdateCatalogEntry
| Property | Type | Description |
|---|---|---|
| catalogName | String | The catalog name of the content. Read-only. |
| cveSeverityInformation | microsoft.graph.windowsUpdates.qualityUpdateCveSeverityInformation | Severity information of the Common Vulnerabilities and Exposures associated with the content. |
| deployableUntilDateTime | DateTimeOffset | The date on which the content is no longer available for deployment. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Inherited from softwareUpdateCatalogEntry. |
| displayName | String | The display name of the content. Read-only. Inherited from softwareUpdateCatalogEntry. |
| id | String | The unique identifier for the catalog entry. Read-only. Inherited from softwareUpdateCatalogEntry. |
| isExpeditable | Boolean | Indicates whether the content can be deployed as an expedited quality update. Read-only. |
| qualityUpdateCadence | microsoft.graph.windowsUpdates.qualityUpdateCadence | The publishing cadence of the quality update. The possible values are: monthly, outOfBand, unknownFutureValue. Read-only. |
| qualityUpdateClassification | microsoft.graph.windowsUpdates.qualityUpdateClassification | The classification on the quality update. The possible values are: all, security, nonSecurity, unknownFutureValue. Read-only. |
| releaseDateTime | DateTimeOffset | The release date of the content. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Inherited from softwareUpdateCatalogEntry. |
| shortName | String | The short name of the content. Read-only. |
Graph reference: qualityUpdatePolicy
| Property | Type | Description |
|---|---|---|
| approvalRules | microsoft.graph.windowsUpdates.approvalRule collection | The approved rule of the policy that determines which published content matches the rule on an ongoing basis. Inherited from microsoft.graph.windowsUpdates.policy. |
| createdDateTime | DateTimeOffset | The date and time when the quality update policy is created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Inherited from microsoft.graph.windowsUpdates.policy. |
| description | String | The quality update policy description. The maximum length is 1,500 characters. Inherited from microsoft.graph.windowsUpdates.policy. |
| displayName | String | The quality update policy display name. The maximum length is 200 characters. Inherited from microsoft.graph.windowsUpdates.policy. |
| id | String | The policy unique identifier. Inherited from microsoft.graph.windowsUpdates.policy. |
| lastModifiedDateTime | DateTimeOffset | The date and time when the quality update policy was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Inherited from microsoft.graph.windowsUpdates.policy. |
Graph reference: qualityUpdateRing
| Property | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | The date and time when the quality updates ring is created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from ring. |
| deferralInDays | Int32 | The quality update deferral period in days. The value must be between 0 and 30. Inherited from ring. |
| description | String | The quality update ring description. The maximum length is 1,500 characters. Inherited from ring. |
| displayName | String | The quality update ring display name. The maximum length is 200 characters. Inherited from ring. |
| excludedGroupAssignment | microsoft.graph.windowsUpdates.excludedGroupAssignment | Governs the update deployment audience with excluded groups. Groups are logical containers of devices represented by Microsoft Entra groups. Inherited from ring. |
| id | String | The unique identifier for the quality update ring. Inherited from ring. |
| includedGroupAssignment | microsoft.graph.windowsUpdates.includedGroupAssignment | Governs the update deployment audience with included groups. Groups are logical containers of devices represented by Microsoft Entra groups. Inherited from ring. |
| isHotpatchEnabled | Boolean | Identifies whether a hotpatch update is available. |
| isPaused | Boolean | Represents the pause action for the quality update ring policy. Inherited from ring. |
| lastModifiedDateTime | DateTimeOffset | The date and time the quality updates ring was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Inherited from ring. |
Graph reference: resourceConnection
| Property | Type | Description |
|---|---|---|
| id | String | An identifier for the resource connection. Key. Not nullable. Read-only. Returned by default. |
| state | microsoft.graph.windowsUpdates.resourceConnectionState | The state of the connection. The possible values are: connected, notAuthorized, notFound, unknownFutureValue. |
Graph reference: ring
| Property | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | The date and time when the ring is created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only |
| deferralInDays | Int32 | The update deferral period in days. The value must be between 0 and 30. Optional. |
| description | String | The ring description. The maximum length is 1,500 characters. Required |
| displayName | String | The ring display name. The maximum length is 200 characters. Required. |
| excludedGroupAssignment | microsoft.graph.windowsUpdates.excludedGroupAssignment | Governs the update deployment audience with excluded groups. Groups are logical containers of devices represented by Microsoft Entra groups. |
| id | String | The unique identifier for the ring object. |
| includedGroupAssignment | microsoft.graph.windowsUpdates.includedGroupAssignment | Governs the update deployment audience with included groups. Groups are logical containers of devices represented by Microsoft Entra groups. |
| isPaused | Boolean | The pause action for the update ring. Required. |
| lastModifiedDateTime | DateTimeOffset | The date and time when the ring was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. |
Graph reference: tenantSetting
| Property | Type | Description |
|---|---|---|
| areDataProcessorServiceForWindowsFeaturesEnabled | Boolean | Whether Data Processor Service for Windows (DPSW) features are enabled for this tenant. The default is false. |
Graph reference: updatableAsset
| Property | Type | Description |
|---|---|---|
| id | String | An identifier for the asset. Key. Not nullable. Read-only. Returned by default. |
Graph reference: updatableAssetGroup
| Property | Type | Description |
|---|---|---|
| id | String | An identifier for the group. Key. Not nullable. Read-only. Returned by default. Inherited from microsoft.graph.windowsUpdates.updatableAsset. |
Graph reference: updatePolicy
| Property | Type | Description |
|---|---|---|
| complianceChangeRules | microsoft.graph.windowsUpdates.complianceChangeRule collection | Rules for governing the automatic creation of compliance changes. |
| createdDateTime | DateTimeOffset | The date and time when the update policy was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. |
| deploymentSettings | microsoft.graph.windowsUpdates.deploymentSettings | Settings for governing how to deploy content. |
| id | String | Unique identifier for the update policy. |