设备实体参考

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

  • 设备类型
  • 设备注册和注册状态
  • 设备所有权
  • 设备管理状态
  • 要Microsoft Entra 状态的设备成员身份
  • 注册状态
  • 有关设备的历史信息
  • 设备上的应用清单

deviceTypes

deviceTypes 实体表示由其他数据仓库实体引用的设备类型。 设备类型通常描述设备型号、制造商或两者的组合。

属性 说明
deviceTypeID 设备类型的唯一标识符
deviceTypeKey 数据仓库中设备类型的唯一标识符 - 代理键
deviceTypeName 设备类型

示例

deviceTypeID 名称 说明
0 桌面 Windows 桌面设备
1 WindowsRT WindowsRT 设备
2 WinMO6 Windows Mobile 6.0 设备
3 Nokia Nokia 设备
4 WindowsPhone Windows Phone设备
5 Mac Mac 设备
6 畏缩 Windows CE 设备
7 WinEmbedded Windows Embedded 设备
8 IPhone iPhone 设备
9 IPad iPad 设备
10 IPod iPod 设备
11 Android 使用设备管理员管理的 Android 设备
12 ISocConsumer iSoc 使用者设备
14 MacMDM 使用内置 MDM 代理管理的 OS X 设备
15 HoloLens HoloLens 设备
16 SurfaceHub Surface Hub 设备
17 AndroidForWork 使用 Android 配置文件所有者管理的 Android 设备
100 黑莓 Blackberry 设备
101 手掌 掌上设备
255 Unknown 未知设备类型

enrollmentActivities

enrollmentActivity 实体指示设备注册的活动。

属性 说明
dateKey 记录此注册活动的日期的键。
deviceEnrollmentTypeKey 注册类型的密钥。
deviceTypeKey 设备类型的键。
enrollmentEventStatusKey 指示注册成功或失败的状态的键。
enrollmentFailureCategoryKey 注册失败类别的密钥 (如果注册失败) 。
enrollmentFailureReasonKey 注册失败原因的密钥 (如果注册失败) 。
osVersion 设备的操作系统版本。
count 与上述分类匹配的注册活动总数。

enrollmentEventStatuses

enrollmentEventStatus 实体指示设备注册的结果。

属性 说明
enrollmentEventStatusKey 数据仓库中注册状态的唯一标识符 (代理项)
enrollmentEventStatusName 注册状态的名称。 请参阅以下示例。

示例

enrollmentEventStatusName 说明
成功 成功的设备注册
已失败 设备注册失败
不可用 注册状态不可用。

enrollmentFailureCategories

EnrollmentFailureCategory 实体指示设备注册失败的原因。

属性 说明
enrollmentFailureCategoryKey 数据仓库中注册失败类别的唯一标识符 (代理键)
enrollmentFailureCategoryName 注册失败类别的名称。 请参阅以下示例。

示例

enrollmentFailureCategoryName 说明
不适用 注册失败类别不适用。
不可用 注册失败类别不可用。
Unknown 未知错误。
身份验证 身份验证失败。
Authorization 呼叫已经过身份验证,但无权注册。
AccountValidation 未能验证帐户进行注册。 (帐户被阻止,) 未启用注册
UserValidation 无法验证用户。 (用户不存在,缺少许可证)
DeviceNotSupported 移动设备管理不支持设备。
InMaintenance 帐户正在维护中。
BadRequest 客户端发送了服务不理解/支持的请求。
FeatureNotSupported 此帐户不支持此注册使用的功能 () 。
EnrollmentRestrictionsEnforced 管理员配置的注册限制阻止了此注册。
ClientDisconnected 客户端超时或最终用户中止注册。
UserAbandonment 最终用户已放弃注册。 (最终用户已开始载入,但未能及时完成)

enrollmentFailureReasons

EnrollmentFailureReason 实体指示给定故障类别内设备注册失败的更详细原因。

属性 说明
enrollmentFailureReasonKey 数据仓库中注册失败原因的唯一标识符 (代理密钥)
enrollmentFailureReasonName 注册失败原因的名称。 请参阅以下示例。

示例

