Collegamento tenant: panoramica dell'utilizzo di CMPivot

Articolo
04/04/2023

Si applica a: Configuration Manager (Current Branch)

CMPivot consente di valutare rapidamente lo stato di un dispositivo nell'ambiente e di intervenire. Quando si immette una query, CMPivot eseguirà una query in tempo reale nel dispositivo attualmente connesso. I dati restituiti possono quindi essere filtrati, raggruppati e perfezionati per rispondere alle domande aziendali, risolvere i problemi nell'ambiente o rispondere alle minacce alla sicurezza. Per altre informazioni sull'uso di CMPivot, vedere Usare CMPivot.

Perfezionare le query CMPivot

Quando si usa CMPivot dall'interfaccia di amministrazione Microsoft Intune, assicurarsi che le query siano ottimizzate per le prestazioni. Se si richiede una query con un set di dati troppo grande, è possibile che venga visualizzato Error: The query result is too large, retry with additional filters. Perfeziona la query in modo che sia più specifica se viene visualizzato questo errore. Gli operatori seguenti vengono comunemente usati per perfezionare le query:

Usare count se è necessario solo il numero di elementi restituiti.
Usare project se sono necessarie solo colonne specifiche.
Utilizzare take per restituire fino al numero specificato di righe.
Utilizzare top per restituire i primi N record ordinati in base alle colonne specificate.

Importante

Quando si usa CMPivot per eseguire query su un dispositivo, se non è presente una risposta entro 10 minuti, la query verrà timeout.

Query

Le query possono essere usate per cercare termini, identificare tendenze, analizzare modelli e fornire molte altre informazioni dettagliate basate sui dati. CMPivot usa un subset del modello di flusso di dati di Azure Log Analytics per l'istruzione dell'espressione tabulare. La struttura tipica di un'istruzione di espressione tabulare è una composizione di entità client e operatori di dati tabulari, ad esempio filtri e proiezioni. La composizione è rappresentata dal carattere di pipe (|), che fornisce all'istruzione una forma regolare che rappresenta visivamente il flusso di dati tabulari da sinistra a destra. Ogni operatore accetta un set di dati tabulari "dalla pipe" e input aggiuntivi (inclusi altri set di dati tabulari) dal corpo dell'operatore, quindi genera un set di dati tabulari all'operatore successivo che segue: entity | operator1 | operator2 | ...

Nell'esempio seguente l'entità è CCMRecentlyUsedApplications (un riferimento alle applicazioni usate di recente) e l'operatore è dove (che filtra i record dal relativo input in base a un predicato per record):

CCMRecentlyUsedApplications | where CompanyName like '%Microsoft%' | project CompanyName, ExplorerFileName, LastUsedTime, LaunchCount, FolderPath

Entità

Le entità sono oggetti su cui è possibile eseguire query dal client. Attualmente sono supportate le entità seguenti:

