Condividi tramite

Query del dispositivo per più dispositivi

Nota

Questa funzionalità è disponibile come componente aggiuntivo Intune. Per altre informazioni, vedere Usare le funzionalità del componente aggiuntivo Intune Suite.

La query del dispositivo per più dispositivi consente di ottenere informazioni dettagliate complete sull'intera flotta di dispositivi usando Linguaggio di query Kusto (KQL) per eseguire query sui dati di inventario raccolti per i dispositivi.

Prima di iniziare

Prerequisiti aggiuntivi per la query del dispositivo per più dispositivi:

Requisiti della piattaforma del dispositivo

La query del dispositivo per più dispositivi supporta:

  • Windows
  • Android
    • Dispositivi dedicati di proprietà dell'azienda Android Enterprise (COSU)
    • Android Enterprise di proprietà aziendale completamente gestita (COBO)
    • Profilo di lavoro di proprietà dell'azienda Android Enterprise (COPE)
  • Mela
    • iOS/iPadOS
    • macOS

Requisiti di configurazione del dispositivo

La query del dispositivo per più dispositivi supporta i dispositivi che sono:

  • Gestito da Intune e contrassegnato come di proprietà dell'azienda
  • Per raccogliere i dati di inventario, i dispositivi Windows devono avere un criterio del catalogo delle proprietà distribuito.
    Per iOS/iPadOS, Android e macOS, i dati vengono raccolti automaticamente e non è necessario distribuire criteri del catalogo delle proprietà separati.

Requisiti dei ruoli

Per usare la query del dispositivo per più dispositivi, usare un account con almeno uno dei ruoli seguenti:

  • Operatore help desk
  • Ruolo personalizzato che include:
    • Autorizzazione Dispositivi gestiti/Query
    • Autorizzazioni che offrono visibilità e accesso ai dispositivi gestiti in Intune (ad esempio, organizzazione/lettura, dispositivi gestiti/lettura)

Usare la query del dispositivo per più dispositivi

  1. Nell'interfaccia di amministrazione Microsoft Intune selezionare Dispositivi>Query dispositivo.
  2. Immettere una query nella casella di query usando le proprietà supportate e gli operatori supportati.
  3. Selezionare Esegui per eseguire la query.
  4. I risultati vengono visualizzati nell'area della scheda Risultati .
    • Se si vuole eseguire solo una parte della query o se sono presenti più query nella finestra di query e ne si vuole eseguire solo una, è possibile evidenziare la query da eseguire e selezionare Esegui. Viene eseguita solo la query.

È possibile espandere la visualizzazione a sinistra per visualizzare tutte le proprietà su cui è possibile eseguire query. Selezionare uno qualsiasi da popolare nella query. È possibile selezionare e trascinare i bordi sia del lato sinistro che della finestra di query per apportare eventuali modifiche.

Dopo aver eseguito una query, selezionare Esporta per salvare i risultati in un file .CSV. È possibile esportare tutte le colonne nel risultato della query o solo le colonne selezionate. È possibile esportare fino a 50.000 risultati in un file.

Per altre informazioni su Linguaggio di query Kusto, vedere Altre informazioni sui Linguaggio di query Kusto.

Consiglio

Usare Copilot in Intune per generare query KQL per query sul dispositivo usando richieste in linguaggio naturale. Per altre informazioni, vedere Eseguire query con Copilot nella query sul dispositivo.

Query di esempio

Per iniziare, in questa sezione vengono fornite alcune query di esempio. Per accedere alle query di esempio, espandere la sezione query di esempio nella pagina Introduzione e selezionare quella da aggiungere alla finestra della query. La sezione seguente illustra l'elenco di query di esempio.

Processori principali per numero di core

Questa query elenca le prime cinque CPU ordinate in base al numero di core.

Cpu| project Device, ProcessorId, Model, Architecture, CpuStatus, ProcessorType, CoreCount, LogicalProcessorCount, Manufacturer, AddressWidth| order by CoreCount asc| take 5

Dispositivi con dischi non protetti

Questa query elenca i dispositivi con dischi non crittografati.

EncryptableVolume| where ProtectionStatus != "PROTECTED"| join LogicalDrive

Dispositivi Arm64

Questa query elenca tutti i dispositivi con un processore ARM64.

Cpu | where Architecture == "ARM64"

Numero di dispositivi in base all'architettura del processore

