deviceManagementAutopilotEvent を更新する

名前空間: microsoft.graph

大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。

注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

deviceManagementAutopilotEvent オブジェクトのプロパティを更新します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	✅	✅	✅

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All

HTTP 要求

PATCH /deviceManagement/autopilotEvents/{deviceManagementAutopilotEventId}

要求ヘッダー

ヘッダー	値
Authorization	ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
承諾	application/json

要求本文

要求本文で、 deviceManagementAutopilotEvent オブジェクトの JSON 表現を指定します。

次の表は、 deviceManagementAutopilotEvent を作成するときに必要なプロパティを示しています。

プロパティ	型	説明
id	String	オブジェクトの UUID
deviceId	String	オブジェクトに関連付けられているデバイス ID
userId	String	オブジェクトに関連付けられている UserId 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	期間	登録からデスクトップへのデプロイ期間の合計画面。
deviceSetupDuration	期間	デバイス ESP に費やされた時間。
accountSetupDuration	期間	ユーザー ESP に費やされた時間。
deploymentStartDateTime	DateTimeOffset	デプロイの開始時刻。
deploymentEndDateTime	DateTimeOffset	デプロイの終了時刻。
enrollmentFailureDetails	String	登録エラーの詳細。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で更新された deviceManagementAutopilotEvent オブジェクトを返します。

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/beta/deviceManagement/autopilotEvents/{deviceManagementAutopilotEventId}
Content-type: application/json
Content-length: 1468

{
  "@odata.type": "#microsoft.graph.deviceManagementAutopilotEvent",
  "deviceId": "Device Id value",
  "userId": "User 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",
  "deviceSetupDuration": "-PT2M57.2190107S",
  "accountSetupDuration": "-PT2M32.0507894S",
  "deploymentStartDateTime": "2016-12-31T23:59:37.257201-08:00",
  "deploymentEndDateTime": "2017-01-01T00:00:46.5128291-08:00",
  "enrollmentFailureDetails": "Enrollment Failure Details value"
}

応答

以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1517

{
  "@odata.type": "#microsoft.graph.deviceManagementAutopilotEvent",
  "id": "3e455cab-5cab-3e45-ab5c-453eab5c453e",
  "deviceId": "Device Id value",
  "userId": "User 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",
  "deviceSetupDuration": "-PT2M57.2190107S",
  "accountSetupDuration": "-PT2M32.0507894S",
  "deploymentStartDateTime": "2016-12-31T23:59:37.257201-08:00",
  "deploymentEndDateTime": "2017-01-01T00:00:46.5128291-08:00",
  "enrollmentFailureDetails": "Enrollment Failure Details value"
}