デバイス リソース型

名前空間: microsoft.graph

重要

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

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

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

メソッド

メソッド	戻り値の型	説明
デバイスを取得する	device	デバイス オブジェクトのプロパティとリレーションシップを読み取ります。
デバイスを一覧表示する	device コレクション	ディレクトリに登録されたデバイスの一覧を取得します。
デバイスを更新する	device	デバイス オブジェクトのプロパティを更新します。
デバイスを削除する	なし	デバイス オブジェクトを削除します。
memberOf を一覧表示する	directoryObject collection	デバイスが直接メンバーであるグループと管理単位を一覧表示します。
推移的な memberOf を一覧表示する	directoryObject コレクション	デバイスがメンバーになっているグループと管理単位を一覧表示します。 この操作は推移的です。
registeredOwners を一覧表示する	directoryObject コレクション	registeredOwners ナビゲーション プロパティから、デバイスの登録済み所有者であるユーザーを取得します。
registeredUsers を一覧表示する	directoryObject コレクション	registeredUsers ナビゲーション プロパティから、デバイスの登録済みユーザーを取得します。
usageRights を一覧表示する	usageRight コレクション	デバイスに付与された使用権限のコレクションを取得します。
checkMemberGroups	String collection	グループの一覧内のメンバーシップを確認します。チェックは推移的です。
getMemberGroups	String collection	デバイスがメンバーになっているすべてのグループを返します。 チェックは推移的です。
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 です。 読み取り専用です。
deviceCategory	String	デバイスをグループに自動的に追加し、デバイスの管理を簡略化するためにIntuneによって設定されたユーザー定義プロパティ。
deviceId	String	登録時に Azure Device Registration Service によって設定された識別子。 $filter (eq、ne、not、startsWith) をサポートします。
deviceMetadata	String	内部使用のために用意されています。 null に設定します。
deviceOwnership	String	デバイスの所有権。 このプロパティは、Intuneによって設定されます。 可能な値は unknown、company、personal です。
deviceVersion	Int32	内部使用のみ。
displayName	String	デバイスの表示名。 必須。 $filter (eq、ne、not、ge、le、in、startsWith、および eq の null値)、$search、および $orderBy をサポートします。
domainName	String	Hybrid Azure AD 参加済みデバイスのオンプレミス ドメイン名。 このプロパティは、Intuneによって設定されます。
enrollmentProfileName	String	デバイスに適用される登録プロファイル。 たとえば、、、Apple Device Enrollment Profile``Device enrollment - Corporate device identifiers、または Windows Autopilot profile name. このプロパティは、Intuneによって設定されます。
enrollmentType	String	デバイスの登録の種類。 このプロパティは、Intuneによって設定されます。 可能な値は、unknown、userEnrollment、deviceEnrollmentManager、appleBulkWithUser、appleBulkWithoutUser、windowsAzureADJoin、windowsBulkUserless、windowsAutoEnrollment、windowsBulkAzureDomainJoin、windowsCoManagement です。
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) をサポートしています。
isRooted	Boolean	true デバイスがルート化されている場合。 false デバイスが脱獄されている場合。 これは、Intuneによってのみ更新できます。
managementType	String	デバイスの管理チャネル。 このプロパティは、Intuneによって設定されます。 使用可能な値は、eas、mdm、easMdm、intuneClient、easIntuneClient、configurationManagerClient、configurationManagerClientMdm、configurationManagerClientMdmEas、unknown、jamf、googleCloudDevicePolicyController です。
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	String	デバイスのプロファイルの種類。 使用可能な値: RegisteredDevice (既定値)SecureVM、Printer、. Shared``IoT
registrationDateTime	DateTimeOffset	デバイスが登録された日時。 タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時刻です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 読み取り専用です。
systemLabels	String コレクション	システムによってデバイスに適用されるラベルの一覧。 サポート $filter (eq 空のコレクションをカウントする場合)。
ホスト	String collection	デバイスの hostNames の一覧。
trustType	String	参加済みデバイスの信頼の種類。 読み取り専用です。 使用可能な値: Workplace ( 自分の個人用デバイスを持ち込む)、 AzureAd (クラウドに参加しているデバイスのみ)、 ServerAd (Azure AD に参加しているオンプレミス ドメイン参加済みデバイス) 詳細については、「Azure Active Directory のデバイス管理の概要」を参照してください
name	String	デバイスのフレンドリ名。 ユーザーが Project Rome の一部として Microsoft アカウントでサインインした場合にのみ返されます。
status	String	デバイスは 、 online または offline. ユーザーが Project Rome の一部として Microsoft アカウントでサインインした場合にのみ返されます。
platform	String	デバイスのプラットフォーム。 ユーザーが Project Rome の一部として Microsoft アカウントでサインインした場合にのみ返されます。 ユーザーが Project Rome の一部として Microsoft アカウントでサインインした場合にのみ返されます。
kind	String	デバイスのフォーム ファクター。 ユーザーが Project Rome の一部として Microsoft アカウントでサインインした場合にのみ返されます。
model	String	デバイスのモデル。 ユーザーが Project Rome の一部として Microsoft アカウントでサインインした場合にのみ返されます。
manufacturer	String	デバイスの製造元。 ユーザーが Project Rome の一部として Microsoft アカウントでサインインした場合にのみ返されます。

リレーションシップ

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

JSON 表記

リソースの JSON 表記を次に示します。

{
  "accountEnabled": true,
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceCategory": "string",
  "deviceId": "string",
  "deviceMetadata": "string",
  "deviceOwnership": "string",
  "deviceVersion": 1024,
  "displayName": "string",
  "domainName": "string",
  "enrollmentProfileName": "string",
  "enrollmentType": "string",
  "extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "id": "string (identifier)",
  "isCompliant": true,
  "isManaged": true,
  "isRooted": true,
  "mdmAppId": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSyncEnabled": true,
  "operatingSystem": "string",
  "operatingSystemVersion": "string",
  "physicalIds": ["string"],
  "profileType": "string",
  "registrationDateTime": "String (timestamp)",
  "systemLabels": ["string"],
  "hostNames" : ["string"],
  "trustType": "string",
  "Name": "string",
  "Status": "string",
  "Platform": "string",
  "Kind": "string",
  "Model": "string",
  "managementType": "string",
  "Manufacturer": "string"
}

関連項目

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