设备资源类型

命名空间:microsoft.graph

重要

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

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

此资源是一种开放类型,允许除了此处记录的属性之外的其他属性。

该资源支持:

方法

方法 返回类型 Description
List 设备 集合 检索目录中的注册设备列表。
创建 设备 在目录中注册新设备。
Get 设备 读取设备对象的属性和关系。
更新 设备 更新设备对象的属性。
删除 无 删除设备对象。
预配 provisionResponse 代表已批准的虚拟桌面基础结构 (VDI) 提供程序预配设备。
获取增量 设备集合 获取设备的增量更改。
列出隶属于 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 (eq值 、 ne、 genot、 le和 eq) null$orderby和 。
cloudLicensing microsoft.graph.cloudLicensing.deviceCloudLicensing 此设备的云许可关系,包括分配、使用权限和等待成员。
complianceExpirationDateTime DateTimeOffset 设备不再被视为合规的时间戳。 时间戳类型使用 ISO 8601 格式表示日期和时间信息,并且始终采用 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。
deviceCategory String 用户定义的属性由 Intune 设置,用于自动将设备添加到组并简化设备管理。
deviceId String 由 Azure 设备注册服务在设备注册时设置的唯一标识符。 此 ID 是可用于引用设备对象的备用键。 还支持 $filter (eq、 、 nenot) 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、 userEnrollment、 deviceEnrollmentManager、 appleUserEnrollmentWithServiceAccountappleUserEnrollmentwindowsAzureADJoinUsingDeviceAuthwindowsCoManagementwindowsAutoEnrollmentwindowsAzureADJoinwindowsBulkAzureDomainJoinappleBulkWithUserappleBulkWithoutUserwindowsBulkUserless。

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

支持 $filter(eq、not、startsWith 和 null 值上的 eq)。
主机名 字符串集合 设备的主机名列表。
id String 设备唯一标识符。 继承自 directoryObject。 密钥,不可为 NULL。 只读。 支持 $filter (eq、 ne、 not、 in)。
isCompliant 布尔值 true如果设备符合移动设备管理 (MDM) 策略;否则为 false。 只读。 只能由适用于任何设备的 Intune 操作系统类型或经批准的适用于 Windows 操作系统设备的 MDM 应用进行更新。 支持 $filter(eq、ne、not)。
isManaged 布尔值 true如果设备由移动设备管理 (MDM) 应用管理;否则为 false. 只能由适用于任何设备的 Intune 操作系统类型或经批准的适用于 Windows 操作系统设备的 MDM 应用进行更新。 支持 $filter(eq、ne、not)。
isManagementRestricted 布尔值 指示设备是否为受限管理单元的成员。 如果未设置,则默认值为 null false,默认行为为 false。 只读。

若要管理属于受限管理管理单元成员的设备,必须在受限管理管理单元范围内为管理员或呼叫应用分配 Microsoft Entra 角色。
isRooted 布尔值 true 如果设备已 root 或已越狱。 此属性只能由 Intune 更新。
kind String 设备的外形规格。 仅当用户作为 Project Rome 的一部分使用 Microsoft 帐户登录时才返回。
managementType String 设备的管理通道。 Intune 设置此属性。 可能的值为: eas、 mdm、 googleCloudDevicePolicyControllerjamfunknownconfigurationManagerClientMdmeasIntuneClientconfigurationManagerClientMdmEaseasMdmintuneClientconfigurationManagerClient。
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 (eq、 ne、 not、 ge和 eqlestartsWith) 值。null
operatingSystemVersion String 设备的操作系统版本。 必填。 支持 $filter (eq、 ne、 not、 ge和 eqlestartsWith) 值。null
physicalIds 字符串集合 仅供内部使用。 不可为 null。 支持 $filter (eq、 not、 gele、 startsWith/$count eq 0/$count ne 0、 。
平台 String 设备的平台。 仅当用户作为 Project Rome 的一部分使用 Microsoft 帐户登录时才返回。
profileType String 设备的配置文件类型。 可能值: RegisteredDevice (默认) 、SecureVM、SharedPrinterIoT。
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)",
  "cloudLicensing": {
    "@odata.type": "microsoft.graph.cloudLicensing.deviceCloudLicensing"
  },
  "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"
}