Questa query fornisce un riepilogo dei dispositivi in base all'architettura della CPU.

Cpu| summarize DeviceCount=count() by Architecture

Dispositivi principali in base alla capacità della batteria

Questa query elenca i primi 10 dispositivi in base alla capacità della batteria completamente carica.

Battery| project Device, InstanceName, Manufacturer, Model, SerialNumber, CycleCount, DesignedCapacity, FullChargedCapacity, FullChargedCapacityPercent = (FullChargedCapacity*100)/DesignedCapacity| top 10 by FullChargedCapacityPercent asc

Informazioni sulla memoria dei dispositivi

Questa query elenca i dispositivi con memoria fisica e virtuale in GB.

MemoryInfo| project Device, PhysicalMemoryGB = PhysicalMemoryTotalBytes/(1000*1000*1000), VirtualMemoryGB = VirtualMemoryTotalBytes/(1000*1000*1000) | order by PhysicalMemoryGB asc

Numero di dispositivi per versione del sistema operativo

Questa query fornisce un riepilogo dei dispositivi in base alla versione del sistema operativo.

OsVersion| summarize DevicesCount = count() by OsVersion

Informazioni sul BIOS dei dispositivi

Questa query elenca i dispositivi basati sul produttore del BIOS.

BiosInfo| where Manufacturer contains "Microsoft"

Dispositivi TPM disabilitati

Questa query elenca i dispositivi con TPM disabilitato.

Tpm | where Enabled != true

Operatori supportati

La query del dispositivo supporta solo un subset degli operatori supportati nel Linguaggio di query Kusto (KQL). Attualmente sono supportati gli operatori seguenti:

Operatori di tabella

Gli operatori di tabella possono essere usati per filtrare, riepilogare e trasformare i flussi di dati. Sono supportati gli operatori seguenti:

Operatori di tabella Descrizione
count Restituisce una tabella con un singolo record contenente il numero di record.
distinct Produce una tabella con la combinazione distinta delle colonne specificate della tabella di input.
join Unire le righe di due tabelle per formare una nuova tabella associando una riga per lo stesso dispositivo. Sono supportati solo i tipi join di innerunique, Leftouter, FullouterRightouter, e inner. Se si digita un tipo di join diverso da quello supportato, vengono ignorati. Le istruzioni join supportano on la sintassi se unite in join con Device o Device.Deviceid. La sintassi comune per il join è LeftEntity | join [hints] (RightEntity) in Condizioni. Per altre info, vedi La documentazione relativa all'aggiunta .
order by Ordinare le righe della tabella di input in base a una o più colonne.
project Selezionare le colonne da includere, rinominare o rilasciare e inserire nuove colonne calcolate.
take Tornare al numero specificato di righe.
top Restituisce i primi N record ordinati in base alle colonne specificate.
where Filtrare una tabella nel sottoinsieme di righe che soddisfano un predicato.
summarize produce una tabella che aggrega il contenuto della tabella di input.

Operatori scalari

Gli operatori scalari possono essere usati per eseguire operazioni su singoli valori. Sono supportati gli operatori seguenti:

Operatori Descrizione Esempio
== Uguale 1 == 1, 'aBc' == 'AbC'
!= Non uguale 1 != 2, 'abc' != 'abcd'
< Less 1 < 2, 'abc' < 'DEF'
> Greater 2 > 1, 'xyz' > 'XYZ'
<= Minore o uguale 1 <= 2, 'abc' <= 'abc'
>= Maggiore o uguale 2 >= 1, 'abc' >= 'ABC'
+ Aggiunta 2 + 1, now() + 1d
- Sottrarre 2 - 1, now() - 1h
* Moltiplicare 2 * 2
/ Dividere 2 / 1
% Modulo 2 % 1
like LHS contiene una corrispondenza per RHS 'abc' like '%B%'
contains RHS si verifica come sottosequenza di LHS 'abc' contains 'b'
!contains RHS non si verifica in LHS 'team' !contains 'i'
startswith RHS è una sottosequenza iniziale di LHS 'team' startswith 'tea'
!startswith RHS non è una sottosequenza iniziale di LHS 'abc' !startswith 'bc'
endswith RHS è una sottosequenza di chiusura di LHS 'abc' endswith 'bc'
!endswith RHS non è una sottosequenza di chiusura di LHS 'abc' !endswith 'a'
and True se e solo se RHS e LHS sono true (1 == 1) and (2 == 2)
or True se e solo se RHS o LHS è true (1 == 1) or (1 == 2)

