Připojení tenanta: Přehled využití NÁSTROJE CMPivot

Článek
04/04/2023

Platí pro: Configuration Manager (Current Branch)

CMPivot umožňuje rychle vyhodnotit stav zařízení ve vašem prostředí a provést akci. Když zadáte dotaz, cmPivot spustí dotaz v reálném čase na aktuálně připojeném zařízení. Vrácená data je pak možné filtrovat, seskupovat a upřesňovat tak, aby odpovídala na obchodní dotazy, vyřešovala problémy ve vašem prostředí nebo reagovala na bezpečnostní hrozby. Další informace o používání nástroje CMPivot najdete v tématu Použití doplňku CMPivot.

Upřesnění dotazů CMPivot

Pokud používáte CMPivot z Centra pro správu Microsoft Intune, ujistěte se, že jsou vaše dotazy vyladěné na výkon. Pokud požádáte o dotaz s příliš velkou sadou dat, může se zobrazit Error: The query result is too large, retry with additional filters. Pokud se zobrazí tato chyba, upřesněte dotaz tak, aby byl konkrétnější. K upřesnění dotazů se běžně používají následující operátory:

Použijte count , pokud potřebujete jenom počet vrácených položek.
Použijte project , pokud potřebujete jenom konkrétní sloupce.
Slouží take k vrácení až zadaného počtu řádků.
Slouží top k vrácení prvních N záznamů seřazených podle zadaných sloupců.

Důležité

Pokud k dotazování zařízení použijete CMPivot a během 10 minut se nezobrazí odpověď, vyprší časový limit dotazu.

Dotazy

Dotazy se dají použít k vyhledávání termínů, identifikaci trendů, analýze vzorů a poskytování mnoha dalších přehledů na základě vašich dat. CMPivot používá pro příkaz tabulkového výrazu podmnožinu modelu toku dat Azure Log Analytics . Typickou strukturou příkazu tabulkového výrazu je složení klientských entit a tabulkových datových operátorů (jako jsou filtry a projekce). Složení je reprezentováno znakem svislé čáry (|), který dává příkazu pravidelný tvar, který vizuálně představuje tok tabulkových dat zleva doprava. Každý operátor přijímá tabulkovou datovou sadu "z kanálu" a další vstupy (včetně jiných tabulkových datových sad) z těla operátoru a pak vygeneruje tabulkovou datovou sadu do dalšího operátoru, který následuje: entity | operator1 | operator2 | ...

V následujícím příkladu je CCMRecentlyUsedApplications entita (odkaz na nedávno použité aplikace) a operátor je where (který filtruje záznamy ze svého vstupu podle některých predikátů pro jednotlivé záznamy):

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

Entity

Entity jsou objekty, které lze dotazovat z klienta. V současné době podporujeme následující entity:

