设备资源类型

命名空间：microsoft.graph

表示在组织中注册的设备。 可以在云中使用设备注册服务或 Intune 创建设备。 条件访问策略使用它们进行多重身份验证。 这些设备范围很广，从台式机、笔记本电脑到手机和平板电脑均包括在内。 继承自 directoryObject。

此资源是允许传入其他属性的开放类型。 还可以将自己的数据作为 扩展添加到自定义属性。

方法

方法	返回类型	说明
获取设备	设备	读取 device 对象的属性和关系。
列出设备	设备 集合	检索目录中的注册设备列表。
更新设备	设备	更新 device 对象的属性。
删除设备	无	删除 device 对象。
List memberOf	directoryObject collection	列出设备是其直接成员的组和管理单元。
List transitive memberOf	directoryObject 集合	列出设备所属的组和管理单元。 此操作是可传递的。
列出 registeredOwners	directoryObject 集合	通过 registeredOwners 导航属性，获取身份为设备注册所有者的用户。
列出 registeredUsers	directoryObject 集合	从 registeredUsers 导航属性获取设备的注册用户。
checkMemberObjects	String 集合	检查组、目录角色或管理单元对象列表中的成员身份。
getMemberObjects	String 集合	返回设备所属的所有组、管理单元和目录角色。 检查是可传递的。
开放扩展
创建开放扩展	openTypeExtension	创建开放扩展，并将自定义属性添加到新资源或现有资源。
获取开放扩展	openTypeExtension 集合	获取扩展名称标识的开放扩展。
架构扩展
添加架构扩展值		创建架构扩展定义，然后使用它向资源添加自定义键入数据。

属性

重要

仅当使用设置为 eventual 和 $count 的 ConsistencyLevel 标头时，才支持 $filter 和 $search 查询参数的特定用法。 有关详细信息，请参阅 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 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。 支持$filter (eq、ne、not、ge``le和eq值null) 和 $orderBy。
complianceExpirationDateTime	DateTimeOffset	设备不再被视为符合时的时间戳。 时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终采用 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。
deviceId	String	由 Azure 设备注册服务在设备注册时设置的唯一标识符。 支持 $filter （eq、 ne、 not、 startsWith）。
deviceMetadata	String	仅供内部使用。 设置为 null。
deviceVersion	Int32	仅供内部使用。
displayName	String	设备显示名称。 必需。 支持 $filter (eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq)、$search 和 $orderBy。
extensionAttributes	onPremisesExtensionAttributes	包含设备的扩展属性 1-15。 不能选择单个扩展属性。 这些属性在云中掌握，可以在 Azure AD 中创建或更新设备对象期间进行设置。 支持 $filter（eq、not、startsWith 和 null 值上的 eq）。
id	String	设备唯一标识符。 继承自 directoryObject。 密钥，不可为 NULL。 只读。 支持 $filter （eq、 ne、 not、 in）。
isCompliant	Boolean	true如果设备符合移动设备管理 (MDM) 策略，则为 ɭ;否则为 false。 只读。 这只能通过任何设备 OS 类型的Intune或 Windows OS 设备的已批准 MDM 应用进行更新。 支持 $filter（eq、ne、not）。
isManaged	Boolean	true如果设备由移动设备管理 (MDM) 应用管理，则为 ！;否则为 false。 这只能通过任何设备 OS 类型的Intune或 Windows OS 设备的已批准 MDM 应用进行更新。 支持 $filter（eq、ne、not）。
manufacturer	String	设备制造商。 只读。
mdmAppId	字符串	用于将设备注册到 MDM 的应用程序标识符。 只读。 支持 $filter （eq、 ne、 not、 startsWith）。
model	String	设备的模型。 只读。
onPremisesLastSyncDateTime	DateTimeOffset	上次将对象与本地目录同步的时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 是 2014-01-01T00:00:00Z 只读的。 支持 $filter （eq、 ne、 not、 ge、 le、 in）。
onPremisesSyncEnabled	Boolean	如果此对象从本地目录同步，则为 true；如果此对象最初从本地目录同步，但以后不再同步，则为 false；如果此对象从未从本地目录同步，则为 null（默认值）。 只读。 支持 $filter（eq、ne、not、in 和 null 值上的 eq）。
operatingSystem	String	设备上操作系统的类型。 必需。 支持$filter (eq、ne、not、ge``le和startsWith``eq值null) 。
operatingSystemVersion	String	设备上操作系统的版本。 必需。 支持$filter (eq、ne、not、ge``le和startsWith``eq值null) 。
physicalIds	String collection	仅供内部使用。 不可为 null。 支持$filter (eq、not、ge和le``startsWith计数空集合) 。
profileType	deviceProfileType	设备的配置文件类型。 可能的值： RegisteredDevice (默认) 、SecureVM、 Printer、 Shared``IoT
systemLabels	字符串集合	系统应用于设备的标签列表。 在) eq计算空集合时支持$filter (。
trustType	String	加入设备的信任类型。 只读。 可能的值： Workplace (指示 将自己的个人设备) ， AzureAd (仅加入云的设备) ， ServerAd (已加入 Azure AD) 的本地域设备。 如需了解更多详情，请参阅 Azure Active Directory 中的设备管理简介

关系

关系	类型	说明
extensions	扩展集合	为设备定义的开放扩展集合。只读。可为 NULL。
memberOf	directoryObject collection	此设备所属的组和管理单元。 只读。 可为 NULL。 支持 $expand。
transitiveMemberOf	directoryObject 集合	设备所属的组和管理单元。 此操作是可传递的。 支持 $expand。
registeredOwners	directoryObject 集合	云加入设备或已注册个人设备的用户。 已注册的所有者是在注册时设置。 目前，只能有一个所有者。 只读。 可为 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"
}

另请参阅

• 使用扩展向资源添加自定义数据
• 使用开放扩展向用户添加自定义数据
• 使用架构扩展向组添加自定义数据