Entità	Descrizione
AadStatus	Stato dell'ID Microsoft Entra
Amministratori	Membri del gruppo administrators locale
AppCrash	Report sugli arresti anomali dell'applicazione recenti
AppVClientApplication	Applicazione client AppV
AppVClientPackage	Pacchetto client AppV
AutoStartSoftware	Software che inizia automaticamente con o immediatamente dopo il sistema operativo
Battiscopa	Battiscopa
Batteria	Batteria
Bios	Informazioni sul BIOS di sistema
BitLocker	BitLocker
BitLockerEncryptionDetails	Dettagli crittografia BitLocker
BitLockerPolicy	Criteri di BitLocker
BootConfiguration	Configurazione di avvio
BrowserHelperObject	Oggetto Browser Helper
BrowserUsage	Utilizzo del browser
CcmLog()	Righe entro 24 ore (per impostazione predefinita) da un file di log Ccm
CCMRAX	CCM_RAX
CCMRecentlyUsedApplications	Applicazioni usate di recente
CCMWebAppInstallInfo	Applicazioni Web
CDROM	Unità CDROM
Eventi client	Eventi client
ComputerSystem	Computer System
ComputerSystemEx	Computer System Ex
ComputerSystemProduct	Computer System Product
ConnectedDevice	Dispositivo connesso
Connessione	Una connessione TCP attiva all'interno o all'esterno del dispositivo
Desktop	Desktop
DesktopMonitor	Monitoraggio desktop
Dispositivo	Informazioni di base sul dispositivo
Disco	Informazioni sul dispositivo di archiviazione locale in un sistema computer che esegue Windows
DMA	DMA
DMAChannel	Canale DMA
DriverVxD	Driver - VxD
EmbeddedDeviceInformation	Informazioni sul dispositivo incorporato
Ambiente	Ambiente
EPStatus	Stato del software antimalware nel computer raccolto dal `Get-MpComputerStatus` cmdlet. Supportato in Windows 10 e Server 2016 o versioni successive con Defender in esecuzione.
EventLog()	Eventi entro 24 ore (per impostazione predefinita) da un registro eventi
File()	Informazioni su un file specifico
Fileshare	Informazioni sulla condivisione file attiva
Firmware	Firmware
IDEController	IDE Controller
InstalledExecutable	Eseguibile installato
InstalledSoftware	Un'applicazione installata nel dispositivo
IPConfig	Ottiene la configurazione di rete, incluse interfacce utilizzabili, indirizzi IP e server DNS
IRQTable	Tabella IRQ
Tastiera	Tastiera
LoadOrderGroup	Gruppo di ordini di caricamento
LogicalDisk	Disco logico
MDMDevDetail	Informazioni sul dispositivo
Memoria	Memoria
Modem	Modem
Scheda madre	Scheda madre
NetworkAdapter	Scheda di rete
NetworkAdapterConfiguration	Configurazione scheda di rete
NetworkClient	Client di rete
NetworkLoginProfile	Profilo di accesso alla rete
NTEventlogFile	NT Eventlog File
Office365ProPlusConfigurations	configurazioni delle app Office 365
OfficeAddin	Componenti aggiuntivi di Office
OfficeClientMetric	Metrica client di Office
OfficeDeviceSummary	Riepilogo dei dispositivi di Office
OfficeDocumentMetric	Metriche dei documenti di Office
OfficeDocumentSolution	Soluzione documento di Office
OfficeMacroError	Errore macro di Office
OfficeProductInfo	Informazioni sul prodotto Office
OfficeVbaRuleViolation	Violazione della regola Vba di Office
OfficeVbaSummary	Riepilogo dell'analisi VBA di Office
OperatingSystem	Sistema operativo
OperatingSystemEx	Sistema operativo ex
OperatingSystemRecoveryConfiguration	Configurazione del ripristino del sistema operativo
OptionalFeature	Funzionalità facoltativa
Sistema operativo	Informazioni di base sul sistema operativo
PageFileSetting	Impostazione file di pagina
ParallelPort	Porta parallela
Partizione	Partizioni disco
PCMCIAController	PCMCIA Controller
Disco fisico	Disco fisico
PhysicalMemory	Memoria fisica
PNPDEVICEDRIVER	Driver di dispositivo PNP
Dispositivo di puntamento	Dispositivo di puntamento
PortableBattery	Batteria portatile
Porte	Porte
PowerCapabilities	Funzionalità di alimentazione
PowerClientOptOutSettings	Impostazioni di esclusione di Risparmio energia
PowerConfigurations	Power Configuration
PowerManagementDaily	Dati giornalieri di Risparmio energia
PowerManagementInsomniaReasons	Motivi dell'insonnia del potere
PowerManagementMonthly	Dati mensili di Risparmio energia
PowerSettings	Impostazioni risparmio energia
PrinterConfiguration	Configurazione stampante
PrinterDevice	Dispositivo stampante
Processi di stampa	Processi di stampa
Procedura	Un processo in un sistema operativo
ProcessModule()	Moduli caricati da processi specificati
Processore	Processore
ProtectedVolumeInformation	Informazioni sul volume protetto
Protocollo	Protocollo
QuickFixEngineering	Quick Fix Engineering
Registro di sistema	Tutti i valori per una chiave del Registro di sistema specifica A partire dalla versione 2107, il valore della chiave è stato aggiunto all'entità Registry()
SCSIController	SCSI Controller
SerialPortConfiguration	Configurazione porta seriale
SerialPorts	Porte seriali
ServerFeature	Funzionalità server
Servizio	Un servizio in un sistema computer che esegue Windows
Servizi	Servizi
Azioni	Azioni
SMBConfig	Configurazione SMB di un dispositivo
SMSAdvancedClientPorts	Porte client Configuration Manager
SMSAdvancedClientSSLConfigurations	configurazioni SSL client Configuration Manager
SMSAdvancedClientState	stato client Configuration Manager
SMSDefaultBrowser	Browser predefinito
SMSSoftwareTag	Software Tag
SMSWindows8Application	App di Windows
SMSWindows8ApplicationUserInfo	Informazioni utente dell'app di Windows
SoftwareShortcut	Collegamento software
SoftwareUpdate	Aggiornamento software applicabile ma non installato nel dispositivo
SoundDevices	Dispositivi audio
SWLicensingProduct	Software Licensing Product
SWLicensingService	Servizio licenze software
SystemAccount	Account di sistema
SystemBootData	Dati di avvio del sistema
SystemBootSummary	Riepilogo dell'avvio del sistema
SystemConsoleUsage	Utilizzo della console di sistema
SystemConsoleUser	Utente console di sistema
SystemDevices	Dispositivi di sistema
SystemDrivers	Driver di sistema
SystemEnclosure	Enclosure di sistema
TapeDrive	Unità nastro
Fuso orario	Fuso orario
TPM	TPM
TPMStatus	Stato TPM
TSIssuedLicense	Licenza rilasciata da TS
TSLicenseKeyPack	Key Pack di licenza TS
UninterruptiblePowerSupply	Continuità
USBController	USB Controller
DISPOSITIVO USB	Dispositivo USB
Utente	Un account utente con una connessione attiva al dispositivo
USMFolderRedirectionHealth	Integrità reindirizzamento cartelle
USMUserProfile	Integrità profilo utente
VideoController	Video Controller
VirtualMachine	Macchina virtuale
VirtualMachine64	Macchina virtuale (64)
Volume	Volume
WindowsUpdate	Windows Update
WindowsUpdateAgentVersion	versione dell'agente Windows Update
WinEvent()	Eventi entro 24 ore (per impostazione predefinita) da un registro eventi di Windows
WriteFilterState	Stato filtro scrittura

