デバイス リソース型

名前空間: microsoft.graph

組織に登録されているデバイスを表します。 デバイスは、Device Registration Service を使用するか、Intune によってクラウドで作成されます。 これは、多要素認証の条件付きアクセス ポリシーで使用されます。 該当するデバイスの範囲は、デスクトップやノート PC から携帯電話やタブレットに及びます。 directoryObject から継承します。

このリソースは、他のプロパティを渡すことができるオープン型です。 独自のデータを 拡張機能としてカスタム プロパティに追加することもできます。

メソッド

メソッド	戻り値の型	説明
デバイスを取得する	device	デバイス オブジェクトのプロパティとリレーションシップを読み取ります。
デバイスを一覧表示する	device コレクション	ディレクトリに登録されたデバイスの一覧を取得します。
デバイスを更新する	device	デバイス オブジェクトのプロパティを更新します。
デバイスを削除する	なし	デバイス オブジェクトを削除します。
memberOf を一覧表示する	directoryObject collection	デバイスが直接メンバーであるグループと管理単位を一覧表示します。
推移的な memberOf を一覧表示する	directoryObject コレクション	デバイスがメンバーになっているグループと管理単位を一覧表示します。 この操作は推移的です。
registeredOwners を一覧表示する	directoryObject コレクション	registeredOwners ナビゲーション プロパティから、デバイスの登録済み所有者であるユーザーを取得します。
registeredUsers を一覧表示する	directoryObject コレクション	registeredUsers ナビゲーション プロパティから、デバイスの登録済みユーザーを取得します。
checkMemberObjects	String collection	グループ、ディレクトリ ロール、または管理単位オブジェクトの一覧でメンバーシップを確認します。
getMemberObjects	String collection	デバイスがメンバーであるすべてのグループ、管理単位、ディレクトリ ロールを返します。 チェックは推移的です。
オープン拡張機能
オープン拡張機能を作成する	openTypeExtension	オープン拡張機能を作成し、新規または既存のリソースにカスタム プロパティを追加します。
オープン拡張機能を取得する	openTypeExtension コレクション	拡張機能の名前で識別されるオープン拡張機能を取得します。
スキーマ拡張機能
スキーマ拡張機能の値を追加する		スキーマ拡張機能の定義を作成し、それを使用してカスタマイズされた種類のデータをリソースに追加します。

プロパティ

重要

$filter および $search クエリ パラメーターの具体的な使用方法は、ConsistencyLevel ヘッダーの設定を eventual と $count に使用する場合にのみサポートされます。 詳細については、「Azure AD ディレクトリ オブジェクトの詳細クエリ機能」を参照してください。