enrollmentFailureReasonName 说明
不适用 注册失败原因不适用。
不可用 注册失败原因不可用。
Unknown 未知错误。
UserNotLicensed 在 Intune 中找不到用户,或者没有有效的许可证。
UserUnknown Intune 不知道用户。
BulkAlreadyEnrolledDevice 只有一个用户可以注册设备。 此设备以前由其他用户注册。
EnrollmentOnboardingIssue 尚未配置 Intune 移动设备管理 (MDM) 机构。
AppleChallengeIssue iOS 管理配置文件安装延迟或失败。
AppleOnboardingIssue 需要 Apple MDM 推送证书才能注册到 Intune。
DeviceCap 用户尝试注册的设备数超过允许的最大数目。
AuthenticationRequirementNotMet Intune 注册服务未能授权此请求。
UnsupportedDeviceType 此设备不符合 Intune 注册的最低要求。
EnrollmentCriteriaNotMet 由于配置的注册限制规则,此设备注册失败。
BulkDeviceNotPreregistered 找不到此设备的国际移动设备标识符 (IMEI) 或序列号。 如果没有此标识符,设备将被识别为当前被阻止的个人拥有的设备。
FeatureNotSupported 用户尝试访问的功能尚未面向所有客户发布,或者与 Intune 配置不兼容。
UserAbandonment 最终用户已放弃注册。 (最终用户已开始载入,但未能及时完成)
APNSCertificateExpired 无法使用过期的 Apple MDM 推送证书管理 Apple 设备。

ownerTypes

ownerType 实体指示设备是公司设备、个人拥有设备还是未知设备。

属性 说明 示例
ownerTypeID 所有者类型的唯一标识符。
ownerTypeKey 数据仓库中所有者类型的唯一标识符 - 代理键。
ownerTypeName 表示设备的所有者类型:
公司 - 设备是企业拥有的。
个人 - 设备 (BYOD) 个人拥有。
未知 - 此设备上没有信息。
公司个人未知

注意

ownerTypeName在为设备创建动态组时,对于 AzureAD 中的 ,需要将筛选器值deviceOwnership设置为 Company。 有关详细信息,请参阅 设备规则

managementStates

managementStates 实体提供有关设备状态的详细信息。 在应用远程操作、设备已越狱或取得 root 权限的情况下,详细信息非常有用。

属性 说明
managementStateID 管理状态的唯一标识符。
managementStateKey 数据仓库中管理状态的唯一标识符 - 代理键。
managementStateName 指示应用于此设备的远程操作的状态。

示例

managementStateID 名称 说明
0 托管 托管,没有挂起的远程操作。
1 RetirePending 设备有一个挂起的停用命令。
2 RetireFailed 停用命令在设备上失败。
3 WipePending 设备有一个挂起的擦除命令。
4 WipeFailed 擦除命令在设备上失败。
5 不正常 不正常状态。
6 DeletePending 设备有一个挂起的删除命令。
7 RetireIssued 已向设备发出停用命令。
8 WipeIssued 已发出擦除命令。
9 WipeCanceled 擦除命令已取消。
10 RetireCanceled 停用命令已取消。
11 已发现 设备是 Intune 新发现的,一旦它签入,它第一次进入 -托管状态。

managementAgentTypes

ManagementAgentType 实体表示用于管理设备的代理。

属性 说明
managementAgentTypeID 管理代理类型的唯一标识符。
managementAgentTypeKey 数据仓库中管理代理类型的唯一标识符 - 代理键。
managementAgentTypeName 指示用于管理设备的代理类型。

示例

ManagementAgentTypeID 名称 说明
1 大通 设备通过 Exchange Active Sync 进行管理。
2 MDM 设备使用 MDM 代理进行管理。
3 EasMdm 设备由 Exchange Active Sync 和 MDM 代理管理。
4 IntuneClient 设备由 Intune 电脑代理管理。
5 EasIntuneClient 设备由 Exchange Active Sync 和 Intune 电脑代理管理。
8 ConfigManagerClient 设备由 Configuration Manager 代理管理。
16 Unknown 未知的管理代理类型。
2048 IntuneAosp 设备由 Intune 的适用于 AOSP 的 MDM 管理, (Android 开源项目) 设备。

设备

设备实体列出管理下的所有已注册设备及其相应的属性。

