windowsAutopilotDeviceIdentity の作成
名前空間: microsoft.graph
大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
新しい windowsAutopilotDeviceIdentity オブジェクトを 作成します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この 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 デバイスの発注書識別子。 |
| シリアル番号 | String | Windows オートパイロット デバイスのシリアル番号。 |
| productKey | String | Windows オートパイロット デバイスのプロダクト キー。 |
| manufacturer | String | Windows autopilot デバイスの Oem 製造元。 |
| model | String | Windows autopilot デバイスのモデル名。 |
| enrollmentState | enrollmentState | windows autopilot デバイスの登録状態をIntuneします。 使用可能な値: 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"
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示