注意事項
此功能可作為 Intune 附加元件提供。 欲了解更多資訊，請參閱使用 Intune Suite 附加元件功能。
多台裝置查詢讓您能利用 KQL) Kusto 查詢語言 (查詢您設備庫存資料，全面洞察整個裝置車隊。
開始之前
- 確認你的環境符合所有 先決條件。
多裝置查詢的額外前提條件：
裝置平台需求
多裝置查詢支援：
- Windows
- Android
- Android Enterprise 企業擁有的專用裝置 (COSU)
- Android 企業由企業擁有的全託管 (COBO)
- Android 企業擁有的工作設定檔 (COPE)
- 蘋果
- iOS/iPadOS
- macOS
裝置配置需求
多裝置查詢支援以下裝置：
- 由 Intune 管理，並標示為企業所有
- Windows 裝置必須部署屬性 目錄政策 以收集庫存資料。
對於 iOS/iPadOS、Android 和 macOS，資料會自動收集，且不需要另外部署屬性目錄政策。
職務要求
使用多台裝置查詢
- 在 Microsoft Intune 管理中心，選擇裝置>查詢。
- 在查詢框中輸入查詢，使用支援的屬性與運算子。
- 選取 [執行] 以執行查詢。
- 結果會顯示在 結果 標籤區。
- 如果你只想執行部分查詢，或查詢視窗中有多個查詢但只想執行一個，你可以選取你想執行的查詢並選擇 執行。 只有該查詢會被執行。
你可以展開左側的視圖，查看所有可查詢的屬性。 請選擇任一一題來填入你的查詢中。 你可以選取並拖動左側和查詢視窗的邊緣來做任何調整。
執行查詢後，選擇 匯出 將結果儲存為 .CSV 檔案。 你可以選擇匯出查詢結果中的所有欄位，或只匯出你選擇的欄位。 你可以匯出最多 50,000 個結果成一個檔案。
欲了解更多關於 Kusto 查詢語言的資訊，請參閱「了解更多關於 Kusto 查詢語言」。
提示
在 Intune 中使用 Copilot 來產生 KQL 查詢，針對使用自然語言請求的裝置查詢。 欲了解更多，請參閱 裝置查詢中的「使用 Copilot 查詢」。
範例查詢
為了幫助你入門，本節提供了一些範例查詢。 要存取範例查詢，請在「開始」頁面下展開 範例查詢 區，並選擇你想加入查詢視窗的查詢。 以下章節展示範例查詢清單。
以核心數計算的頂尖處理器
此查詢列出依核心數排序的前五名 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
Arm64 裝置
此查詢列出所有搭載 ARM64 處理器的裝置。
Cpu | where Architecture == "ARM64"
依處理器架構分類的裝置數量
此查詢提供依 CPU 架構分類的裝置摘要。
Cpu| summarize DeviceCount=count() by Architecture
按電池容量排名前幾位的裝置
此查詢列出了按電池充滿電量排名前十的裝置。
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、 Leftouter、 FullouterRightouter、 和 內層。 如果你輸入了非支援的連接類型，它們會被忽略。 若與 Device 或 Device.Deviceid連接，join 陳述句支援on語法。 join 的常用語法是 LeftEntity |加入 [提示] (RightEntity) Conditions。 更多資訊請參閱 加入 文件。 |
order by |
將輸入資料表的列依一欄或多欄排序。 |
project |
選取要包含的資料行、重新命名或捨棄，然後插入新的計算資料行。 |
take |
傳回指定的資料列數。 |
top |
回傳依指定欄位排序的前 N 筆紀錄。 |
where |
將資料表篩選為符合述詞的資料列子集。 |
summarize |
產生一個彙整輸入資料表內容的表格。 |
純量算子
標量運算子可用於對個別值執行運算。 支援以下運算元：
| 運算子 | 描述 | 範例 |
|---|---|---|
== |
等 |
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 |
- |
Subtract |
2 - 1, now() - 1h |
* |
乘 | 2 * 2 |
/ |
除 | 2 / 1 |
% |
模模 | 2 % 1 |
like |
LHS 包含與 RHS 的匹配 | 'abc' like '%B%' |
contains |
RHS 作為 LHS 的亞序列出現 | 'abc' contains 'b' |
!contains |
右翼血球不會出現在左胸症候群中 | '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 為真 | (1 == 1) and (2 == 2) |
or |
當且僅當 RHS 或 LHS 為真時為真 | (1 == 1) or (1 == 2) |
聚合函數
聚合函數可用於資料摘要。 支援以下功能：
| 函數 | 描述 |
|---|---|
avg() |
回傳該群組中各值的平均值 |
count() |
回傳每個摘要群組的紀錄數量 |
countif() |
回傳一個列數，謂詞對其評估為真 |
dcount() |
返回該群中不同值的數量 |
max() |
返回整個群組的最大值 |
maxif() |
回傳謂詞評估為真時，群中最大值 |
min() |
回傳整個群組的最小值 |
minif() |
回傳謂詞評估為真時所處群體的最小值 |
percentile() |
回傳由 Expr 定義的人口中最近排名百分位的估計值 |
sum() |
回傳整個群中各值的總和 |
sumif() |
回傳一個 Expr 的總和，對此 謂詞評估為真 |
純量函數
標量函數可用於對個別值執行操作。 支援以下功能：
| 函數 | 描述 |
|---|---|
ago() |
從當前世界協調時鐘時間中減去給定的時間跨度。 |
bin() |
將數值向下取整為給定箱大小的日期時間倍數。 |
case() |
評估一串謂詞，並回傳第一個條件被滿足的結果表達式。 |
datetime_add() |
計算一個新的日期時間，從指定的日期部分乘以指定金額，再加到指定的日期時間。 數量參數的負值不支援。 |
datetime_diff() |
計算兩個約會時間值的差異。 |
iif() |
評估第一個參數，並根據被評為真 (謂詞在第三) ) 真或 (假，回傳第二或第三個參數的值。 |
indexof() |
報告輸入字串中指定字串首次出現的零為基礎索引。 |
isnotnull() |
評估其唯一的參數，並回傳一個布林值，指示該參數是否應值為非空值。 |
isnull() |
評估其唯一的參數，並回傳一個布林值，指示該參數是否評估為空值。 |
now() |
回傳當前的UTC時鐘時間。 |
strcat() |
串接1到64個論點。 |
strlen() |
回傳輸入字串的長度（以字元為單位）。 |
substring() |
從來源字串中擷取一個子字串，從某個索引開始到字串的末尾。 |
tostring() |
將輸入轉換為字串表示。 |
支援的屬性
裝置查詢支援以下實體。 欲了解更多各實體支援的屬性，請參閱 Intune 資料平台架構。
Apple Auto Setup Admin AccountsApple Device StatesApple Update SettingsBatteryBios InfoBluetoothCellularCPUDevice StorageDisk DriveEncryptable VolumeLogical DriveMemory InfoNetwork AdapterOs VersionShared iPadSim InfoSystem EnclosureSystemInfoTimeTpmVideo ControllerWindows Qfe
裝置實體
多裝置查詢支援連結實體。 裝置實體可與所有其他支援實體共用。 裝置實體支援以下屬性：
| 屬性 | 類型 | 描述 |
|---|---|---|
DeviceId |
字串 | 這是 Intune 在裝置註冊過程中產生的獨特 ID。 |
EntraDeviceId |
字串 | 由 Microsoft Entra 產生的獨特 ID，作為 Microsoft Entra 註冊或加入一部分。 |
ManagementName |
字串 | 一個只在 Intune 管理中心使用、容易辨識的裝置名稱。 更改這個名稱並不會改變裝置名稱或公司入口網站的名稱。 |
DeviceName |
字串 | 裝置名稱 |
SerialNumber |
字串 | 裝置序號 |
Manufacturer |
字串 | 裝置製造商 |
Model |
字串 | 裝置型號 |
OSDescription |
字串 | 作業系統版本的完整說明 |
OSVersion |
字串 | 裝置上作業系統的版本 |
EnrollmentProfileName |
字串 | 裝置所指派的註冊設定檔名稱。 預設值為空字串，表示該裝置未被指派註冊設定檔。 |
EnrolledDateTime |
約會時間 | 裝置被登記在 Intune 的日期和時間。 |
CertExpirationDateTime |
約會時間 | 報告裝置管理憑證到期日。 |
EnrolledByUserId |
字串 | 註冊該裝置使用者的唯一識別碼 |
PrimaryUserId |
字串 | 與裝置相關使用者的唯一識別碼。 |
LastLoggedOnUserId |
字串 | 唯一識別碼，代表最後登入該裝置的使用者。 |
InCompliancePeriodUntilDateTime |
約會時間 | 裝置合規寬限期結束的日期時間 |
DeviceCategoryId |
字串 | 裝置類別顯示名稱。 預設值為空字串。 |
LastSeenDateTime |
字串 | 裝置最後一次連接到 Intune 的日期和時間。 |
Ownership |
字串 | 裝置的所有權。 |
裝置實體允許你參考與結果列相關的裝置，而不必寫獨立查詢將它們連結起來。 基本上，它就像自動加入，將裝置資訊納入查詢結果中。
裝置實體會自動與其他所有實體連接，以增加使用便利性。 裝置實體是查詢結果的第一欄，除非查詢透過使用像 project、 summarize、 distinct或 這樣的運算子更新回傳類型。
在查詢中單獨使用裝置會解析為 Device.DeviceId。 預設回傳的裝置欄位中，DeviceID 會轉換成 DeviceName，以便更容易識別裝置。
裝置實體及其屬性也可透過引用 Device 來查詢。[插入屬性]。
以下查詢會回傳所有序號為123的裝置的所有磁碟機資訊：
DiskDrive
where Device.SerialNumber = 123
以下查詢將投影實體磁碟驅動器的裝置 ID 與製造商屬性：
DiskDrive | project Device.DeviceId, Manufacturer
雖然預設第一欄顯示的裝置實體以裝置名稱形式出現，但查詢時以 Device 單獨解析為 Device.DeviceId。 此查詢會回傳依 DeviceID 排序的結果，而非依 DeviceName 排序：
MemoryInfo | order by Device
同樣地，除非裝置 ID 是 Desktop123，否則此查詢不會回傳任何結果。 它不會查詢裝置名稱：
Cpu | where Device == "Desktop123"
請使用以下範例查詢裝置名稱：
Cpu | where Device.DeviceName == 'Desktop123"
已知限制
在聚合函式中使用裝置實體時，會顯示紅色底線。 然而，查詢仍可執行，並能如預期回傳結果。 例如，以下查詢在 裝置 下方會顯示紅色底線，但仍會執行：
Cpu | summarize max(Device) by Manufacturer.帶有連接運算符、$left 和 $right參數的查詢，$left 和 $right 下方會顯示紅色底線。 不過，查詢仍可執行，並如預期回傳結果。
單一查詢最多可包含三個連接運算子。 連接較多的查詢會失敗。
查詢最多可回傳約 ~50,000 筆紀錄。
每分鐘最多可提交 10 個查詢。 同一分鐘內其他查詢都失敗。
每月最多可提交 1,000 筆查詢。
datetime_add () 函數的 amounts 參數不支援負值。
引用已由聚合函數彙總的變數會產生錯誤。 明確命名變數會讓查詢再次成功。 例如，查詢裝置 |摘要 dcount (DeviceId) |dcount_DeviceId的命令將失敗。 裝置 |summarize DCountDeviceIdRename=dcount (DeviceId) |DCountDeviceIdRename 的命令成功。