策略实体参考

策略类别包含用于移动设备的实体,这些实体跟踪如下信息:

  • 设备配置文件、应用配置文件和符合性策略的清单
  • 每天处于成功、挂起、失败或错误状态的设备数
  • 每天处于成功、挂起、失败或错误状态的用户数
  • 处于成功、挂起、失败或错误状态的累积设备数

策略

策略实体列出了设备配置文件、应用配置文件和符合性策略。 可以将移动设备管理 (MDM) 的策略分配给企业中的组。

属性 说明 示例
policyKey 用于表示数据仓库中的策略的唯一键。 123
policyId 数据仓库中策略的唯一标识符。 b66bc706-ffff-7437-0340-032819502773
policyName 策略的名称。 “Windows 10 基线”
policyVersion 策略的版本。 编辑或更改策略时,将创建较新版本。 1, 2, 3
isDeleted 指示是否已更新策略记录。
True- policy 具有包含更新字段的新记录。
False - 策略的最新记录。
True/False
startDateInclusiveUTC 在数据仓库中创建策略的 UTC 日期和时间。 2016/11/23 12:00:00 AM
deletedDateUTC IsDeleted 更改为 True 时的 UTC 日期和时间。 2016/11/23 12:00:00 AM
rowLastModifiedDateTimeUTC 上次在数据仓库中修改策略的 UTC 日期和时间。 2016/11/23 12:00:00 AM

policyTypes

policyType 实体列出了设备配置文件、应用配置文件和合规性策略的类型。 可以将移动设备管理 (MDM) 的策略分配给企业中的组。

属性 说明 示例
policyTypeId 源系统中策略的唯一标识符。 123
policyTypeKey 数据仓库中策略的唯一标识符。 1
policyTypeName 策略类型的名称。 Windows 10 合规性策略。

设备配置

deviceConfigurationProfileDeviceActivity 实体列出了每天处于成功、挂起、失败或错误状态的设备数。 该数字反映了分配给实体的设备配置文件。 例如,如果 设备 在其所有分配的策略中处于成功状态,则会将成功的计数器递增一天。 如果为设备分配了两个配置文件,一个处于成功状态,另一个处于错误状态,则实体将递增“成功”计数器并将设备置于错误状态。 实体列出过去 30 天内给定日期处于哪个状态的设备数。

属性 说明 示例
dateKey 在数据仓库中记录设备配置文件签入时的日期键。 20160703
待定 处于挂起状态的唯一设备数。 123
成功 处于成功状态的唯一设备数。 12
error 处于错误状态的唯一设备数。 10
失败 处于失败状态的唯一设备数。 2

deviceConfigurationProfileUserActivity 实体列出每天处于成功、挂起、失败或错误状态的用户数。 该数字反映了分配给实体的设备配置文件。 例如,如果用户为其分配的所有 策略都处于 成功状态,则会在当天将成功的计数器上移一个。 如果用户分配了两个配置文件,一个处于成功状态,另一个处于错误状态,则统计处于错误状态的用户。 deviceConfigurationProfileUserActivity 实体列出过去 30 天内给定日期处于哪个状态的用户数。

属性 说明 示例
dateKey 在数据仓库中记录设备配置文件签入时的日期键。 20160703
待定 处于挂起状态的唯一用户数。 123
成功 处于成功状态的唯一用户数。 12
error 处于错误状态的唯一用户数。 10
失败 处于失败状态的唯一用户数。 2

policyTypeActivities

policyTypeActivity 实体列出处于成功、挂起、失败或错误状态的累计设备数。 它列出了有关设备配置文件、应用配置文件或每天符合性策略的这些状态。

属性 说明 示例
dateKey 在数据仓库中记录设备配置文件签入时的 dateKey。 20160703
policyKey policyKey, 可与策略联接以获取 policyName。 Windows 10 基线
policyTypeKey 策略密钥的类型可与策略类型联接以获取策略类型名称。 Windows10 合规性策略
待定 处于挂起状态的唯一设备数。 123
成功 处于成功状态的唯一设备数。 12
error 处于错误状态的唯一设备数。 10
失败 处于故障状态的唯一设备数。 2

