deviceManagementScriptDeviceState を更新する
名前空間: microsoft.graph
大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
deviceManagementScriptDeviceState オブジェクトのプロパティを更新します。
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All |
HTTP 要求
PATCH /deviceManagement/deviceShellScripts/{deviceShellScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}
PATCH /deviceManagement/deviceCustomAttributeShellScripts/{deviceCustomAttributeShellScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/userRunStates/{deviceManagementScriptUserStateId}/deviceRunStates/{deviceManagementScriptDeviceStateId}
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| 承認 | ベアラー <トークン> が必要です。 |
| 承諾 | application/json |
要求本文
要求本文で、 deviceManagementScriptDeviceState オブジェクトの JSON 表現を指定します。
次の表は、 deviceManagementScriptDeviceState を作成するときに必要なプロパティを示しています。
| プロパティ | 型 | 説明 |
|---|---|---|
| id | 文字列 | デバイス管理スクリプトデバイス状態エンティティのキー。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| runState | runState | デバイス管理スクリプトの最新の実行の状態。 使用可能な値: unknown、success、fail、scriptError、pending、notApplicable。 |
| resultMessage | 文字列 | 実行出力の詳細。 |
| lastStateUpdateDateTime | DateTimeOffset | デバイス管理スクリプトが実行される最新時刻。 |
| errorCode | Int32 | デバイス管理スクリプトの誤った実行に対応するエラー コード。 |
| errorDescription | 文字列 | デバイス管理スクリプトの誤った実行に対応するエラーの説明。 |
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文で更新された deviceManagementScriptDeviceState オブジェクトを返します。
例
要求
以下は、要求の例です。
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceShellScripts/{deviceShellScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}
Content-type: application/json
Content-length: 281
{
"@odata.type": "#microsoft.graph.deviceManagementScriptDeviceState",
"runState": "success",
"resultMessage": "Result Message value",
"lastStateUpdateDateTime": "2017-01-01T00:02:58.4418045-08:00",
"errorCode": 9,
"errorDescription": "Error Description value"
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 330
{
"@odata.type": "#microsoft.graph.deviceManagementScriptDeviceState",
"id": "39440cba-0cba-3944-ba0c-4439ba0c4439",
"runState": "success",
"resultMessage": "Result Message value",
"lastStateUpdateDateTime": "2017-01-01T00:02:58.4418045-08:00",
"errorCode": 9,
"errorDescription": "Error Description value"
}