设备实体参考

设备类别包含跟踪信息的移动设备实体,例如:

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

deviceTypes

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

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

示例

deviceTypeID 名称 说明
0 桌面 Windows 桌面设备
1 WindowsRT WindowsRT 设备
2 WinMO6 Windows Mobile 6.0 设备
3 诺基亚 诺基亚设备
4 WindowsPhone Windows Phone 设备
5 Mac Mac 设备
6 WinCE Windows CE 设备
7 WinEmbedded Windows 嵌入式设备
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 BlackBerry 设备
101 手掌 掌上设备
255 未知 未知设备类型

enrollmentActivities

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

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

enrollmentEventStatuses

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

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

示例

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

enrollmentFailureCategories

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

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

示例

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

enrollmentFailureReasons

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

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

示例

enrollmentFailureReasonName 说明
不适用 注册失败原因不适用。
不可用 注册失败原因不可用。
未知 未知错误。
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) 。
未知 - 此设备上没有信息。
公司个人未知

注意

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

managementStates

managementStates 实体提供有关设备状态的详细信息。 在应用远程操作、设备越狱或 root 的情况下,详细信息可能很有用。

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

示例

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

managementAgentTypes

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

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

示例

ManagementAgentTypeID 名称 说明
1 EAS 设备通过 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 未知 未知的管理代理类型。
2048 IntuneAosp 设备由 Intune 的 MDM 管理 AOSP (Android 开源项目) 设备。

设备

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

属性 说明
deviceKey 数据仓库中设备的唯一标识符 - 代理密钥。
deviceId 设备的唯一标识符。
deviceName 允许命名设备的平台上的设备名称。 在其他平台上,Intune 从其他属性创建名称。 此属性并非适用于所有设备。
deviceTypeKey 此设备的设备类型属性的密钥。
deviceRegistrationState 此设备的客户端注册状态属性的密钥。
ownerTypeKey 此设备的所有者类型属性的密钥:公司、个人或未知。
enrolledDateTime 注册此设备的日期和时间。
lastSyncDateTime 使用 Intune 检查上次已知的设备。
managementAgentKey 与此设备关联的管理代理的密钥。
managementStateKey 与此设备关联的管理状态的密钥,指示远程操作的最新状态或是否已越狱/拔根。
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 脚本和在 Microsoft Intune 中管理 Win32 应用。

注意:
“Intune Data Warehouse设备”表存在已知问题。 office365Version设备记录的属性可能为 null。 此属性当前正在维护中,可能会弃用。 因此,应考虑不要将此属性值用于报告目的。

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

注意

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

devicePropertyHistories

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

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