デバイスを更新する

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

デバイスのプロパティを更新する。 承認済みのモバイル デバイス管理 (MDM) アプリを使用して更新できるのは、デバイスの特定のプロパティのみです。

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

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

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) Directory.AccessAsUser.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Device.ReadWrite.All Directory.ReadWrite.All

アプリケーションのみのシナリオと Windows 以外のデバイスの場合、 つまり operatingSystem プロパティが Windowsされていない場合、アプリが更新できるのは extensionAttributes プロパティのみです。

重要

職場または学校アカウントを使用する委任されたシナリオでは、サインインしたユーザーには、サポートされている Microsoft Entra ロール、またはサポートされているロールのアクセス許可を持つカスタム ロールが割り当てられる必要があります。 Intune 管理者は、この操作でサポートされる最小特権ロールです。 クラウド デバイス管理者ロールの呼び出し元ユーザーはデバイスのみを有効または無効にでき、Windows 365 管理者ロールを持つユーザーは基本的なデバイス プロパティのみを更新できます。

HTTP 要求

ID またはdeviceId を使用してデバイスのアドレスを指定できます。

PATCH /devices/{id}
PATCH /devices(deviceId='{deviceId}')

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。

要求本文

要求本文で、更新するデバイス プロパティの値を指定します。 要求本文に含まれない既存のプロパティは、以前の値のままになるか、他のプロパティ値の変化に基づいて再計算されます。 最適なパフォーマンスを得るためには、変更されていない既存の値を含めないでください。

プロパティ 説明
accountEnabled Boolean アカウントが有効な場合は true であり、それ以外の場合は false です。 このプロパティを更新できるのは、 少なくともクラウド デバイス管理者 ロールを持つ呼び出し元のみです。
alternativeNames String コレクション デバイスの代替名の一覧 (例: resourceIds)。
displayName String デバイスの表示名。
isCompliant ブール型 trueデバイスがモバイル デバイス管理 (MDM) ポリシーに準拠している場合。それ以外の場合はfalse。 これは、任意のデバイスの OS の種類の Intune、または Windows OS デバイス用の承認された MDM アプリによってのみ更新できます。
isManaged ブール型 trueデバイスがモバイル デバイス管理 (MDM) アプリによって管理されている場合は、それ以外の場合はfalse。 これは、任意のデバイスの OS の種類の Intune、または Windows OS デバイス用の承認された MDM アプリによってのみ更新できます。
operatingSystem String デバイス上のオペレーティング システムの種類。
operatingSystemVersion String デバイス上のオペレーティング システムのバージョン。

デバイス リソースは拡張機能をサポートしているため、PATCH操作を使用して、既存のデバイス インスタンスの拡張機能のカスタム プロパティで独自のアプリ固有のデータを追加、更新、または削除できます。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。

例 1: デバイスの accountEnabled プロパティを更新する

要求

PATCH https://graph.microsoft.com/beta/devices/7c06cd31-7c30-4f3b-a5c3-444cd8dd63ac
Content-type: application/json

{
  "accountEnabled": false
}

応答

HTTP/1.1 204 No Content

例 2: デバイスに extensionAttributes を記述する

要求

PATCH https://graph.microsoft.com/beta/devices/7c06cd31-7c30-4f3b-a5c3-444cd8dd63ac
Content-type: application/json

{
    "extensionAttributes": {
        "extensionAttribute1": "BYOD-Device"
    }
}

応答

HTTP/1.1 204 No Content