设备资源类型device resource type

表示在组织中注册的设备。Represents a device registered in the organization. 可以在云中使用设备注册服务或 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. 这些设备范围很广,从台式机、笔记本电脑到手机和平板电脑均包括在内。These devices can range from desktop and laptop machines to phones and tablets. 继承自 directoryObjectInherits from directoryObject.

使用此资源,可以使用扩展将自己的数据添加到自定义属性。This resource lets you add your own data to custom properties using extensions.

方法Methods

方法Method 返回类型Return Type 说明Description
获取设备Get device 设备device 读取 device 对象的属性和关系。Read properties and relationships of a device object.
列出设备List devices 设备 集合device collection 检索目录中的注册设备列表。Retrieve a list of devices registered in the directory.
更新设备Update device 设备device 更新 device 对象的属性。Update the properties of a device object.
删除设备Delete device None 删除 device 对象。Delete a device object.
List memberOfList memberOf directoryObject 集合directoryObject collection 列出设备位于直接成员的组。List the groups that the device is a direct member of.
列出 registeredOwnersList registeredOwners directoryObject 集合directoryObject collection 通过 registeredOwners 导航属性,获取身份为设备注册所有者的用户。Get the users that are registered owners of the device from the registeredOwners navigation property.
列出 registeredUsersList 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 布尔Boolean 启用帐户时为 true,否则为 false。必需。true if the account is enabled; otherwise, false. Required.
alternativeSecurityIdsalternativeSecurityIds alternativeSecurityId 集合alternativeSecurityId collection 仅供内部使用。For internal use only. 不可为 null。Not nullable.
approximateLastSignInDateTimeapproximateLastSignInDateTime DateTimeOffsetDateTimeOffset 时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终采用 UTC 时区。The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. 例如,2014 年 1 月 1 日午夜 (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 设备注册服务在设备注册时设置的唯一标识符。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 的任何设备操作系统类型或批准 MDM 应用程序的 Windows 操作系统设备更新。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 的任何设备操作系统类型或批准 MDM 应用程序的 Windows 操作系统设备更新。This can only be updated by Intune for any device OS type or by an approved MDM app for Windows OS devices.
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset 对象最后一次与本地目录同步的时间。时间戳类型表示使用 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 日午夜 (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 StringString 设备上操作系统的版本。必需。The version of the operating system on the device. Required.
physicalIdsphysicalIds String 集合String collection 仅供内部使用。For interal use only. 不可为 null。Not nullable.
trustTypetrustType StringString 加入设备的信任类型。Type of trust for the joined device. 只读。Read-only. 可取值为:Possible values:
Workplace - 表示自带个人设备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 collection 为设备定义的开放扩展集合。只读。可为 NULL。The collection of open extensions defined for the device. Read-only. Nullable.
memberOfmemberOf directoryObject 集合directoryObject collection 此组所属的组。HTTP 方法:GET(支持所有组)只读。可为 Null。Groups that this group is a member of. HTTP Methods: GET (supported for all groups). Read-only. Nullable.
registeredOwnersregisteredOwners directoryObject 集合directoryObject collection 云加入设备或已注册个人设备的用户。The user that cloud joined the device or registered their personal device. 已注册的所有者是在注册时设置。The registered owner is set at the time of registration. 目前,只能有一个所有者。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