Operatori di tabella

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

Operatori di tabella	Descrizione
Conteggio	Restituisce una tabella con un singolo record contenente il numero di record
Distinti	Produce una tabella con la combinazione distinta delle colonne fornite della tabella di input
Unirsi	Unire le righe di due tabelle per formare una nuova tabella associando una riga per lo stesso dispositivo
order by	Ordinare le righe della tabella di input in base a una o più colonne
Progetto	Selezionare le colonne da includere, rinominare o eliminare e inserire nuove colonne calcolate
Prendere	Restituisce fino al numero specificato di righe
In alto	Restituisce i primi N record ordinati in base alle colonne specificate
Dove	Filtra una tabella nel subset di righe che soddisfano un predicato

Operatori scalari

La tabella seguente riepiloga gli operatori:

Operatori	Descrizione	Esempio
==	Uguale	`1 == 1, 'aBc' == 'AbC'`
!=	Non uguale	`1 != 2, 'abc' != 'abcd'`
<	Meno	`1 < 2, 'abc' < 'DEF'`
>	Maggiore	`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`
come	Left Hand Side (LHS) contiene una corrispondenza per right hand side (RHS)	`'abc' like '%B%'`
!Come	LHS non contiene una corrispondenza per RHS	`'abc' !like '_d_'`
Contiene	RHS si verifica come sottosequenza di LHS	`'abc' contains 'b'`
!Contiene	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'`
e	True se e solo se RHS e LHS sono true	`(1 == 1) and (2 == 2)`
oppure	True se e solo se RHS o LHS è true	`(1 == 1) or (1 == 2)`

Funzioni di aggregazione

Le funzioni di aggregazione possono essere usate con l'operatore di tabella summarize per calcolare i valori riepilogati. Attualmente sono supportate le funzioni di aggregazione 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()	A partire dalla versione 2107, è possibile usare maxif con l'operatore di tabella summarize. Restituisce il valore massimo nel gruppo per il quale Predicato restituisce `true`.
min()	Restituisce il valore minimo nel gruppo
minif()	A partire dalla versione 2107, è possibile usare minif con l'operatore di tabella summarize. 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 nelle espressioni. Attualmente sono supportate le funzioni scalari 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 del 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
datetime_diff()	Calcola la differenza tra due valori di data e ora
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()	La funzione 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, 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

Entità, operatori e funzioni aggiuntive per CMPivot da Configuration Manager