デバイス リソース型device resource type

組織に登録されているデバイスを表します。Represents a device registered in the organization. デバイスは、Device Registration Service を使用するか、Intune によってクラウドで作成されます。Devices are created in the cloud using the Device Registration Service or by Intune. これは、多要素認証の条件付きアクセス ポリシーで使用されます。They're used by conditional access policies for multi-factor authentication. 該当するデバイスの範囲は、デスクトップやノート PC から携帯電話やタブレットに及びます。These devices can range from desktop and laptop machines to phones and tablets. directoryObject から継承します。Inherits from directoryObject.

このリソースでは、拡張機能を使用してカスタム プロパティに独自のデータを追加することができます。This resource lets you add your own data to custom properties using extensions.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
デバイスを取得するGet device devicedevice デバイス オブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of a device object.
デバイスを一覧表示するList devices device コレクションdevice collection ディレクトリに登録されたデバイスの一覧を取得します。Retrieve a list of devices registered in the directory.
デバイスを更新するUpdate device devicedevice デバイス オブジェクトのプロパティを更新します。Update the properties of a device object.
デバイスを削除するDelete device なしNone デバイス オブジェクトを削除します。Delete a device object.
memberOf を一覧表示するList memberOf directoryObject collectiondirectoryObject collection デバイスが直接のメンバーであるグループを一覧表示します。List the groups that the device is a direct member of.
registeredOwners を一覧表示するList registeredOwners directoryObject collectiondirectoryObject collection registeredOwners ナビゲーション プロパティから、デバイスの登録済み所有者であるユーザーを取得します。Get the users that are registered owners of the device from the registeredOwners navigation property.
registeredUsers を一覧表示するList registeredUsers directoryObject コレクションdirectoryObject collection registeredUsers ナビゲーション プロパティから、デバイスの登録済みユーザーを取得します。Get the registered users of the device from the registeredUsers navigation property.
オープン拡張機能Open extensions
オープン拡張機能を作成するCreate open extension openTypeExtensionopenTypeExtension オープン拡張機能を作成し、新規または既存のリソースにカスタム プロパティを追加します。Create an open extension and add custom properties to a new or existing resource.
オープン拡張機能を取得するGet open extension openTypeExtension コレクションopenTypeExtension collection 拡張機能の名前で識別されるオープン拡張機能を取得します。Get an open extension identified by the extension name.
スキーマ拡張機能Schema extensions
スキーマ拡張機能の値を追加するAdd schema extension values スキーマ拡張機能の定義を作成し、それを使用してカスタマイズされた種類のデータをリソースに追加します。Create a schema extension definition and then use it to add custom typed data to a resource.

プロパティProperties

