Edit

windowsUpdates policy resource type

Namespace: microsoft.graph.windowsUpdates

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

An abstract type that governs the update deployment settings content for an associated deployment audience. This audience can consist of one or more Microsoft Entra groups. You can't instantiate this resource directly; use one of its derived types.

Base type of driverUpdatePolicy, featureUpdatePolicy, and qualityUpdatePolicy. Instances in a policy collection are differentiated by the @odata.type property, which identifies the derived type of each object.

Methods

Method Return type Description
List policies microsoft.graph.windowsUpdates.policy collection Get a list of the policy objects and their properties.
Create policy microsoft.graph.windowsUpdates.policy Create a new Windows update policy object.
Get policy microsoft.graph.windowsUpdates.policy Read the properties and relationships of a policy object.
Update policy microsoft.graph.windowsUpdates.policy Update the properties of a policy object.
Delete policy None Delete a Windows update policy object.
List applicableCatalogs microsoft.graph.windowsUpdates.applicableCatalog collection List catalog entries that are applicable to devices targeted by the policy.
List applicableContent microsoft.graph.windowsUpdates.applicableContent collection List applicable update content to offer to Microsoft Entra groups, Windows Autopatch groups, or both.
List approvals microsoft.graph.windowsUpdates.policyApproval collection Get a list of the policyApproval objects and their properties.
Create policyApproval microsoft.graph.windowsUpdates.policyApproval Create a new policyApproval object.
List rings microsoft.graph.windowsUpdates.ring collection Get a list of the ring objects and their properties.
Create ring microsoft.graph.windowsUpdates.ring Create a new ring object.

Properties

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.

Relationships

Relationship Type Description
applicableCatalogs microsoft.graph.windowsUpdates.applicableCatalog collection The catalog entries that apply to devices targeted by the policy.
applicableContent microsoft.graph.windowsUpdates.applicableContent collection The existing applicable-content collection. For driver and feature update applicability, use applicableCatalogs.
approvals microsoft.graph.windowsUpdates.policyApproval collection The update content approvals associated with the policy.
rings microsoft.graph.windowsUpdates.ring collection The deployment rings that define targeting, deferral, and pause settings for the policy.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.windowsUpdates.policy",
  "approvalRules": [{"@odata.type": "microsoft.graph.windowsUpdates.approvalRule"}],
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)"
}
  • Last updated on