Funzioni di aggregazione

Le funzioni di aggregazione possono essere usate per riepilogare i dati. Sono supportate le funzioni seguenti:

Funzione Descrizione
avg() Restituisce la media dei valori nel gruppo
count() Restituisce un conteggio dei record per gruppo di riepilogo
countif() Restituisce un conteggio di righe per le quali predicato restituisce true
dcount() Restituisce il numero di valori distinti nel gruppo
max() Restituisce il valore massimo nel gruppo
maxif() Restituisce il valore massimo nel gruppo per il quale Predicato restituisce true
min() Restituisce il valore minimo nel gruppo
minif() Restituisce il valore minimo nel gruppo per il quale Predicato restituisce true
percentile() Restituisce una stima per il percentile di rango più vicino specificato della popolazione definita da Expr
sum() Restituisce la somma dei valori nel gruppo
sumif() Restituisce una somma di Expr per cui predicato restituisce true

Funzioni scalari

Le funzioni scalari possono essere usate per eseguire operazioni su singoli valori. Sono supportate le funzioni seguenti:

Funzione Descrizione
ago() Sottrae l'intervallo di tempo specificato dall'ora UTC corrente.
bin() Arrotonda i valori per difetto a un numero di datetime multipli di una determinata dimensione del contenitore.
case() Valuta un elenco di predicati e restituisce la prima espressione di risultato il cui predicato è soddisfatto.
datetime_add() Calcola un nuovo datetime da un datepart specificato moltiplicato per un importo specificato, aggiunto a un datetime specificato. I valori negativi per il parametro amount non sono supportati.
datetime_diff() Calcola la differenza tra due valori datetime.
iif() Valuta il primo argomento e restituisce il valore del secondo o del terzo argomento a seconda che il predicato abbia valutato true (secondo) o false (terzo).
indexof() Segnala l'indice in base zero della prima occorrenza di una stringa specificata all'interno della stringa di input.
isnotnull() Valuta l'unico argomento e restituisce un valore booleano che indica se l'argomento restituisce un valore diverso da Null.
isnull() Valuta l'unico argomento e restituisce un valore booleano che indica se l'argomento restituisce un valore Null.
now() Restituisce l'ora UTC corrente.
strcat() Concatena tra 1 e 64 argomenti.
strlen() Restituisce la lunghezza, espressa in caratteri, della stringa di input.
substring() Estrae una sottostringa da una stringa di origine a partire da un indice alla fine della stringa.
tostring() Converte l'input in una rappresentazione di stringa.

Proprietà supportate

La query del dispositivo supporta le entità seguenti. Per altre informazioni sulle proprietà supportate per ogni entità, vedere Intune Data Platform Schema.

  • Apple Auto Setup Admin Accounts
  • Apple Device States
  • Apple Update Settings
  • Battery
  • Bios Info
  • Bluetooth
  • Cellular
  • CPU
  • Device Storage
  • Disk Drive
  • Encryptable Volume
  • Logical Drive
  • Memory Info
  • Network Adapter
  • Os Version
  • Shared iPad
  • Sim Info
  • System Enclosure
  • SystemInfo
  • Time
  • Tpm
  • Video Controller
  • Windows Qfe

Entità dispositivo

La query del dispositivo per più dispositivi supporta un'entità collegata. L'entità Device può essere usata con tutte le altre entità supportate. L'entità dispositivo supporta le proprietà seguenti:

