Edit

Share via

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.

Base type of policy.

Methods

Method Return type Description
List microsoft.graph.windowsUpdates.policy collection Get a list of the policy objects and their properties.
Create microsoft.graph.windowsUpdates.policy Create a new Windows update policy object.
Get microsoft.graph.windowsUpdates.policy Read the properties and relationships of a policy object.
Update microsoft.graph.windowsUpdates.policy Update the properties of a policy object.
Delete None Delete a Windows update policy object.
List applicable content 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 policy approval 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
applicableContent microsoft.graph.windowsUpdates.policyApproval collection Represents content applicable for offering to the related collection of devices.
approvals microsoft.graph.windowsUpdates.policyApproval collection Represents a set of quality updates policy approval types.
rings microsoft.graph.windowsUpdates.ring collection Represents a set of deployment rings that contains update deployment settings.

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