deviceManagementAutopilotEvent を作成する
名前空間: microsoft.graph
大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
新しい deviceManagementAutopilotEvent オブジェクトを作成します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | DeviceManagementManagedDevices.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | DeviceManagementManagedDevices.ReadWrite.All |
HTTP 要求
POST /deviceManagement/autopilotEvents
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
| 承諾 | 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 | Success、Failure、InProgress、SuccessWithTimeout などのデプロイ状態。 可能な値は、unknown、success、inProgress、failure、successWithTimeout、notAttempted、disabled、successOnRetry です。 |
| deviceSetupStatus | windowsAutopilotDeploymentState | 登録状態ページのデバイス セットアップ フェーズの展開状態。 可能な値は、unknown、success、inProgress、failure、successWithTimeout、notAttempted、disabled、successOnRetry です。 |
| accountSetupStatus | windowsAutopilotDeploymentState | 登録状態ページのアカウント設定フェーズの展開状態。 可能な値は、unknown、success、inProgress、failure、successWithTimeout、notAttempted、disabled、successOnRetry です。 |
| osVersion | String | デバイス オペレーティング システムのバージョン。 |
| deploymentDuration | 期間 | 登録を含む Autopilot デプロイ期間。 |
| deploymentTotalDuration | 期間 | 登録からデスクトップへのデプロイ期間の合計画面。 |
| devicePreparationDuration | 期間 | デバイス登録に費やされた時間。 |
| deviceSetupDuration | 期間 | デバイス ESP に費やされた時間。 |
| accountSetupDuration | 期間 | ユーザー ESP に費やされた時間。 |
| deploymentStartDateTime | DateTimeOffset | デプロイの開始時刻。 |
| deploymentEndDateTime | DateTimeOffset | デプロイの終了時刻。 |
| targetedAppCount | Int32 | 対象となるアプリケーションの数。 |
| targetedPolicyCount | Int32 | 対象となるポリシーの数。 |
| enrollmentFailureDetails | String | 登録エラーの詳細。 |
応答
成功した場合、このメソッドは 201 Created 応答コードと、応答本文の deviceManagementAutopilotEvent オブジェクトを返します。
例
要求
以下は、要求の例です。
POST https://graph.microsoft.com/beta/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"
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示