属性 说明
deviceKey 数据仓库中设备的唯一标识符 - 代理键。
deviceId 设备的唯一标识符。
deviceName 允许命名设备的平台上的设备的名称。 在其他平台上,Intune 会从其他属性创建名称。 此属性不能用于所有设备。
deviceTypeKey 此设备的设备类型属性的键。
deviceRegistrationState 此设备的客户端注册状态属性的密钥。
ownerTypeKey 此设备的所有者类型属性的键:公司、个人或未知。
enrolledDateTime 注册此设备的日期和时间。
lastSyncDateTime 上次使用 Intune 签入已知设备。
managementAgentKey 与此设备关联的管理代理的密钥。
managementStateKey 与此设备关联的管理状态的键,指示远程操作的最新状态或是否已越狱/获取 root 权限。
azureADDeviceId 此设备的 Azure deviceID。
azureADRegistered 设备是否Microsoft已注册 Entra。
deviceCategoryKey 与此设备关联的类别的键。
deviceEnrollmentType 与此设备关联的注册类型的密钥,指示注册方法。
complianceStateKey 与此设备关联的符合性状态的键。
osVersion 设备的操作系统版本。
easDeviceId 设备的 Exchange ActiveSync ID。
serialNumber 序列号
userId 与设备关联的用户的唯一标识符。
rowLastModifiedDateTimeUTC 上次在数据仓库中修改此设备的 UTC 日期和时间。
manufacturer 设备的制造商
model 设备的型号
operatingSystem 设备的操作系统。 Windows、iOS/iPadOS 等。
isDeleted 用于显示设备是否已删除的二进制文件。
androidSecurityPatchLevel Android 安全修补程序级别
MEID MEID
isSupervised 设备受监督状态
freeStorageSpaceInBytes 可用存储(以字节为单位)。
totalStorageSpaceInBytes 总存储(以字节为单位)。
encryptionState 设备上的加密状态。
subscriberCarrier 设备的订阅者运营商
phoneNumber 设备的电话号码
IMEI IMEI
cellularTechnology 设备的手机网络技术
WiFiMacAddress Wi-Fi MAC
ICCD 集成电路卡标识符
windowsOsEdition Windows 操作系统版本。
ethernetMacAddress 此设备的唯一网络标识符。
model 设备型号。
office365Version 设备上安装的 Microsoft 365 的版本。 Office365Version 仅在 Windows 计算机上安装 Intune 管理扩展代理时收集。 管理员还必须创建并分配 PowerShell 或 Win32 应用才能安装代理。 有关详细信息,请参阅 在 Intune 中使用 Windows 10 设备上的 PowerShell 脚本Intune 中的 Win32 应用管理Microsoft

注意
Intune 数据仓库 设备 表存在已知问题。 office365Version设备记录的 属性可以为 null。 此属性当前处于维护状态,可能会弃用。 因此,应考虑不要将此属性值用于报告目的。

SubnetAddressV4Wifi IPV4 Wifi 连接的子网地址。
IpAddressV4Wifi IPV4 Wifi 连接的 IP 地址。

注意

有关 Windows SKU 枚举值的详细信息,请参阅 设备属性

devicePropertyHistories

devicePropertyHistory 实体具有与设备表和过去 60 天每天每个设备记录的每日快照相同的属性。 DateKey 列指示每行的日期。

属性 说明
dateKey 对指示日期的日期表的引用。
deviceKey 数据仓库中设备的唯一标识符 - 代理键。 这是对包含 Intune 设备 ID 的 Device 表的引用。
deviceName 允许命名设备的平台上的设备的名称。 在其他平台上,Intune 会从其他属性创建名称。 此属性不能用于所有设备。
deviceRegistrationStateKey 此设备的设备注册状态属性的键。
ownerTypeKey 此设备的所有者类型属性的键:公司、个人或未知。
managementStateKey 与此设备关联的管理状态的键,指示远程操作的最新状态或是否已越狱/获取 root 权限。
azureADRegistered 设备是否Microsoft已注册 Entra。
complianceStateKey ComplianceState 的键。
OSVersion OS 版本。
jailBroken 设备是否越狱或已获取 root 权限。
deviceCategoryKey 此设备的设备类别属性的键。
physicalMemoryInBytes 物理内存(以字节为单位)。
totalStorageSpaceInBytes 总存储容量(以字节为单位)。