对 Microsoft Intune 中的多个设备使用设备查询,跨设备清单数据运行Kusto 查询语言 (KQL) 查询,并确定整个托管队列的趋势。 本文介绍先决条件、如何在 Intune 管理中心创建和运行查询、如何处理结果,以及支持哪些运算符、函数和属性。
开始之前
- 确认你的环境满足所有 先决条件。
针对多个设备的设备查询的其他先决条件:
设备平台要求
多台设备的设备查询支持:
- Windows
- Android
- Android Enterprise 公司拥有的专用设备 (COSU)
- Android Enterprise 公司拥有的完全托管 (COBO)
- Android Enterprise 公司拥有的工作配置文件 (COPE)
- Apple
- iOS/iPadOS
- macOS
设备配置要求
多台设备的设备查询支持以下设备:
- 由 Intune 管理并标记为公司拥有。
- Windows 设备必须部署有 属性目录策略 才能收集清单数据。
对于 iOS/iPadOS、Android 和 macOS,会自动收集数据,并且无需部署单独的属性目录策略。
角色要求
对多台设备使用设备查询
- 在 Microsoft Intune 管理中心中,选择设备>设备查询。
- 使用支持的属性和运算符在查询框中输入查询。
- 选择“运行”以运行查询。
- 在“ 结果 ”选项卡中查看结果。
- 若要在存在多个查询时运行部分查询或单个查询,请突出显示要运行的查询并选择 “运行”。 仅运行突出显示的查询。
可以展开左侧的视图以查看可查询的所有可用属性。 选择一个属性以将其插入查询中。 还可以调整左窗格和查询窗口的大小以调整布局。
有关 Kusto 查询语言 (KQL) 的详细信息,请参阅了解有关 Kusto 查询语言 的详细信息。
提示
使用 Intune 中的 Copilot,使用自然语言请求为设备查询生成 KQL 查询。 若要了解详细信息,请参阅 在设备查询中使用 Copilot 进行查询。
查询结果和操作
运行查询后,结果将显示在 “结果 ”选项卡中。可以通过以下几种方式与结果进行交互:
- 当查询返回的 项目不超过 50 个时,可以搜索结果中的所有行,并使用列标题应用筛选器。
- 通过选择“将所有项目添加到组”,直接从查询结果创建 Microsoft Entra 安全组。 此操作可帮助你使用 Microsoft Entra 条件访问策略或 Microsoft Intune 策略定位特定设备。
- 选择 “导出” 以将结果保存到 .csv 文件。 可以导出所有列或仅导出选定列。 最多可以将 50,000 个结果导出到一个文件。
示例查询
为了帮助你入门,本节提供了一些示例查询。 若要访问示例查询,请展开“入门”页面下的“示例查询”部分,然后选择要添加到查询窗口的查询。 下一部分显示了示例查询的列表。
按内核计数排名靠前的处理器
此查询显示按内核计数排列的前五个 CPU。
Cpu
| project Device, ProcessorId, Model, Architecture, CpuStatus, ProcessorType, CoreCount, LogicalProcessorCount, Manufacturer, AddressWidth
| order by CoreCount asc
| take 5
具有未受保护磁盘的设备
此查询列出了具有未加密磁盘的设备。
EncryptableVolume
| where ProtectionStatus != "PROTECTED"
| join LogicalDrive on Device
ARM64 设备
此查询列出了具有 ARM64 处理器的所有设备。
Cpu
| where Architecture == "ARM64"
按处理器体系结构划分的设备计数
此查询按 CPU 体系结构提供设备摘要。
Cpu
| summarize DeviceCount = count() by Architecture
按电池容量排名靠前的设备
此查询列出了按充满电电池容量排名前 10 的设备。
Battery
| project Device, InstanceName, Manufacturer, Model, SerialNumber, CycleCount,
DesignedCapacity,
FullChargedCapacity,
FullChargedCapacityPercent = (FullChargedCapacity * 100) / DesignedCapacity
| top 10 by FullChargedCapacityPercent asc
设备内存信息
此查询列出了具有物理内存和虚拟内存(以 GB 为单位)的设备。
MemoryInfo
| project Device,
PhysicalMemoryGB = PhysicalMemoryTotalBytes/(1000*1000*1000),
VirtualMemoryGB = VirtualMemoryTotalBytes/(1000*1000*1000)
| order by PhysicalMemoryGB asc
按操作系统版本列出的设备计数
此查询按操作系统版本提供设备摘要。
OsVersion| summarize DevicesCount = count() by OsVersion
设备 BIOS 信息
此查询根据 BIOS 制造商列出设备。
BiosInfo| where Manufacturer contains "Microsoft"
禁用 TPM 的设备
此查询列出禁用了 TPM 的设备。
Tpm | where Enabled != true
支持的运算符
设备查询仅支持Kusto 查询语言 (KQL) 中支持的运算符子集。 目前支持以下运算符:
表运算符
表运算符可用于筛选、汇总和转换数据流。 支持以下运算符:
| 表运算符 | 说明 |
|---|---|
count |
返回具有包含记录数的单条记录的表。 |
distinct |
生成一个表,其中包含输入表中所提供列的不同组合。 |
join |
合并两个表中的行,以基于指定列中的匹配值形成一个新表。 支持以下联接类型: - innerunique (默认)- inner- leftouter- rightouter- fullouter- leftsemi- rightsemi- leftanti- rightanti联接语句支持可选 on 子句。 在设备查询方案中,通常在联接包含Device实体的表时使用on Device。 is: 的join常见语法。 LeftTable | join [hints] (RightTable) on Conditions重要提示: 不再支持使用的 on Device.DeviceID 联接。 当前指定的on Device.DeviceId查询应切换为使用 on Device,或者在实体上Device联接时省略该on子句。有关详细信息,请参阅 联接运算符。 |
order by |
按一列或多列对输入表的行进行排序。 |
project |
选择要包含、重命名或删除的列,并插入新的计算列。 |
take |
最多返回指定行数。 |
top |
返回按指定列排序的前 N 条记录。 |
where |
将表筛选为满足谓词的行的子集。 |
summarize |
生成聚合输入表内容的表。 |
注意
Device是实体类型,不能直接用于需要标量值 (例如 、 和 summarizeorder by) 的distinct运算符。 对于这些运算符,请使用设备 (的特定标量属性,例如) Device.SerialNumberDevice.OSVersion 。
标量运算符
标量运算符可用于对单个值执行操作。 支持以下运算符:
| 运算符 | 说明 | 示例 |
|---|---|---|
== |
等于 |
1 == 1, 'aBc' == 'AbC' |
!= |
不相等 |
1 != 2, 'abc' != 'abcd' |
< |
更少 |
1 < 2, 'abc' < 'DEF' |
> |
大于 |
2 > 1, 'xyz' > 'XYZ' |
<= |
小于或等于 |
1 <= 2, 'abc' <= 'abc' |
>= |
大于或等于 |
2 >= 1, 'abc' >= 'ABC' |
+ |
添加 |
2 + 1, now() + 1d |
- |
减法 |
2 - 1, now() - 1h |
* |
乘法 | 2 * 2 |
/ |
除法 | 2 / 1 |
% |
求余 | 2 % 1 |
like |
LHS 包含 RHS 的匹配项 | 'abc' like '%B%' |
contains |
RHS 作为 LHS 的亚序列出现 | 'abc' contains 'b' |
!contains |
RHS 在 LHS 中不会出现 | 'team' !contains 'i' |
startswith |
RHS 是 LHS 的初始子序列 | 'team' startswith 'tea' |
!startswith |
RHS 不是 LHS 的初始子序列 | 'abc' !startswith 'bc' |
endswith |
RHS 是 LHS 的关闭子序列 | 'abc' endswith 'bc' |
!endswith |
RHS 不是 LHS 的关闭子序列 | 'abc' !endswith 'a' |
and |
当且仅当 RHS 和 LHS 为 true 时,才为 true | (1 == 1) and (2 == 2) |
or |
当且仅当 RHS 或 LHS 为 true 时,才为 true | (1 == 1) or (1 == 2) |
聚合函数
聚合函数可用于汇总数据。 支持以下函数:
| 功能 | 说明 |
|---|---|
avg() |
返回整个组中值的平均值 |
count() |
返回每个汇总组的记录计数 |
countif() |
返回谓词计算结果为 true 的行计数 |
dcount() |
返回组中非重复值的数目 |
max() |
返回整个组的最大值 |
maxif() |
返回谓词计算结果为 true 的组的最大值 |
min() |
返回整个组的最小值 |
minif() |
返回谓词计算结果为 true 的组内的最小值 |
percentile() |
返回由 Expr 定义的总体的指定最近排名百分点值的估计值 |
sum() |
返回组中值的和 |
sumif() |
返回 Expr 的总和,其 Predicate 计算结果为 true |
标量函数
标量函数可用于对单个值执行操作。 支持以下函数:
| 功能 | 说明 |
|---|---|
ago() |
从当前 UTC 时钟时间减去给定的时间跨度。 |
bin() |
将值向下舍入为给定箱大小的日期时间倍数。 |
case() |
计算谓词列表,并返回满足谓词的第一个结果表达式。 |
datetime_add() |
通过指定的日期部分乘以指定的量再加到指定的日期时间,计算出新的日期时间。 不支持 amount 参数的负值。 |
datetime_diff() |
计算两个日期时间值之间的差值。 |
iif() |
计算第一个参数,并返回第二个或第三个参数的值,具体取决于预测在第二个) 计算结果为 true (还是在第三个) (计算为 false。 |
indexof() |
报告输入字符串中第一次出现指定字符串时从零开始的索引。 |
isnotnull() |
计算其唯一参数,并返回一个布尔值,指示参数的计算结果是否为非 null 值。 |
isnull() |
计算其唯一参数,并返回一个布尔值,指示参数的计算结果是否为 null 值。 |
now() |
返回当前 UTC 时钟时间。 |
strcat() |
连接 1 到 64 个参数。 |
strlen() |
返回输入字符串的长度(字符数)。 |
substring() |
从源字符串提取从某个索引到字符串末尾的子字符串。 |
tostring() |
将输入转换为字符串表示形式。 |
支持的属性
设备查询支持以下实体。 若要详细了解每个实体支持哪些属性,请参阅 Intune 数据平台架构。
Apple Auto Setup Admin AccountsApple Device StatesApple Update SettingsBatteryBios InfoBluetoothCellularCPUDevice StorageDisk DriveEncryptable VolumeLocal AI AgentLogical DriveMemory InfoNetwork AdapterOs VersionShared iPadSim InfoSystem EnclosureSystemInfoTimeTpmVideo ControllerWindows Qfe
设备实体
多个设备的设备查询支持链接实体。 Device 实体可与所有其他受支持的实体一起使用。 设备实体支持以下属性:
| 属性 | 类型 | 说明 |
|---|---|---|
DeviceId |
String | Intune 在设备注册过程中生成的唯一 ID。 |
EntraDeviceId |
String | Microsoft Entra 在注册或加入过程中生成的 Microsoft Entra 唯一 ID。 |
ManagementName |
String | 仅在 Intune 管理中心中使用的易于识别的设备名称。 更改此名称不会更改设备名称或公司门户中的名称。 |
DeviceName |
String | 设备的名称 |
SerialNumber |
String | 设备的序列号 |
Manufacturer |
String | 设备的制造商 |
Model |
String | 设备的型号 |
OSDescription |
String | 操作系统版本完整说明 |
OSVersion |
String | 设备上的操作系统版本 |
EnrollmentProfileName |
String | 分配给设备的注册配置文件的名称。 默认值为空字符串,指示未向设备分配任何注册配置文件。 |
EnrolledDateTime |
日期/时间 | 设备在 Intune 中注册的日期和时间。 |
CertExpirationDateTime |
日期/时间 | 报告设备管理证书到期日期。 |
EnrolledByUserId |
String | 注册设备的用户的唯一标识符 |
PrimaryUserId |
String | 与设备关联的用户的唯一标识符。 |
LastLoggedOnUserId |
String | 上次登录到设备的用户的唯一标识符。 |
InCompliancePeriodUntilDateTime |
日期/时间 | 设备符合性宽限期的到期日期/时间 |
DeviceCategoryId |
String | 设备类别显示名称。 默认值为空字符串。 |
LastSeenDateTime |
String | 设备上次连接到 Intune 的日期和时间。 |
Ownership |
String | 设备的所有权。 |
该 Device 实体允许你引用与每个生成的行关联的设备信息,而无需显式联接设备表。
默认情况下,查询结果包含为 Device 每行提供设备上下文的实体列。 运算符(如 project、 或 summarize) distinct 可以更改返回的列。
Device 表示与生成的行关联的设备,并且可以作为实体类型列直接引用。 在查询结果中显示时, Device 实体使用友好标识符(如设备名称)来显示,以便更轻松地识别设备。
可以使用 在查询Device.[Property]中引用实体的Device属性。
以下查询返回具有特定序列号的设备的所有 DiskDrive 信息:
DiskDrive
| where Device.SerialNumber == "123"
以下查询从实体投影 Device 实体和 Manufacturer 属性 DiskDrive :
DiskDrive
| project Device, Manufacturer
默认情况下,查询结果包含表示 Device 与每行关联的设备的实体。
Device实体是实体类型列,不隐式解析为特定标量属性。
对结果进行排序或筛选时,显式引用要使用的设备属性。 例如,此查询按设备名称对结果进行排序:
MemoryInfo
| order by Device.DeviceName
同样,若要按设备名称进行筛选,请直接引用 DeviceName 属性:
Cpu
| where Device.DeviceName == "Desktop123"
已知限制
使用实体类型列(如
Device在聚合函数中)可以在编辑器中显示红色下划线,因为聚合函数需要标量值。 若要避免这种情况,请引用实体的特定标量属性。 例如:Cpu | summarize max(CpuUsage) by Device.Manufacturer将运算符与 and
$right参数配合$left使用的join查询可能会在编辑器中显示红色下划线。 但是,查询仍可以按预期运行并返回结果。单个查询最多可包含三个
join运算符。 包含更多联接的查询将失败。为一个查询最多返回 ~50,000 条记录。
每分钟最多可提交 10 个查询。 同一分钟内的其他查询失败。
每月最多可以提交 1,000 个查询。
不支持函数参数
datetime_add()的负值amount。引用由聚合函数生成的变量而不显式命名可能会导致查询失败。 显式命名变量可使查询成功。 例如:
- 查询
Device | summarize dcount(DeviceId) | order by dcount_DeviceId失败。 - 查询
Device | summarize DCountDeviceIdRename = dcount(DeviceId) | order by DCountDeviceIdRename成功。 - 目前不支持“本地 AI 代理”实体的 NL2KQL 协助。
- 查询