通过

设备资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

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

此资源是一种开放类型，它允许除此处所述的属性之外的其他属性。

该资源支持：

方法

方法 返回类型 Description
List 设备 集合 检索目录中的注册设备列表。
创建 设备 在目录中注册新设备。
Get 设备 读取设备对象的属性和关系。
更新 设备 更新设备对象的属性。
删除 无 删除设备对象。
获取增量 设备集合 获取设备的增量更改。
列出隶属于 directoryObject collection 列出设备是其直接成员的组和管理单元。
列出 的可传递成员 directoryObject collection 列出设备所属的组和管理单元。 此作是可传递的。
列出注册的所有者 directoryObject collection 通过 registeredOwners 导航属性，获取身份为设备注册所有者的用户。
添加已注册的所有者 directoryObject collection 添加设备的已注册所有者。
删除注册所有者 directoryObject collection 从设备中删除已注册的所有者。
列出注册的用户 directoryObject collection 从 registeredUsers 导航属性获取设备的注册用户。
添加已注册的用户 directoryObject collection 添加设备 的已注册用户。
删除已注册的用户 directoryObject collection 从设备 中删除已注册的用户。
列表使用权限 usageRight 集合 获取授予设备的使用权限的集合。
检查成员组 String collection 检查组列表中的成员身份。 检查是可传递的。
获取成员组 字符串集合 返回设备所属的所有组。 检查是可传递的。
检查成员对象 字符串集合 检查组、目录角色或管理单元对象列表中的成员身份。
获取成员对象 字符串集合 返回设备所属的所有组、管理单元和目录角色。 检查是可传递的。
开放扩展
创建开放扩展 openTypeExtension 创建开放扩展，并将自定义属性添加到新资源或现有资源。
获取开放扩展 openTypeExtension 集合 获取扩展名称标识的开放扩展。

注意： 对于架构扩展，可以创建一个定义，并使用它来向资源添加自定义类型化数据。 有关详细信息，请参阅 添加架构扩展值。

属性

重要

仅当使用设置为 eventual 和 $count 的 ConsistencyLevel 标头时，才支持 $filter 和 $search 查询参数的特定用法。 有关详细信息，请参阅 目录对象的高级查询功能。

属性 类型 说明
accountEnabled Boolean 启用帐户时为 true，否则为 false。 默认值为“true”。

