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 the deployment service.

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 the deployment service.
Enroll by ID	None	Enroll azureADDevice resources in update management by the deployment service.
Unenroll from update management	None	Unenroll azureADDevice resources from update management by the deployment service.
Unenroll by ID	None	Unenroll azureADDevice resources from update management by the deployment service.

Properties

Property	Type	Description
enrollments	microsoft.graph.windowsUpdates.updatableAssetEnrollment collection	Specifies areas of the service 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 is a JSON representation of the resource.

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