azureADDevice 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.

Represents a device in Microsoft Entra ID that is registered with Windows Autopatch.

A Microsoft Entra device is automatically created through one of the following methods:

• updatableAsset: enrollAssets
• updatableAsset: enrollAssetsById
• deploymentAudience: updateAudience
• deploymentAudience: updateAudienceById
• updatableAssetGroup: addMembers
• updatableAssetGroup: addMembersById

Inherits from updatableAsset.

Methods

Method	Return type	Description
List Microsoft Entra devices	microsoft.graph.windowsUpdates.azureADDevice collection	Get a list of the azureADDevice objects and their properties.
Get Microsoft Entra device	microsoft.graph.windowsUpdates.azureADDevice	Read the properties and relationships of an azureADDevice object.
Delete Microsoft Entra device	None	Delete an azureADDevice object.
Enroll in update management	None	Enroll azureADDevice resources in update management by Windows Autopatch.
Enroll by ID	None	Enroll azureADDevice resources of the same type in update management by Windows Autopatch.
Unenroll from update management	None	Unenroll azureADDevice resources from update management by Windows Autopatch.
Unenroll by ID	None	Unenroll azureADDevice resources of the same type from update management by Windows Autopatch.

Properties

Property	Type	Description
enrollments	microsoft.graph.windowsUpdates.updatableAssetEnrollment collection	Specifies areas in which the device is enrolled. 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 receving 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

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.windowsUpdates.azureADDevice",
  "id": "String (identifier)",
  "errors": [
    {
      "@odata.type": "microsoft.graph.windowsUpdates.azureADDeviceRegistrationError"
    }
  ],
  "enrollments": [
    {
      "@odata.type": "microsoft.graph.windowsUpdates.updateManagementEnrollment"
    }
  ]
}