支持 $filter （eq、 ne、 not、 in）。 只有至少具有云设备管理员角色的调用方才能设置此属性。
alternativeNames 字符串集合 设备的可选名称列表。
alternativeSecurityIds alternativeSecurityId 集合 仅供内部使用。 不可为 null。 支持 $filter（eq、not、ge、le）。
approximateLastSignInDateTime DateTimeOffset 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。 支持 $filter) geneleeqnot和 eq 值 (null 、 和 。$orderby
complianceExpirationDateTime DateTimeOffset 设备不再被视为合规时的时间戳。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。
deviceCategory String 由 Intune 设置的用户定义的属性，可自动将设备添加到组并简化设备的管理。
deviceId String 由 Azure 设备注册服务在设备注册时设置的唯一标识符。 此 ID 是可用于引用设备对象的备用键。 还支持 $filter (eq、 ne、 not、 startsWith) 。
deviceMetadata String 仅供内部使用。 设置为 null。
deviceOwnership String 设备的所有权。 Intune设置此属性。 可能的值包括 unknown、company、personal。
deviceVersion Int32 仅供内部使用。
displayName String 设备显示名称。 最大长度为 256 个字符。 必填。 支持 $filter（eq、ne、not、ge、le、in、startsWith 和 null 值上的 eq）、$search 和 $orderby。
domainName String Microsoft Entra混合联接设备的本地域名。 Intune设置此属性。
enrollmentProfileName String 应用于设备的注册配置文件。 例如，Apple Device Enrollment Profile、Device enrollment - Corporate device identifiers 或 Windows Autopilot profile name。 Intune设置此属性。
enrollmentType String 设备的注册类型。 Intune设置此属性。 可能的值为：unknown、、userEnrollmentdeviceEnrollmentManager、windowsAzureADJoinwindowsBulkUserlesswindowsBulkAzureDomainJoinappleBulkWithoutUserappleBulkWithUserwindowsAutoEnrollment、windowsCoManagement、、windowsAzureADJoinUsingDeviceAuth、 。 appleUserEnrollmentWithServiceAccountappleUserEnrollment

注意： 此属性可能会返回列出的值以外的其他值。
extensionAttributes onPremisesExtensionAttributes 包含设备的扩展属性 1-15。 单个扩展属性不可选择。 这些属性在云中主控，可以在 Microsoft Entra ID 中创建或更新设备对象期间设置。

支持 $filter（eq、not、startsWith 和 null 值上的 eq）。
hostnames 字符串集合 设备的主机名列表。
id String 设备唯一标识符。 继承自 directoryObject。 密钥，不可为 NULL。 只读。 支持 $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）。
isManagementRestricted 布尔值 指示设备是否是受限管理管理单元的成员。 如果未设置，则默认值为 null ，默认行为为 false。 只读。

若要管理属于受限管理管理单元成员的设备，必须在受限管理管理单元的范围内为管理员或调用应用分配Microsoft Entra角色。
isRooted 布尔值 true 如果设备已获取 root 权限或越狱，则为 。 此属性只能通过Intune进行更新。
kind String 设备的外形规格。 仅当用户使用 Microsoft 帐户作为 Project Rome 的一部分登录时返回。
managementType String 设备的管理通道。 Intune设置此属性。 可能的值为：eas、、mdm、、easMdm、configurationManagerClientMdmconfigurationManagerClientconfigurationManagerClientMdmEaseasIntuneClientintuneClient、、unknownjamf、、 。 googleCloudDevicePolicyController
manufacturer String 设备的制造商。 只读。
mdmAppId String 用于将设备注册到 MDM 的应用程序标识符。 只读。 支持 $filter （eq、 ne、 not、 startsWith）。
model String 设备的型号。 只读。
name String 设备的友好名称。 仅当用户在 Project Rome 中使用Microsoft帐户登录时才返回。
onPremisesLastSyncDateTime DateTimeOffset 对象上次与本地目录同步的时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z 只读。 支持 $filter （eq、 ne、 not、 ge、 le、 in）。
onPremisesSecurityIdentifier String 对于从本地同步到云的用户，本地安全标识符 (SID) 。 只读。 仅在 $select 上返回。 支持 $filter（eq）。
onPremisesSyncEnabled Boolean 如果此对象从本地目录同步，则为 true；如果此对象最初从本地目录同步，但以后不再同步，则为 false；如果此对象从未从本地目录同步，则为 null（默认值）。 只读。 支持 $filter（eq、ne、not、in 和 null 值上的 eq）。
operatingSystem String 设备上操作系统的类型。 必填。 支持$filter对值) (neeqnot、、ge、lestartsWith、 和 。eqnull
operatingSystemVersion String 设备的操作系统版本。 必填。 支持$filter对值) (neeqnot、、ge、lestartsWith、 和 。eqnull
physicalIds 字符串集合 仅供内部使用。 不可为 null。 支持 $filter (eq、、not、gele、startsWith/$count eq 0、 。 /$count ne 0
平台 String 设备平台。 仅当用户使用 Microsoft 帐户作为 Project Rome 的一部分登录时返回。
profileType String 设备的配置文件类型。 可能的值： RegisteredDevice (默认) 、SecureVM、Printer、SharedIoT。
registrationDateTime DateTimeOffset 注册设备的日期和时间。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。
status String 设备为 online 或 offline。 仅当用户在 Project Rome 中使用Microsoft帐户登录时才返回。
systemLabels 字符串集合 系统应用于设备的标签列表。 支持 $filter（/$count eq 0、/$count ne 0）。
trustType String 加入设备的信任类型。 只读。 可能的值： Workplace (指示将自己的个人设备) ， AzureAd (仅限云加入的设备) ， ServerAd (已加入本地域的设备加入Microsoft Entra ID) 。 有关详细信息，请参阅 Microsoft Entra ID 中的设备管理简介。 支持 $filter （eq、 ne、 not、 in）。

关系

关系 类型 说明
命令 命令 集合 发送到此设备的命令集。
deviceTemplate deviceTemplate 集合 用于实例化此设备的设备模板。 可为 Null。 只读。
extensions 扩展集合 为设备定义的开放扩展的集合。 只读。 可为 NULL。
memberOf directoryObject collection 此设备所属的组和管理单元。 只读。 可为 NULL。 支持 $expand。
registeredOwners directoryObject 集合 云加入设备或已注册个人设备的用户。 已注册的所有者是在注册时设置。 只读。 可为 NULL。 支持 $expand。
registeredUsers directoryObject 集合 设备的已注册用户集合。 对于云加入设备和已注册的个人设备，已注册用户在设备注册时设置为与已注册所有者相同的值。 只读。 可为 NULL。 支持 $expand。
transitiveMemberOf directoryObject 集合 此设备所属的组和管理单元。 此作是可传递的。 支持 $expand。
usageRights usageRight 集合 表示已授予设备的使用权限。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "accountEnabled": "Boolean",
  "alternativeNames": ["String"],
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceCategory": "String",
  "deviceId": "String",
  "deviceMetadata": "String",
  "deviceOwnership": "String",
  "deviceVersion": "Int32",
  "displayName": "String",
  "domainName": "String",
  "enrollmentProfileName": "String",
  "enrollmentType": "String",
  "extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "hostnames" : ["String"],
  "id": "String (identifier)",
  "isCompliant": "Boolean",
  "isManaged": "Boolean",
  "isManagementRestricted": "Boolean",
  "isRooted": "Boolean",
  "kind": "String",
  "managementType": "String",
  "manufacturer": "String",
  "mdmAppId": "String",
  "model": "String",
  "name": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": "Boolean",
  "operatingSystem": "String",
  "operatingSystemVersion": "String",
  "physicalIds": ["String"],
  "platform": "String",
  "profileType": "String",
  "registrationDateTime": "String (timestamp)",
  "status": "String",
  "systemLabels": ["String"],
  "trustType": "String"
}

相关内容

  • Last updated on