合规性策略

合规性策略 API 参考包含提供有关分配给设备的合规性策略的状态信息的实体。

compliancePolicyStatusDeviceActivities

下表汇总了向设备分配符合性策略的状态。 它列出了在每个符合性状态中找到的设备计数。

属性 说明 示例
dateKey 为符合性策略创建摘要时的日期键。 20161204
unknown 由于其他原因而脱机或无法与 Intune 通信或Microsoft Entra ID 的设备数。 5
notApplicable 管理员所面向的设备符合性策略不适用的设备数。 201
顺从的 成功应用管理员针对的一个或多个设备符合性策略的设备数。 4083
inGracePeriod 不符合条件但处于管理员定义的宽限期的设备数。 57
nonCompliant 未能应用管理员针对的一个或多个设备符合性策略的设备数,或者用户未遵守管理员针对的策略的设备数。 43
error 无法与 Intune 或 Microsoft Entra ID 通信并返回错误消息的设备数。 3

compliancePolicyStatusDevicePerPolicyActivities

下表汇总了按策略和按策略类型向设备分配符合性策略的状态。 它列出了每个分配的符合性策略在每个符合性状态中找到的设备计数。

属性 说明 示例
dateKey 为符合性策略创建摘要时的日期键。 20161219
policyKey 为其创建了摘要的符合性策略的键。 10178
policyPlatformKey 为其创建摘要的符合性策略的平台类型的键。 5
unknown 由于其他原因而脱机或无法与 Intune 通信或Microsoft Entra ID 的设备数。 13
notApplicable 管理员所面向的设备符合性策略不适用的设备数。 3
顺从的 成功应用管理员针对的一个或多个设备符合性策略的设备数。 45
inGracePeriod 不符合条件但处于管理员定义的宽限期的设备数。 3
nonCompliant 未能应用管理员针对的一个或多个设备符合性策略的设备数,或者用户未遵守管理员针对的策略的设备数。 7
error 无法与 Intune 或 Microsoft Entra ID 通信并返回错误消息的设备数。 3

policyPlatformTypes

下表包含所有已分配策略的平台类型。 此表中不存在从未分配给任何设备的策略平台类型。

属性 说明 示例
policyPlatformTypeKey 策略平台类型的唯一键。 20170519
policyPlatformTypeId 策略平台类型的唯一标识符。 1
policyPlatformTypeName 策略平台类型的名称。 AndroidForWork

policyDeviceActivities

下表列出了每天处于成功、挂起、失败或错误状态的设备数。 该数字反映每个策略类型配置文件的数据。 例如,如果设备在其所有分配的策略中处于成功状态,则会将成功的计数器递增一天。 如果为设备分配了两个配置文件,一个处于成功状态,另一个处于错误状态,则实体将递增“成功”计数器并将设备置于错误状态。 policyDeviceActivity 实体列出过去 30 天内给定日期处于哪个状态的设备数。

属性 说明 示例
dateKey 在数据仓库中记录设备配置文件签入时的日期键。 20160703
待定 处于挂起状态的唯一设备数。 123
Succeeded 处于成功状态的唯一设备数。 12
policyKey policyKey, 可与策略联接以获取 policyName。 Windows 10 基线
error 处于错误状态的唯一设备数。 10
失败 处于失败状态的唯一设备数。 2

policyUserActivities

下表列出了每天处于成功、挂起、失败或错误状态的用户数。 该数字反映每个策略类型配置文件的数据。 例如,如果用户为其分配的所有策略都处于成功状态,则会在当天将成功的计数器上移一个。 如果用户分配了两个配置文件,一个处于成功状态,另一个处于错误状态,则统计处于错误状态的用户。 PolicyUserActivity 实体列出过去 30 天内给定日期处于哪个状态的用户数。

属性 说明 示例
dateKey 在数据仓库中记录设备配置文件签入时的日期键。 20160703
待定 处于挂起状态的唯一设备数。 123
成功 处于成功状态的唯一设备数。 12
policyKey policyKey, 可与策略联接以获取 policyName。 Windows 10 基线
error 处于错误状态的唯一设备数。 10