Entity	Popis
AadStatus	Stav ID Microsoft Entra
Správci	Členové místní skupiny administrators
AppCrash	Nedávné zprávy o chybách aplikací
AppVClientApplication	Klientská aplikace AppV
AppVClientPackage	Balíček klienta AppV
AutoStartSoftware	Software, který se automaticky spustí s operačním systémem nebo bezprostředně po jeho spuštění
Baseboard	Baseboard
Baterie	Baterie
Bios	Informace o systému BIOS
Bitlocker	Bitlocker
BitLockerEncryptionDetails	Podrobnosti o šifrování nástroje BitLocker
BitLockerPolicy	Zásady nástroje BitLocker
BootConfiguration	Konfigurace spouštění
BrowserHelperObject	Objekt pomocníka prohlížeče
Využití prohlížeče	Využití prohlížeče
CcmLog()	Řádky ze souboru protokolu Ccm do 24 hodin (ve výchozím nastavení)
CCMRAX	CCM_RAX
CCMRecentlyUsedApplications	Naposledy použité aplikace
CCMWebAppInstallInfo	Webové aplikace
CDROM	Jednotka CDROM
ClientEvents	Události klienta
ComputerSystem	Počítačový systém
ComputerSystemEx	Počítačový systém Ex
ComputerSystemProduct	Produkt počítačového systému
ConnectedDevice	Připojené zařízení
Připojení	Aktivní připojení TCP v zařízení nebo mimo zařízení
Plochy	Plochy
DesktopMonitor	DesktopOvý monitor
Device	Základní informace o zařízení
Disku	Informace o místním úložném zařízení v počítačovém systému s Windows
DMA	DMA
DMAChannel	Kanál DMA
DriverVxD	Ovladač – VxD
EmbeddedDeviceInformation	Informace o vloženém zařízení
Prostředí	Prostředí
EPStatus	Stav antimalwarového softwaru na počítači shromážděný rutinou `Get-MpComputerStatus` Podporuje se na Windows 10 a Serveru 2016 nebo novějším se spuštěným defenderem.
EventLog()	Události do 24 hodin (ve výchozím nastavení) z protokolu událostí
File()	Informace o konkrétním souboru
Fileshare	Informace o aktivní sdílené složce
Firmware	Firmware
IDEController	Kontroler IDE
InstalledExecutable	Nainstalovaný spustitelný soubor
InstalledSoftware	Aplikace nainstalovaná v zařízení
IPConfig	Získá konfiguraci sítě, včetně použitelných rozhraní, IP adres a serverů DNS.
Tabulka IRQ	Tabulka IRQ
Klávesnice	Klávesnice
LoadOrderGroup	Skupina pořadí načtení
Logicaldisk	Logický disk
MDMDevDetail	Informace o zařízení
Paměti	Paměti
Modem	Modem
Základní deska	Základní deska
NetworkAdapter	Síťový adaptér
NetworkAdapterConfiguration	Konfigurace síťového adaptéru
NetworkClient	Síťový klient
NetworkLoginProfile	Profil přihlášení k síti
NTEventlogFile	Soubor protokolu událostí NT
Office365ProPlusKonfigurace	Konfigurace aplikací Office 365
OfficeAddin	Doplňky Office
OfficeClientMetric	Metrika klienta Office
OfficeDeviceSummary	Souhrn zařízení Office
OfficeDocumentMetric	Metriky dokumentů Office
OfficeDocumentSolution	Řešení dokumentů Office
OfficeMacroError	Chyba makra Office
OfficeProductInfo	Informace o produktu Office
OfficeVbaRuleViolation	Porušení pravidel jazyka Office Vba
OfficeVbaSummary	Souhrn kontroly office VBA
Operatingsystem	Operační systém
OperatingSystemEx	Operační systém Ex
OperatingSystemRecoveryConfiguration	Konfigurace obnovení operačního systému
VolitelnéFeature	Volitelná funkce
OS	Základní informace o operačním systému
PageFileSetting	Nastavení stránkovat soubor
ParallelPort	Paralelní port
Oddíl	Diskové oddíly
PCMCIAController	Řadič PCMCIA
Fyzický disk	Fyzický disk
PhysicalMemory	Fyzická paměť
PNPDEVICEDRIVER	Ovladač zařízení PNP
PointingDevice	Polohovací zařízení
PortableBattery	Přenosná baterie
Porty	Porty
PowerCapabilities	Možnosti napájení
PowerClientOptOutSettings	Nastavení vyloučení řízení spotřeby
PowerConfigurations	Konfigurace napájení
PowerManagementDaily	Denní data řízení spotřeby
PowerManagementInsomniaReasons	Power Insomnia důvody
PowerManagementMonthly	Měsíční data řízení spotřeby
PowerSettings	Nastavení napájení
Konfigurace tiskárny	Konfigurace tiskárny
PrinterDevice	Zařízení tiskárny
PrintJobs	Tiskové úlohy
Proces	Proces v operačním systému
ProcessModule()	Moduly načtené zadanými procesy
Procesor	Procesor
ProtectedVolumeInformation	Informace o chráněném svazku
Protocol (Protokol)	Protocol (Protokol)
QuickFixEngineering	Quick Fix Engineering
Registr	Všechny hodnoty pro konkrétní klíč registru Počínaje verzí 2107 se do entity Registry() přidala hodnota klíče.
SCSIController	Řadič SCSI
SerialPortConfiguration	Konfigurace sériového portu
SerialPorts	Sériové porty
ServerFeature	Funkce serveru
Služba	Služba v počítačovém systému se systémem Windows
Služby	Služby
Akcie	Akcie
SMBConfig	Konfigurace protokolu SMB zařízení
SMSAdvancedClientPorts	Configuration Manager klientských portů
SMSAdvancedClientSSLConfigurations	Konfigurace SSL klienta Configuration Manager
SMSAdvancedClientState	stav klienta Configuration Manager
SMSDefaultBrowser	Výchozí prohlížeč
SMSSoftwareTag	Softwarová značka
SMSWindows8Application	Aplikace pro Windows
SMSWindows8ApplicationUserInfo	Informace o uživateli aplikace pro Windows
SoftwareShortcut	Zástupce softwaru
SoftwareUpdate	Aktualizace softwaru použitelná, ale nenainstalovaná na zařízení
Zařízení zvuku	Zvuková zařízení
SWLicensingProduct	Produkt licencování softwaru
SWLicensingService	Služba licencování softwaru
SystemAccount	Systémový účet
SystemBootData	Data spouštění systému
SystemBootSummary	Souhrn spuštění systému
SystemConsoleUsage	Použití konzoly systému
SystemConsoleUser	Uživatel konzoly systému
Zařízení systému	Systémová zařízení
SystemDrivers	Systémové ovladače
SystemEnclosure	Systémová skříň
TapeDrive	Pásková jednotka
Timezone	Časové pásmo
Čip tpm	Čip tpm
TPMStatus	Stav čipu TPM
TSIsuedLicence	Vystavená licence TS
TSLicenseKeyPack	TS License Key Pack
NeinterruptiblePowerSupply	Nepřerušitelný zdroj napájení
USBController	Řadič USB
USBDevice	Zařízení USB
User	Uživatelský účet s aktivním připojením k zařízení
USMFolderRedirectionHealth	Stav přesměrování složky
USMUserProfile	Stav profilu uživatele
VideoController	Řadič videa
VirtualMachine	Virtuální počítač
VirtualMachine64	Virtuální počítač (64)
Objem	Objem
WindowsUpdate	Windows Update
WindowsUpdateAgentVersion	verze agenta služba Windows Update
WinEvent()	Události do 24 hodin (ve výchozím nastavení) z protokolu událostí Windows
WriteFilterState	Stav filtru zápisu