プロパティProperty Type 説明Description
accountEnabledaccountEnabled BooleanBoolean アカウントが有効な場合は true。それ以外の場合は false。必須。true if the account is enabled; otherwise, false. Required.
alternativeSecurityIdsalternativeSecurityIds alternativeSecurityId コレクションalternativeSecurityId collection 内部使用専用です。For internal use only. null 許容ではありません。Not nullable.
approximateLastSignInDateTimeapproximateLastSignInDateTime DateTimeOffsetDateTimeOffset Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z' 読み取り専用。For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' Read-only.
deviceIddeviceId stringstring 登録時に Azure の Device Registration Service により設定された一意の識別子。Unique identifier set by Azure Device Registration Service at the time of registration.
deviceMetadatadeviceMetadata StringString 内部使用専用です。For interal use only. Null に設定します。Set to null.
deviceVersiondeviceVersion Int32Int32 内部使用専用です。For interal use only.
displayNamedisplayName StringString デバイスの表示名。必須。The display name for the device. Required.
idid StringString デバイスの一意識別子。directoryObject から継承されます。キーであり、Null は許容されません。読み取り専用。The unique identifier for the device. Inherited from directoryObject. Key, Not nullable. Read-only.
isCompliantisCompliant BooleanBoolean デバイスがモバイル デバイス管理 (MDM) ポリシーに準拠している場合は true。それ以外の場合は falsetrue if the device complies with Mobile Device Management (MDM) policies; otherwise, false. 読み取り専用です。Read-only. これはのみ、Intune は、デバイスの OS の種類のか、 MDM アプリケーションを承認されたWindows OS のデバイスで更新できます。This can only be updated by Intune for any device OS type or by an approved MDM app for Windows OS devices.
isManagedisManaged BooleanBoolean デバイスがモバイル デバイス管理 (MDM) アプリで管理されている場合は true。それ以外の場合は falsetrue if the device is managed by a Mobile Device Management (MDM) app; otherwise, false. これはのみ、Intune は、デバイスの OS の種類のか、 MDM アプリケーションを承認されたWindows OS のデバイスで更新できます。This can only be updated by Intune for any device OS type or by an approved MDM app for Windows OS devices.
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset オブジェクトがオンプレミスのディレクトリと最後に同期された日時を示します。Timestamp 型は、ISO 8601 形式を使用して、常に UTC 時間での日付と時刻の情報を表します。The last time at which the object was synced with the on-premises directory.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z' 読み取り専用。For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' Read-only.
onPremisesSyncEnabledonPremisesSyncEnabled BooleanBoolean このオブジェクトがオンプレミスのディレクトリから同期される場合は true。このオブジェクトが最初にオンプレミスのディレクトリから同期されていて、今後は同期されない場合は false。このオブジェクトがオンプレミスのディレクトリから一度も同期されたことがない場合は null (既定値)。true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default). 読み取り専用です。Read-only.
operatingSystemoperatingSystem StringString デバイス上のオペレーティング システムの種類。必須。The type of operating system on the device. Required.
operatingSystemVersionoperatingSystemVersion 文字列String デバイス上のオペレーティング システムのバージョン。必須。The version of the operating system on the device. Required.
physicalIdsphysicalIds String collectionString collection 内部使用専用です。For interal use only. null 許容ではありません。Not nullable.
trustTypetrustType StringString 参加済みデバイスの信頼の種類。Type of trust for the joined device. 読み取り専用です。Read-only. 可能な値:Possible values:
ワークプレース - bring your own personal devices を示しますWorkplace - indicates bring your own personal devices
AzureAd - クラウド専用の参加済みデバイスAzureAd - Cloud only joined devices
ServerAd -Azure AD に参加済みのオンプレミスのドメイン参加済みデバイス。ServerAd - on-premises domain joined devices joined to Azure AD. 詳細については、「Azure Active Directory のデバイス管理の概要」を参照してくださいFor more details, see Introduction to device management in Azure Active Directory

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
extensionsextensions extension コレクションextension collection デバイスに対して定義されているオープン拡張機能のコレクション。読み取り専用です。Null 許容型。The collection of open extensions defined for the device. Read-only. Nullable.
memberOfmemberOf directoryObject collectiondirectoryObject collection このグループがメンバーとして含まれているグループ。HTTP メソッド:GET (すべてのグループでサポートされます)。読み取り専用です。Null 許容型。Groups that this group is a member of. HTTP Methods: GET (supported for all groups). Read-only. Nullable.
推移的な memberOf を一覧表示するList transitive memberOf directoryObject コレクションdirectoryObject collection メンバーであるデバイスのグループを一覧表示します。List the groups that the device is a member of. この操作は、推移的です。This operation is transitive.
registeredOwnersregisteredOwners directoryObject collectiondirectoryObject collection デバイスがクラウドに参加済みか、または個人用デバイスが登録済みのユーザー。The user that cloud joined the device or registered their personal device. 登録済み所有者は、登録時に設定されます。The registered owner is set at the time of registration. 現在、所有者は 1 人しかいることができません。Currently, there can be only one owner. 読み取り専用です。Read-only. Null 許容型。Nullable.
registeredUsersregisteredUsers directoryObject コレクションdirectoryObject collection デバイスの登録済みユーザーのコレクション。Collection of registered users of the device. クラウドに参加済みのデバイスと登録済みの個人用デバイスの場合、登録済みのユーザーは、登録時に登録済み所有者と同じ値に設定されます。For cloud joined devices and registered personal devices, registered users are set to the same value as registered owners at the time of registration. 読み取り専用です。Read-only. Null 許容型。Nullable.

JSON 表記JSON representation

以下は、リソースの JSON 表記ですHere is a JSON representation of the resource

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

関連項目See also