创建 windowsAutopilotDeviceIdentity

命名空间：microsoft.graph

重要： /beta 版本下的 Microsoft Graph API 可能会更改;不支持生产使用。

注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。

创建新的 windowsAutopilotDeviceIdentity 对象。

此 API 可用于以下国家级云部署。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	✅	✅	✅

权限

要调用此 API，需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All

HTTP 请求

POST /deviceManagement/windowsAutopilotDeviceIdentities
POST /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDeviceIdentityId}/deploymentProfile/assignedDevices

请求标头

标头	值
Authorization	持有者 {token}。 必填。 详细了解 身份验证和授权。
接受	application/json

请求正文

在请求正文中，提供 windowsAutopilotDeviceIdentity 对象的 JSON 表示形式。

下表显示了创建 windowsAutopilotDeviceIdentity 时所需的属性。

属性	类型	说明
id	String	对象的 GUID
deploymentProfileAssignmentStatus	windowsAutopilotProfileAssignmentStatus	Windows autopilot 设备的配置文件分配状态。 可取值为：unknown、assignedInSync、assignedOutOfSync、assignedUnkownSyncState、notAssigned、pending 或 failed。
deploymentProfileAssignmentDetailedStatus	windowsAutopilotProfileAssignmentDetailedStatus	Windows autopilot 设备的配置文件分配详细状态。 可取值为：none、hardwareRequirementsNotMet、surfaceHubProfileNotSupported、holoLensProfileNotSupported、windowsPcProfileNotSupported、surfaceHub2SProfileNotSupported 或 unknownFutureValue。
deploymentProfileAssignedDateTime	DateTimeOffset	分析 Windows autopilot 设备的设置时间。
groupTag	String	Windows autopilot 设备的组标记。
purchaseOrderIdentifier	String	Windows autopilot 设备的采购订单标识符。
serialNumber	String	Windows autopilot 设备序列号。
productKey	String	Windows autopilot 设备产品密钥。
manufacturer	String	Windows autopilot 设备的 Oem 制造商。
model	String	Windows autopilot 设备的型号名称。
enrollmentState	enrollmentState	Intune Windows autopilot 设备的注册状态。 可取值为：unknown、enrolled、pendingReset、failed、notContacted、blocked。
lastContactedDateTime	DateTimeOffset	Intune Windows autopilot 设备的上次联系日期时间。
addressableUserName	String	可寻址用户名。
userPrincipalName	String	用户主体名称。
resourceName	String	资源名称。
skuNumber	String	SKU 编号
systemFamily	String	系统系列
azureActiveDirectoryDeviceId	String	AAD 设备 ID - 要弃用
azureAdDeviceId	String	AAD 设备 ID
managedDeviceId	String	托管设备 ID
displayName	String	显示名称
deviceAccountUpn	String	Surface Hub 设备帐户 Upn
deviceAccountPassword	String	Surface Hub 设备帐户密码
deviceFriendlyName	String	Surface Hub 设备友好名称
remediationState	windowsAutopilotDeviceRemediationState	设备修正状态。 可取值为：unknown、noRemediationRequired、automaticRemediationRequired、manualRemediationRequired、unknownFutureValue。
remediationStateLastModifiedDateTime	DateTimeOffset	RemediationState Autopilot 设备的设置时间。
userlessEnrollmentStatus	windowsAutopilotUserlessEnrollmentStatus	无用户注册的注册状态。 可能的值是：unknown、allowed、blocked、unknownFutureValue。

响应

如果成功，此方法在响应正文中返回响应 201 Created 代码和 windowsAutopilotDeviceIdentity 对象。

示例

请求

下面是一个请求示例。

POST https://graph.microsoft.com/beta/deviceManagement/windowsAutopilotDeviceIdentities
Content-type: application/json
Content-length: 1413

{
  "@odata.type": "#microsoft.graph.windowsAutopilotDeviceIdentity",
  "deploymentProfileAssignmentStatus": "assignedInSync",
  "deploymentProfileAssignmentDetailedStatus": "hardwareRequirementsNotMet",
  "deploymentProfileAssignedDateTime": "2016-12-31T23:58:26.2447023-08:00",
  "groupTag": "Group Tag value",
  "purchaseOrderIdentifier": "Purchase Order Identifier value",
  "serialNumber": "Serial Number value",
  "productKey": "Product Key value",
  "manufacturer": "Manufacturer value",
  "model": "Model value",
  "enrollmentState": "enrolled",
  "lastContactedDateTime": "2016-12-31T23:58:44.2908994-08:00",
  "addressableUserName": "Addressable User Name value",
  "userPrincipalName": "User Principal Name value",
  "resourceName": "Resource Name value",
  "skuNumber": "Sku Number value",
  "systemFamily": "System Family value",
  "azureActiveDirectoryDeviceId": "Azure Active Directory Device Id value",
  "azureAdDeviceId": "Azure Ad Device Id value",
  "managedDeviceId": "Managed Device Id value",
  "displayName": "Display Name value",
  "deviceAccountUpn": "Device Account Upn value",
  "deviceAccountPassword": "Device Account Password value",
  "deviceFriendlyName": "Device Friendly Name value",
  "remediationState": "noRemediationRequired",
  "remediationStateLastModifiedDateTime": "2017-01-01T00:00:10.730021-08:00",
  "userlessEnrollmentStatus": "allowed"
}

响应

下面是一个响应示例。 注意：为简洁起见，可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1462

{
  "@odata.type": "#microsoft.graph.windowsAutopilotDeviceIdentity",
  "id": "fac6f0b1-f0b1-fac6-b1f0-c6fab1f0c6fa",
  "deploymentProfileAssignmentStatus": "assignedInSync",
  "deploymentProfileAssignmentDetailedStatus": "hardwareRequirementsNotMet",
  "deploymentProfileAssignedDateTime": "2016-12-31T23:58:26.2447023-08:00",
  "groupTag": "Group Tag value",
  "purchaseOrderIdentifier": "Purchase Order Identifier value",
  "serialNumber": "Serial Number value",
  "productKey": "Product Key value",
  "manufacturer": "Manufacturer value",
  "model": "Model value",
  "enrollmentState": "enrolled",
  "lastContactedDateTime": "2016-12-31T23:58:44.2908994-08:00",
  "addressableUserName": "Addressable User Name value",
  "userPrincipalName": "User Principal Name value",
  "resourceName": "Resource Name value",
  "skuNumber": "Sku Number value",
  "systemFamily": "System Family value",
  "azureActiveDirectoryDeviceId": "Azure Active Directory Device Id value",
  "azureAdDeviceId": "Azure Ad Device Id value",
  "managedDeviceId": "Managed Device Id value",
  "displayName": "Display Name value",
  "deviceAccountUpn": "Device Account Upn value",
  "deviceAccountPassword": "Device Account Password value",
  "deviceFriendlyName": "Device Friendly Name value",
  "remediationState": "noRemediationRequired",
  "remediationStateLastModifiedDateTime": "2017-01-01T00:00:10.730021-08:00",
  "userlessEnrollmentStatus": "allowed"
}