Operátory tabulek

Operátory tabulky je možné použít k filtrování, sumarizace a transformaci datových proudů. V současné době jsou podporovány následující operátory:

Operátory tabulek	Popis
Počet	Vrátí tabulku s jedním záznamem obsahujícím počet záznamů.
Odlišné	Vytvoří tabulku s jedinečnou kombinací zadaných sloupců vstupní tabulky.
Připojit	Sloučení řádků dvou tabulek a vytvoření nové tabulky pomocí odpovídajícího řádku pro stejné zařízení
order by	Seřazení řádků vstupní tabulky podle jednoho nebo více sloupců
Projektu	Vyberte sloupce, které chcete zahrnout, přejmenovat nebo odstranit a vložit nové počítané sloupce.
take take	Vrácení až do zadaného počtu řádků
Top	Vrátí první N záznamů seřazených podle zadaných sloupců.
Kde	Filtruje tabulku na podmnožinu řádků, které splňují predikát.

Skalární operátory

Následující tabulka shrnuje operátory:

Operátory	Popis	Příklad
==	Stejné	`1 == 1, 'aBc' == 'AbC'`
!=	Nerovná se	`1 != 2, 'abc' != 'abcd'`
<	Méně	`1 < 2, 'abc' < 'DEF'`
>	Větší	`2 > 1, 'xyz' > 'XYZ'`
<=	Menší nebo rovno	`1 <= 2, 'abc' <= 'abc'`
>=	Větší nebo rovno	`2 >= 1, 'abc' >= 'ABC'`
+	Přidat	`2 + 1, now() + 1d`
-	Odečíst	`2 - 1, now() - 1h`
*	Násobit	`2 * 2`
/	Rozdělit	`2 / 1`
%	Modulo	`2 % 1`
Jako	Levá strana (LHS) obsahuje shodu pro pravou stranu (RHS).	`'abc' like '%B%'`
!Jako	LHS neobsahuje shodu pro RHS	`'abc' !like '_d_'`
Obsahuje	RHS se vyskytuje jako dílčí sekvence LHS	`'abc' contains 'b'`
!Obsahuje	RHS se v LHS nevyskytuje	`'team' !contains 'i'`
Startswith	RHS je počáteční podsekvence LHS.	`'team' startswith 'tea'`
!Startswith	RHS není počáteční podsekvence LHS	`'abc' !startswith 'bc'`
Endswith	RHS je uzavírací podsekvence LHS.	`'abc' endswith 'bc'`
!Endswith	RHS není uzavírací podsekvence LHS	`'abc' !endswith 'a'`
a	True if and only if RHS and LHS are true	`(1 == 1) and (2 == 2)`
nebo	True if and only if RHS or LHS is true	`(1 == 1) or (1 == 2)`