プロパティ	型	説明
accountEnabled	Boolean	アカウントが有効な場合は true であり、それ以外の場合は false です。 必須です。 既定値は true です。 $filter (eq、ne、not、in) をサポートします。 このプロパティを設定できるのは、グローバル管理者ロールとクラウド デバイス管理者ロールの呼び出し元のみです。
alternativeSecurityIds	alternativeSecurityId コレクション	内部使用専用です。 null 許容ではありません。 $filter (eq、not、ge、le) をサポートします。
approximateLastSignInDateTime	DateTimeOffset	タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時刻です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 読み取り専用です。 ($filter値、値not``ge``le、neおよびオンnull) $orderByと eq .eq
complianceExpirationDateTime	DateTimeOffset	デバイスが準拠していないと見なされた場合のタイムスタンプ。 タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時刻です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 読み取り専用です。
deviceId	String	登録時に Azure の Device Registration Service により設定された一意の識別子。 $filter (eq、ne、not、startsWith) をサポートします。
deviceMetadata	String	内部使用のために用意されています。 null に設定します。
deviceVersion	Int32	内部使用のみ。
displayName	String	デバイスの表示名。 必須。 $filter (eq、ne、not、ge、le、in、startsWith、および eq の null値)、$search、および $orderBy をサポートします。
extensionAttributes	onPremisesExtensionAttributes	デバイスの拡張属性 1 ~ 15 が含まれます。 個々の拡張属性は選択できません。 これらのプロパティはクラウドでマスターされ、Azure AD でのデバイス オブジェクトの作成または更新中に設定できます。 $filter (eq、not、startsWith、および eq の null 値) をサポートします。
id	String	デバイスの一意の識別子。 directoryObject から継承されます。 Key,Not nullable. 読み取り専用です。 $filter (eq、ne、not、in) をサポートします。
isCompliant	ブール値	trueデバイスがモバイル デバイス管理 (MDM) ポリシーに準拠している場合は 。それ以外の場合は . false 読み取り専用です。 これは、任意のデバイス OS の種類のIntuneまたは Windows OS デバイス用の承認済みの MDM アプリによってのみ更新できます。 $filter (eq、ne、not) をサポートしています。
isManaged	ブール値	trueデバイスがモバイル デバイス管理 (MDM) アプリによって管理されている場合は 。それ以外の場合は . false これは、任意のデバイス OS の種類のIntuneまたは Windows OS デバイス用の承認済みの MDM アプリによってのみ更新できます。 $filter (eq、ne、not) をサポートしています。
manufacturer	String	デバイスの製造元。 読み取り専用です。
mdmAppId	String	MDM にデバイスを登録するために使用されるアプリケーション識別子。 読み取り専用です。 $filter (eq、ne、not、startsWith) をサポートします。
model	String	デバイスのモデル。 読み取り専用。
onPremisesLastSyncDateTime	DateTimeOffset	オブジェクトがオンプレミス ディレクトリと最後に同期された時刻。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日の午前 0 時の UTC は読み取り専用です 2014-01-01T00:00:00Z 。 $filter (eq、ne、not、ge、le、in) をサポートします。
onPremisesSyncEnabled	Boolean	このオブジェクトがオンプレミスのディレクトリから同期される場合は true、このオブジェクトが最初にオンプレミスのディレクトリから同期されていて、今後は同期しない場合は false、このオブジェクトがオンプレミスのディレクトリから 1 度も同期されたことがない場合は null (既定値)。 読み取り専用です。 $filter (eq、 ne、 not、 in、 および eq の null 値) をサポートします。
operatingSystem	String	デバイス上のオペレーティング システムの種類。 必須。 (eq、ne、le``not``startsWith``geおよび eq on null の値) をサポート$filterします。
operatingSystemVersion	String	デバイス上のオペレーティング システムのバージョン。 必須。 (eq、ne、le``not``startsWith``geおよび eq on null の値) をサポート$filterします。
physicalIds	String collection	内部使用専用です。 null 許容ではありません。 空のコレクション (eq、le``not``ge``startsWithおよびカウント) をサポート$filterします。
profileType	deviceProfileType	デバイスのプロファイルの種類。 使用可能な値: RegisteredDevice (既定値)SecureVM、Printer、. Shared``IoT
systemLabels	String コレクション	システムによってデバイスに適用されるラベルの一覧。 サポート $filter (eq 空のコレクションをカウントする場合)。
trustType	String	参加済みデバイスの信頼の種類。 読み取り専用です。 使用可能な値: Workplace ( 自分の個人用デバイスを持ち込む)、 AzureAd (クラウドに参加しているデバイスのみ)、 ServerAd (Azure AD に参加しているオンプレミス ドメイン参加済みデバイス) 詳細については、「Azure Active Directory のデバイス管理の概要」を参照してください

リレーションシップ

リレーションシップ	型	説明
extensions	extension コレクション	デバイスに対して定義されているオープン拡張機能のコレクション。読み取り専用です。Null 許容型。
memberOf	directoryObject collection	このデバイスがメンバーであるグループと管理単位。 読み取り専用です。 Null 許容型。 $expand をサポートします。
transitiveMemberOf	directoryObject collection	デバイスがメンバーであるグループと管理単位。 この操作は推移的です。 $expand をサポートします。
registeredOwners	directoryObject コレクション	デバイスがクラウドに参加済みか、または個人用デバイスが登録済みのユーザー。 登録済み所有者は、登録時に設定されます。 現在、所有者は 1 人しかいることができません。 読み取り専用です。 Null 許容型。 $expand をサポートします。
registeredUsers	directoryObject コレクション	デバイスの登録済みユーザーのコレクション。 クラウドに参加済みのデバイスと登録済みの個人用デバイスの場合、登録済みのユーザーは、登録時に登録済み所有者と同じ値に設定されます。 読み取り専用です。 Null 許容型。 $expand をサポートします。

JSON 表記

以下は、リソースの JSON 表記です

{
  "accountEnabled": true,
  "alternativeSecurityIds": [{"@odata.type": "microsoft.graph.alternativeSecurityId"}],
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceId": "string",
  "deviceMetadata": "string",
  "deviceVersion": 1024,
  "displayName": "string",
  "extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "id": "string (identifier)",
  "isCompliant": true,
  "isManaged": true,
  "manufacturer": "string",
  "mdmAppId": "string",
  "model": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSyncEnabled": true,
  "operatingSystem": "string",
  "operatingSystemVersion": "string",
  "physicalIds": ["string"],
  "profileType": "string",
  "systemLabels": ["string"],
  "trustType": "string"
}

関連項目

• 拡張機能を使用してカスタム データをリソースに追加する
• オープン拡張機能を使用してカスタム データをユーザーに追加する
• スキーマ拡張機能を使用したグループへのカスタム データの追加