Proprietà Tipo Descrizione
DeviceId Stringa ID univoco generato da Intune come parte della registrazione del dispositivo.
EntraDeviceId Stringa ID univoco generato da Microsoft Entra come parte della registrazione o dell'aggiunta Microsoft Entra.
ManagementName Stringa Un nome di dispositivo facilmente riconoscibile usato solo nell'interfaccia di amministrazione Intune. La modifica di questo nome non modifica il nome del dispositivo o il nome nella Portale aziendale.
DeviceName Stringa Nome del dispositivo.
SerialNumber Stringa Numero di serie del dispositivo
Manufacturer Stringa Produttore del dispositivo
Model Stringa Modello del dispositivo
OSDescription Stringa Descrizione completa dell'edizione del sistema operativo
OSVersion Stringa Versione del sistema operativo nel dispositivo
EnrollmentProfileName Stringa Nome del profilo di registrazione assegnato al dispositivo. Il valore predefinito è una stringa vuota che indica che al dispositivo non è stato assegnato alcun profilo di registrazione.
EnrolledDateTime Datetime Data e ora in cui il dispositivo è stato registrato in Intune.
CertExpirationDateTime Datetime Segnala la data di scadenza del certificato di gestione dei dispositivi.
EnrolledByUserId Stringa Identificatore univoco per l'utente che ha registrato il dispositivo
PrimaryUserId Stringa Identificatore univoco per l'utente associato al dispositivo.
LastLoggedOnUserId Stringa Identificatore univoco per l'ultimo utente che ha eseguito l'accesso al dispositivo.
InCompliancePeriodUntilDateTime Datetime DateTime alla scadenza del periodo di tolleranza per la conformità del dispositivo
DeviceCategoryId Stringa Nome visualizzato della categoria di dispositivi. L'impostazione predefinita corrisponde a un campo vuoto.
LastSeenDateTime Stringa Data e ora dell'ultima connessione del dispositivo a Intune.
Ownership Stringa Proprietà del dispositivo.

L'entità dispositivo consente di fare riferimento al dispositivo associato a una riga risultante senza dover scrivere una query separata per unirli. In sostanza, funge da join automatico per includere le informazioni sul dispositivo nei risultati della query.

L'entità del dispositivo viene unita automaticamente a ogni altra entità per facilitarne l'uso. L'entità dispositivo è la prima colonna nei risultati della query, a meno che la query non aggiorni il tipo restituito tramite l'uso di operatori come project, summarizeo distinct.

L'uso di Device da solo in una query viene analizzato in Device.DeviceId. Nella colonna Device restituita per impostazione predefinita, DeviceId viene convertito in DeviceName per semplificare l'identificazione dei dispositivi. È anche possibile fare riferimento all'entità del dispositivo e alle relative proprietà nelle query facendo riferimento a Device. [Insert property].

La query seguente restituisce tutte le informazioni su DiskDrive per tutti i dispositivi con numero di serie 123:

DiskDrive
where Device.SerialNumber = 123

La query seguente proietta le proprietà ID dispositivo e Produttore dell'entità DiskDrive:

DiskDrive | project Device.DeviceId, Manufacturer

Anche se l'entità Device visualizzata come prima colonna per impostazione predefinita viene visualizzata come nomi di dispositivo che usano Device da solo in una query viene analizzata in Device.DeviceId. Questa query restituisce i risultati ordinati in base a DeviceID, non a DeviceName:

MemoryInfo | order by Device

Analogamente, questa query non restituisce risultati a meno che l'ID dispositivo non sia Desktop123. Non esegue query sul nome del dispositivo:

Cpu | where Device == "Desktop123"

Usare l'esempio seguente per eseguire query sul nome del dispositivo:

Cpu | where Device.DeviceName == 'Desktop123"

Limitazioni note

  • L'uso dell'entità Device nelle funzioni di aggregazione mostra una sottolineatura rossa. Tuttavia, la query può comunque essere eseguita e può restituire risultati come previsto. Ad esempio, la query seguente mostra una sottolineatura rossa in Dispositivo , ma viene comunque eseguita:

    Cpu | summarize max(Device) by Manufacturer.

  • Le query con un operatore join, i parametri $left e $right mostrano una sottolineatura rossa sotto $left e $right. Tuttavia, la query può comunque essere eseguita e restituisce i risultati come previsto.

  • Una singola query può contenere un massimo di tre operatori join. Le query con più join hanno esito negativo.

  • Per una query vengono restituiti al massimo circa 50.000 record.

  • È possibile inviare un massimo di 10 query al minuto. Qualsiasi altra query nello stesso minuto ha esito negativo.

  • È possibile inviare un massimo di 1.000 query al mese.

  • I valori negativi per il parametro amounts della funzione datetime_add() non sono supportati.

  • Se si fa riferimento a una variabile riepilogata da una funzione di aggregazione, viene generato un errore. La denominazione esplicita della variabile consente alla query di eseguire nuovamente l'operazione. Ad esempio, la query Device | summarize dcount(DeviceId) | order by dcount_DeviceId avrà esito negativo. Device | summarize DCountDeviceIdRename=dcount(DeviceId) | order by DCountDeviceIdRename ha esito positivo.

  • Last updated on