Agregační funkce

Agregační funkce je možné použít s operátorem tabulky summarize k výpočtu souhrnných hodnot. V současné době jsou podporovány následující agregační funkce:

Funkce	Popis
avg()	Vrátí průměr hodnot ve skupině.
count()	Vrátí počet záznamů na skupinu souhrnů.
countif()	Vrátí počet řádků, pro které se predikát vyhodnotí jako true.
dcount()	Vrátí počet jedinečných hodnot ve skupině.
max()	Vrátí maximální hodnotu ve skupině.
maxif()	Od verze 2107 můžete použít maxif s operátorem summarize table. Vrátí maximální hodnotu ve skupině, pro kterou se predikát vyhodnotí jako `true`.
min()	Vrátí minimální hodnotu ve skupině.
minif()	Od verze 2107 můžete minif používat s operátorem sumarizace tabulky. Vrátí minimální hodnotu ve skupině, pro kterou se predikát vyhodnotí jako `true`.
percentil()	Vrátí odhad zadaného percentilu nejbližšího pořadí základního souboru definovaného Výrazem.
sum()	Vrátí součet hodnot ve skupině.
sumif()	Vrátí součet výrazů, pro které se predikát vyhodnotí jako true.

Skalární funkce

Skalární funkce je možné použít ve výrazech. V současné době jsou podporovány následující skalární funkce:

Funkce	Popis
ago()	Odečte daný časový rozsah od aktuálního času utc.
bin()	Zaokrouhlí hodnoty dolů na násobek data a času dané velikosti přihrádky.
case()	Vyhodnotí seznam predikátů a vrátí první výsledný výraz, jehož predikát je spokojen.
datetime_add()	Vypočítá nové datum a čas ze zadané části data vynásobené zadanou částkou přičtené k zadanému datetime.
datetime_diff()	Vypočítá rozdíl mezi dvěma hodnotami data a času.
iif()	Vyhodnotí první argument a vrátí hodnotu druhého nebo třetího argumentu v závislosti na tom, jestli se predikát vyhodnotil jako pravda (druhý) nebo nepravda (třetí).
indexof()	Funkce hlásí index od nuly prvního výskytu zadaného řetězce ve vstupním řetězci.
isnotnull()	Vyhodnotí jeho jediný argument a vrátí logickou hodnotu označující, jestli se argument vyhodnotí na hodnotu, která není null.
isnull()	Vyhodnotí jeho jediný argument a vrátí logickou hodnotu označující, jestli se argument vyhodnotí na hodnotu null.
now()	Vrátí aktuální čas hodin UTC.
strcat()	Zřetězí 1 až 64 argumentů.
strlen()	Vrátí délku vstupního řetězce (ve znach).
podřetěžce()	Extrahuje podřetězc ze zdrojového řetězce od nějakého indexu až po konec řetězce.
Tostring()	Převede vstup na řetězcovou reprezentaci.

Další entity, operátory a funkce pro CMPivot z Configuration Manager