deviceManagementAutopilotEvent の作成
名前空間: microsoft.graph
注: Intune 用 Microsoft Graph API には、テナントの 有効な Intune ライセンスが必要です。
新しい deviceManagementAutopilotEvent オブジェクトを作成 します。
前提条件
この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校アカウント) | DeviceManagementManagedDevices.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | DeviceManagementManagedDevices.ReadWrite.All |
HTTP 要求
POST /deviceManagement/autopilotEvents
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー <トークン> が必要です。 |
| 承諾 | application/json |
要求本文
要求本文で、deviceManagementAutopilotEvent オブジェクトの JSON 表記を指定します。
次の表に、deviceManagementAutopilotEvent を作成するときに必要なプロパティを示します。
| プロパティ | 型 | 説明 |
|---|---|---|
| id | String | オブジェクトの UUID |
| deviceId | String | オブジェクトに関連付けられたデバイス ID |
| eventDateTime | DateTimeOffset | インシデントが発生した時間。 |
| deviceRegisteredDateTime | DateTimeOffset | デバイスの登録日。 |
| enrollmentStartDateTime | DateTimeOffset | デバイス登録の開始日。 |
| enrollmentType | windowsAutopilotEnrollmentType | 登録の種類。 可能な値は、unknown、azureADJoinedWithAutopilotProfile、offlineDomainJoined、azureADJoinedUsingDeviceAuthWithAutopilotProfile、azureADJoinedUsingDeviceAuthWithoutAutopilotProfile、azureADJoinedWithOfflineAutopilotProfile、azureADJoinedWithWhiteGlove、offlineDomainJoinedWithWhiteGlove、offlineDomainJoinedWithOfflineAutopilotProfile です。 |
| deviceSerialNumber | String | デバイスのシリアル番号。 |
| managedDeviceName | String | 管理対象デバイス名。 |
| userPrincipalName | String | デバイスの登録に使用されるユーザー プリンシパル名。 |
| windowsAutopilotDeploymentProfileDisplayName | String | Autopilot プロファイル名。 |
| enrollmentState | enrollmentState | 登録状態 (登録、失敗) など。 使用可能な値: unknown、enrolled、pendingReset、failed、notContacted、blocked。 |
| windows10EnrollmentCompletionPageConfigurationDisplayName | String | 登録状態ページのプロファイル名 |
| windows10EnrollmentCompletionPageConfigurationId | String | 登録状態ページのプロファイル ID |
| deploymentState | windowsAutopilotDeploymentState | 成功、失敗、InProgress、SuccessWithTimeout のような展開状態。 可能な値は、unknown、success、inProgress、failure、successWithTimeout、notAttempted、disabled です。 |
| deviceSetupStatus | windowsAutopilotDeploymentState | 登録状態ページのデバイスセットアップ フェーズの展開状態。 可能な値は、unknown、success、inProgress、failure、successWithTimeout、notAttempted、disabled です。 |
| accountSetupStatus | windowsAutopilotDeploymentState | 登録状態ページアカウントのセットアップ フェーズの展開状態。 可能な値は、unknown、success、inProgress、failure、successWithTimeout、notAttempted、disabled です。 |
| osVersion | String | デバイス オペレーティング システムのバージョン。 |
| deploymentDuration | Duration | 登録を含む自動パイロット展開期間。 |
| deploymentTotalDuration | Duration | 登録からデスクトップ画面への展開の合計期間。 |
| devicePreparationDuration | Duration | デバイスの登録に費やされた時間。 |
| deviceSetupDuration | Duration | デバイス ESP で費やされた時間。 |
| accountSetupDuration | Duration | ユーザー ESP で費やされた時間。 |
| deploymentStartDateTime | DateTimeOffset | 展開の開始時刻。 |
| deploymentEndDateTime | DateTimeOffset | 展開の終了時刻。 |
| targetedAppCount | Int32 | 対象となるアプリケーションの数。 |
| targetedPolicyCount | Int32 | 対象となるポリシーの数。 |
| enrollmentFailureDetails | String | 登録エラーの詳細。 |
応答
成功した場合、このメソッドは応答コードと、応答本文の 201 Created deviceManagementAutopilotEvent オブジェクトを返します。
例
要求
以下は、要求の例です。
POST https://graph.microsoft.com/v1/deviceManagement/autopilotEvents
Content-type: application/json
Content-length: 1545
{
"@odata.type": "#microsoft.graph.deviceManagementAutopilotEvent",
"deviceId": "Device Id value",
"eventDateTime": "2016-12-31T23:59:23.3984029-08:00",
"deviceRegisteredDateTime": "2017-01-01T00:02:48.7185581-08:00",
"enrollmentStartDateTime": "2017-01-01T00:00:19.6280481-08:00",
"enrollmentType": "azureADJoinedWithAutopilotProfile",
"deviceSerialNumber": "Device Serial Number value",
"managedDeviceName": "Managed Device Name value",
"userPrincipalName": "User Principal Name value",
"windowsAutopilotDeploymentProfileDisplayName": "Windows Autopilot Deployment Profile Display Name value",
"enrollmentState": "enrolled",
"windows10EnrollmentCompletionPageConfigurationDisplayName": "Windows10Enrollment Completion Page Configuration Display Name value",
"windows10EnrollmentCompletionPageConfigurationId": "Windows10Enrollment Completion Page Configuration Id value",
"deploymentState": "success",
"deviceSetupStatus": "success",
"accountSetupStatus": "success",
"osVersion": "Os Version value",
"deploymentDuration": "PT3M21.5549443S",
"deploymentTotalDuration": "PT1M43.5284261S",
"devicePreparationDuration": "-PT1M32.1347897S",
"deviceSetupDuration": "-PT2M57.2190107S",
"accountSetupDuration": "-PT2M32.0507894S",
"deploymentStartDateTime": "2016-12-31T23:59:37.257201-08:00",
"deploymentEndDateTime": "2017-01-01T00:00:46.5128291-08:00",
"targetedAppCount": 0,
"targetedPolicyCount": 3,
"enrollmentFailureDetails": "Enrollment Failure Details value"
}
応答
以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1594
{
"@odata.type": "#microsoft.graph.deviceManagementAutopilotEvent",
"id": "3e455cab-5cab-3e45-ab5c-453eab5c453e",
"deviceId": "Device Id value",
"eventDateTime": "2016-12-31T23:59:23.3984029-08:00",
"deviceRegisteredDateTime": "2017-01-01T00:02:48.7185581-08:00",
"enrollmentStartDateTime": "2017-01-01T00:00:19.6280481-08:00",
"enrollmentType": "azureADJoinedWithAutopilotProfile",
"deviceSerialNumber": "Device Serial Number value",
"managedDeviceName": "Managed Device Name value",
"userPrincipalName": "User Principal Name value",
"windowsAutopilotDeploymentProfileDisplayName": "Windows Autopilot Deployment Profile Display Name value",
"enrollmentState": "enrolled",
"windows10EnrollmentCompletionPageConfigurationDisplayName": "Windows10Enrollment Completion Page Configuration Display Name value",
"windows10EnrollmentCompletionPageConfigurationId": "Windows10Enrollment Completion Page Configuration Id value",
"deploymentState": "success",
"deviceSetupStatus": "success",
"accountSetupStatus": "success",
"osVersion": "Os Version value",
"deploymentDuration": "PT3M21.5549443S",
"deploymentTotalDuration": "PT1M43.5284261S",
"devicePreparationDuration": "-PT1M32.1347897S",
"deviceSetupDuration": "-PT2M57.2190107S",
"accountSetupDuration": "-PT2M32.0507894S",
"deploymentStartDateTime": "2016-12-31T23:59:37.257201-08:00",
"deploymentEndDateTime": "2017-01-01T00:00:46.5128291-08:00",
"targetedAppCount": 0,
"targetedPolicyCount": 3,
"enrollmentFailureDetails": "Enrollment Failure Details value"
}
フィードバック
フィードバックの送信と表示