CMPivot voor realtimegegevens in Configuration Manager

Van toepassing op: Configuration Manager (current branch)

Configuration Manager heeft altijd een grote centrale opslag met apparaatgegevens voorzien, die klanten gebruiken voor rapportagedoeleinden. Deze gegevens worden doorgaans wekelijks verzameld op de site. Vanaf versie 1806 is CMPivot een nieuw hulpprogramma voor in de console dat nu toegang biedt tot de realtime status van apparaten in je omgeving. Het voert onmiddellijk een query uit op alle momenteel verbonden apparaten in de doelverzameling en retourneert de resultaten. Filter en groepeer deze gegevens vervolgens in het hulpprogramma. Door realtime gegevens van onlineclients te verstrekken, kunt u vragen van bedrijven sneller beantwoorden, problemen oplossen en reageren op beveiligingsincidenten.

Een van de vereisten voor het oplossen van speculatieve beveiligingslekken in kanalen aan de uitvoeringszijde is bijvoorbeeld het bijwerken van het systeem-BIOS. U kunt CMPivot gebruiken om snel een query uit te voeren op systeem-BIOS-informatie en clients te vinden die niet aan de vereisten voldoen.

Vereisten

De volgende onderdelen zijn vereist om CMPivot te gebruiken:

• Voer een upgrade uit van de doelapparaten naar de nieuwste versie van de Configuration Manager-client.

• Voor doelclients is ten minste PowerShell-versie 4 vereist.

• Voor het verzamelen van gegevens voor de volgende entiteiten is PowerShell-versie 5.0 vereist voor doelclients:

  • Beheerders
  • Verbinding
  • IPConfig
  • SMBConfig

• CMPivot en het Microsoft Edge-installatieprogramma zijn momenteel ondertekend met het certificaat Microsoft Code Signing PCA 2011 . Als u het PowerShell-uitvoeringsbeleid instelt op AllSigned, moet u ervoor zorgen dat apparaten dit handtekeningcertificaat vertrouwen. U kunt het certificaat exporteren vanaf een computer waarop u de Configuration Manager-console hebt geïnstalleerd. Bekijk het certificaat op "C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\CMPivot.exe"en exporteer het certificaat voor codeondertekening vanuit het certificeringspad. Importeer het vervolgens in de Trusted Publishers-store op de computer op beheerde apparaten. U kunt het proces in de volgende blog gebruiken, maar zorg ervoor dat u het certificaat voor codeondertekening exporteert vanuit het certificeringspad: Een certificaat toevoegen aan vertrouwde uitgevers met behulp van Intune.

Machtigingen

De volgende machtigingen zijn nodig voor CMPivot:

• CMPivot-machtiging uitvoeren op de verzameling
• Leesmachtiging voor voorraadrapporten
• Leesmachtiging voor het object SMS-scripts
  • Lezen voor sms-scripts is niet vereist vanaf versie 2107
  • CMPivot heeft geen Lezen voor sms-scripts nodig voor het primaire scenario vanaf versie 2107. Als de beheerservice echter niet beschikbaar is en de machtiging is verwijderd, mislukt CMPivot wanneer de beheerservice terugvalt. De SMS-provider heeft nog steeds leestoestemming nodig voor SMS-scripts als de beheerservice hierop terugvalt vanwege een 503-fout (Service niet beschikbaar), zoals te zien is in de CMPivot.log.
• Het standaardbereik.
  • Het standaardbereik is niet vereist vanaf versie 2107

CMPivot-machtigingen per versie van Configuration Manager

Beperkingen

• CMPivot retourneert alleen gegevens voor clients die zijn verbonden met de huidige site, tenzij deze wordt uitgevoerd vanaf de site voor centraal beheer (CAS).
  • Als een verzameling apparaten van een andere site bevat, zijn CMPivot-resultaten alleen afkomstig van apparaten op de huidige site, tenzij CMPivot wordt uitgevoerd vanaf de CAS.
  • In sommige omgevingen zijn extra machtigingen nodig om CMPivot op de CAS uit te voeren. Zie CMPivot-wijzigingen voor versie 1902 voor meer informatie.
• U kunt entiteitseigenschappen, kolommen voor resultaten of acties op apparaten niet aanpassen.
• Slechts één exemplaar van CMPivot kan tegelijkertijd worden uitgevoerd op een computer waarop de Configuration Manager-console wordt uitgevoerd.
• In de zelfstandige versie van CMPivot hebt u geen toegang tot CMPivot-query's die zijn opgeslagen in de Community Hub.
• Wanneer eenmalige aanmelding met meervoudige verificatie wordt gebruikt, kunt u zich mogelijk niet aanmelden bij Community Hub vanuit CMPivot wanneer u Configuration Manager 2103 of eerder gebruikt.

CMPivot starten

1. Maak in de Configuration Manager-console verbinding met de primaire site of de CAS. Ga naar de werkruimte Activa en compliance en selecteer het knooppunt Apparaatverzamelingen . Selecteer een doelverzameling en selecteer CMPivot starten op het lint om het hulpprogramma te starten. Als u deze optie niet ziet, controleert u de volgende configuraties:

   • Bevestig bij een sitebeheerder of uw account over de vereiste machtigingen beschikt. Zie Vereisten voor meer informatie.

2. In de interface vindt u meer informatie over het gebruik van de tool.

   • Voer de queryreeksen handmatig bovenaan in of selecteer de koppelingen in de inlinedocumentatie.

   • Selecteer een van de entiteiten die u wilt toevoegen aan de queryreeks.

   • Via de koppelingen voor tabeloperatoren, aggregatiefuncties en scalaire functies kunt u taalverwijzingsdocumentatie openen in de webbrowser. CMPivot gebruikt de Kusto-querytaal (KQL).

3. Houd het CMPivot-venster open om resultaten van clients te bekijken. Wanneer u het CMPivot-venster sluit, is de sessie voltooid.

   • Als de query is verzonden, sturen clients nog steeds een statusbericht naar de server.

CMPivot gebruiken

Het CMPivot-venster bevat de volgende elementen:

1. De verzameling waarop CMPivot zich momenteel richt, bevindt zich in de titelbalk bovenaan en de statusbalk onder aan het venster. Bijvoorbeeld: 'PM_Team_Machines' in de bovenstaande schermafbeelding.

2. In het linkerdeelvenster worden de entiteiten weergegeven die beschikbaar zijn voor clients. Sommige entiteiten vertrouwen op WMI, terwijl andere PowerShell gebruiken om gegevens van clients op te halen.

   • Klik met de rechtermuisknop op een entiteit voor de volgende acties:

     • Invoegen: voeg de entiteit toe aan de query op de huidige cursorpositie. De query wordt niet automatisch uitgevoerd. Deze actie is de standaardactie wanneer u dubbelklikt op een entiteit. Gebruik deze actie wanneer u een query maakt.

     • Alle query's uitvoeren: voer een query uit voor deze entiteit inclusief alle eigenschappen. Gebruik deze actie om snel een query uit te voeren voor één entiteit.

     • Query op apparaat: voer een query uit voor deze entiteit en groepeer de resultaten. Bijvoorbeeld Disk | summarize dcount( Device ) by Name

   • Vouw een entiteit uit om specifieke eigenschappen te zien die beschikbaar zijn voor elke entiteit. Dubbelklik op een eigenschap om deze aan de query toe te voegen op de huidige cursorpositie.

3. Het tabblad Start bevat algemene informatie over CMPivot, inclusief koppelingen naar voorbeeldquery's en ondersteunende documentatie.

4. Op het tabblad Query worden het queryvenster, het resultatenvenster en de statusbalk weergegeven. In de bovenstaande schermafbeelding is het tabblad Query geselecteerd.

5. In het deelvenster Query kunt u een query maken of typen die u wilt uitvoeren op clients in de verzameling.

   • CMPivot gebruikt een subset van de Kusto-querytaal (KQL).

   • Inhoud in het querydeelvenster knippen, kopiëren of plakken.

   • Voor dit deelvenster wordt standaard IntelliSense gebruikt. Als u bijvoorbeeld begint te typen D, stelt IntelliSense alle entiteiten voor die met deze letter beginnen. Selecteer een optie en druk op Tab om deze in te voegen. Typ een sluisteken en een spatie | , waarna IntelliSense alle tabeloperatoren voorstelt. Voeg een spatie in summarize en typ deze. Alle aggregatiefuncties worden door IntelliSense voorgesteld. Selecteer het tabblad Start in CMPivot voor meer informatie over deze operators en functies.

   • Het deelvenster Query bevat ook de volgende opties:

     • Voer de query uit.

       • Als u de huidige CMPivot-query opnieuw wilt uitvoeren op de clients, houdt u Ctrl ingedrukt en klikt u op Uitvoeren.

     • Achteruit en vooruit gaan in de geschiedenislijst met query's.

     • Een verzameling met directe lidmaatschappen maken.

     • Exporteer de queryresultaten naar een CSV-bestand of het Klembord.

6. In het deelvenster Resultaten worden de gegevens weergegeven die door actieve clients voor de query worden geretourneerd.

   • De beschikbare kolommen variëren op basis van de entiteit en de query.

   • De kleurverzadiging van de gegevens in de resultatentabel of -grafiek geeft aan of de gegevens live zijn of afkomstig zijn van de laatste hardware-inventarisscan die in de sitedatabase is opgeslagen. Zwart zijn bijvoorbeeld realtimegegevens van een onlineclient, terwijl grijs gegevens in de cache zijn.

   • Selecteer een kolomnaam om de resultaten op die eigenschap te sorteren.

   • Klik met de rechtermuisknop op een kolomnaam om de resultaten te groeperen op dezelfde informatie in die kolom of om de resultaten te sorteren.

   • Klik met de rechtermuisknop op een apparaatnaam om de volgende aanvullende acties op het apparaat uit te voeren:

     • Draai naar: Query voor een andere entiteit op dit apparaat.

       • Vanaf versie 2006 is Pivot to vervangen door Device Pivot. Zie CMPivot-wijzigingen voor versie 2006 voor meer informatie.

     • Script uitvoeren: Start de wizard Script uitvoeren om een bestaand PowerShell-script op dit apparaat uit te voeren. Zie Een script uitvoeren voor meer informatie.

     • Afstandsbediening: start een sessie voor Extern beheer van Configuration Manager op dit apparaat. Zie Een Windows-clientcomputer op afstand beheren voor meer informatie.

     • Resource Explorer: Start Configuration Manager Resource Explorer voor dit apparaat. Zie Hardware-inventaris weergeven of Software-inventaris weergeven voor meer informatie.

   • Klik met de rechtermuisknop op een cel zonder apparaat om de volgende aanvullende acties uit te voeren:

     • Kopiëren: kopieer de tekst van de cel naar het klembord.

     • Apparaten weergeven met: Vraag een apparaat op met deze waarde voor deze eigenschap. Selecteer bijvoorbeeld op basis van de resultaten van de OS query de volgende optie in een cel in de rij Versie: OS | summarize countif( (Version == '10.0.17134') ) by Device | where (countif_ > 0)

     • Apparaten weergeven zonder: Query uitvoeren op apparaten zonder deze waarde voor deze eigenschap. Selecteer bijvoorbeeld op basis van de resultaten van de OS query de volgende optie in een cel in de rij Versie: OS | summarize countif( (Version == '10.0.17134') ) by Device | where (countif_ == 0) | project Device

     • Bing: Start de standaardwebbrowser met https://www.bing.com deze waarde als de queryreeks.

   • Selecteer een hyperlinktekst om de weergave te draaien voor die specifieke informatie.

   • In het resultatenvenster worden niet meer dan 20.000 rijen weergegeven. Pas de query aan om de gegevens verder te filteren of start CMPivot opnieuw op een kleinere verzameling.

7. Op de statusbalk wordt de volgende informatie weergegeven (van links naar rechts):

   • De status van de huidige query voor de doelverzameling. Deze status omvat:

     • Het aantal actieve clients dat de query heeft voltooid (3)

     • Het totale aantal klanten (5)

     • Het aantal offlineclients (2)

     • Alle clients die een fout (0) hebben geretourneerd

       Bijvoorbeeld:Query completed on 3 of 5 clients (2 clients offline and 0 failure)

   • De id van de clientbewerking. Bijvoorbeeld:id(16780221)

   • De huidige verzameling. Bijvoorbeeld:PM_Team_Machines

   • Het totale aantal rijen in het resultatenvenster. Bijvoorbeeld 1 objects

Query publiceren naar Community Hub vanuit CMPivot

(van toepassing op versie 2107 of hoger)

Vanaf versie 2107 kunt u een CMPivot-query rechtstreeks vanuit het CMPivot-venster publiceren naar de Community Hub. Door uw vragen rechtstreeks via CMPivot in te dienen, wordt het gemakkelijker om bij te dragen aan de Community Hub.

Je hebt de volgende vereisten nodig voor CMPivot en om bij te dragen aan de Community Hub:

• Voldoe aan alle CMPivot-vereisten en -machtigingen
• Community-hub inschakelen.
  • Installeer, indien nodig, de Microsoft Edge WebView2-extensie via de melding in de Configuration Manager-console.
• Een GitHub-account dat is gekoppeld aan Community Hub
  • U moet de uitnodiging accepteren die in de e-mail is verzonden, anders kunt u geen inhoud bijdragen.

1. Ga naar de werkruimte Activa en compliance en selecteer vervolgens het knooppunt Apparaatverzamelingen .

2. Selecteer een doelverzameling, doelapparaat of groep apparaten en selecteer vervolgens CMPivot starten op het lint om het hulpprogramma te starten.

3. Selecteer in het CMPivot-venster het pictogram van de Community Hub in het menu.

   

4. Selecteer Aanmelden en vervolgens aanmelden bij GitHub.

5. Maak een CMPivot-query en selecteer vervolgens Query uitvoeren om te controleren of deze werkt zoals verwacht.

   • Selecteer desgewenst het mappictogram om uw lijst met favorieten te openen en een query te gebruiken die u al hebt gemaakt.

6. Selecteer de koppeling Publiceren bovenaan het venster van de Community Hub van CMPivot wanneer u klaar bent om uw vraag in te dienen.

   

7. Geef uw query een naam en beschrijving en selecteer vervolgens de knop Publiceren om uw query naar de Community Hub te verzenden.

8. Zodra de bijdrage is voltooid, kunt u uw query op elk gewenst moment openen vanaf het tabblad Ik .

9. Als u de pull-aanvraag (PR) van GitHub wilt weergeven, gaat u naar https://github.com/Microsoft/configmgr-hub/pulls. U kunt de PR-koppeling ook openen vanaf de pagina Uw hub in het knooppunt Community hub .

   • PR's mogen niet rechtstreeks worden ingediend bij de GitHub-repository.

Voorbeeldscenario's voor CMPivot

De volgende secties bevatten voorbeelden van hoe u CMPivot in uw omgeving kunt gebruiken:

Voorbeeld 1: Een actieve service stoppen

De beveiligingsbeheerder vraagt u de Computer Browser-service zo snel mogelijk te stoppen en uit te schakelen op alle apparaten van de boekhoudafdeling. U start CMPivot op een verzameling voor alle apparaten in Boekhouding en selecteert Query uitvoeren op alle apparaten voor de service-entiteit .

Service

Wanneer de resultaten worden weergegeven, klikt u met de rechtermuisknop op de kolom Naam en selecteert u Groeperen op.

Service | summarize dcount( Device ) by Name

In de rij voor de browserservice selecteert u het nummer met de hyperlink in de kolom dcount_ .

Service | where (Name == 'Browser') | summarize count() by Device

U selecteert meerdere apparaten, klikt met de rechtermuisknop op de selectie en kiest Script uitvoeren. Met deze actie wordt de wizard Script uitvoeren gestart, waarmee u een bestaand script voor het stoppen en uitschakelen van een service uitvoert. Met CMPivot reageert u snel op het beveiligingsincident voor alle actieve computers en bekijkt u de resultaten in de wizard Script uitvoeren. Vervolgens maakt u een basislijn voor de configuratie waarmee u andere computers in de verzameling kunt herstellen zodra deze in de toekomst actief worden.

Voorbeeld 2: Proactief toepassingsfouten oplossen

Als u proactief wilt omgaan met operationeel onderhoud, voert u CMPivot eenmaal per week uit op een verzameling servers die u beheert en selecteert u Query all op de entiteit AppCrash . U klikt met de rechtermuisknop op de kolom Bestandsnaam en selecteert Oplopend sorteren. Eén apparaat retourneert elke dag zeven resultaten voor sqlsqm.exe met een tijdstempel rond 03:00 uur. U selecteert de bestandsnaam in een van de rijen, klikt er met de rechtermuisknop op en selecteert Bing It. Wanneer u in de zoekresultaten van de webbrowser bladert, vindt u een Microsoft-ondersteuningsartikel voor dit probleem met meer informatie en een oplossing.

Voorbeeld 3: BIOS-versie

Om speculatieve beveiligingslekken in kanalen aan de uitvoeringszijde te verhelpen, is een van de vereisten het bijwerken van het systeem-BIOS. U start met een query voor de BIOS-entiteit . Vervolgens groepeert u op de eigenschap Versie. Klik vervolgens met de rechtermuisknop op een specifieke waarde, zoals "LENOVO - 1140", en selecteer Apparaten weergeven met.

Bios | summarize countif( (Version == 'LENOVO - 1140') ) by Device | where (countif_ > 0)

Voorbeeld 4: Vrije schijfruimte

U moet een groot bestand tijdelijk opslaan op een netwerkbestandsserver, maar u weet niet zeker welke bestandsconfiguratie voldoende capaciteit heeft. Start CMPivot voor een verzameling bestandsservers en voer een query uit op de schijfentiteit . Wijzig de query voor CMPivot om snel een lijst met actieve servers met realtime-opslaggegevens te retourneren:

Disk | where (Description == 'Local Fixed Disk') | where isnotnull( FreeSpace ) | order by FreeSpace asc

CMPivot standalone

U kunt CMPivot als zelfstandige app gebruiken. CMPivot standalone is alleen beschikbaar in het Engels. Voer CMPivot buiten de Configuration Manager-console uit om de realtime status van apparaten in uw omgeving te bekijken. Deze wijziging maakt het mogelijk om CMPivot op een apparaat te gebruiken zonder eerst de console te installeren.

U kunt de kracht van CMPivot delen met andere persona's, zoals helpdesk- of beveiligingsbeheerders, die de console niet op hun computer hebben geïnstalleerd. Deze andere persona's kunnen CMPivot gebruiken om query's uit te voeren op Configuration Manager, naast de andere tools die ze traditioneel gebruiken. Door deze uitgebreide managementgegevens te delen, kunt u samenwerken om proactief bedrijfsproblemen op te lossen die roloverkoepelend zijn.

CMPivot standalone installeren

1. Stel de machtigingen in die nodig zijn om CMPivot uit te voeren. Zie vereisten voor meer informatie. U kunt ook de rol Beveiligingsbeheerder gebruiken als de machtigingen geschikt zijn voor de gebruiker.

2. Zoek het installatieprogramma van de CMPivot-app in het volgende pad: <site install path>\tools\CMPivot\CMPivot.msi. U kunt de taak uitvoeren vanaf dat pad of naar een andere locatie kopiëren.

3. Wanneer u de zelfstandige app CMPivot uitvoert, wordt u gevraagd om verbinding te maken met een site. Geef de volledig gekwalificeerde domeinnaam of computernaam van het centrale beheer of de primaire siteserver op.

   • Telkens wanneer u het zelfstandige CMPivot opent, wordt u gevraagd verbinding te maken met een siteserver.

4. Blader naar de verzameling waarin u CMPivot wilt uitvoeren en voer vervolgens uw query uit.

   

CMPivot binnen

CMPivot verzendt query's naar clients met behulp van het snelle kanaal van Configuration Manager. Dit communicatiekanaal van server tot client wordt ook gebruikt door andere functies, zoals clientmeldingsacties, clientstatus en Endpoint Protection. Clients retourneren resultaten via het vergelijkbare Quick State Message System. Statusberichten worden tijdelijk opgeslagen in de database. Zie het artikel Poorten voor meer informatie over de poorten die worden gebruikt voor clientmeldingen.

De query's en de resultaten zijn allemaal alleen maar tekst. De entiteiten InstallSoftware en Process retourneren enkele van de grootste resultaatsets. Tijdens het testen van de prestaties was de grootste grootte van staatsberichten van één client voor deze query's minder dan 1 kB. Geschaald naar een grote omgeving met 50.000 actieve clients, zou deze eenmalige query minder dan 50 MB aan gegevens genereren in het netwerk. Alle onderstreepte items op de welkomstpagina retourneren minder dan 1 KB aan informatie per klant.

Vanaf Configuration Manager 1810 kan CMPivot query's uitvoeren op hardware-inventarisgegevens, inclusief uitgebreide hardware-inventarisklassen. Deze nieuwe entiteiten (entiteiten die niet zijn onderstreept op de welkomstpagina) kunnen veel grotere gegevenssets retourneren, afhankelijk van de hoeveelheid gegevens die voor een bepaalde hardware-inventariseigenschap is gedefinieerd. De entiteit 'InstalledExecutable' kan bijvoorbeeld meerdere MB aan gegevens per client retourneren, afhankelijk van de specifieke gegevens waarop u de query uitvoert. Houd rekening met de prestaties en schaalbaarheid van uw systemen wanneer u grotere gegevenssets met hardware-inventaris retourneert uit grotere verzamelingen met behulp van CMPivot.

De tijd voor een query treedt na één uur op. Een collectie heeft bijvoorbeeld 500 apparaten en 450 van de clients zijn momenteel online. Deze actieve apparaten ontvangen de query en retourneren de resultaten vrijwel direct. Als u het CMPivot-venster open laat staan terwijl de andere 50 clients online komen, ontvangen ze ook de query en retourneren ze resultaten.

Logboekbestanden

CMPivot-interacties worden geregistreerd in de volgende logbestanden:

Op de server:

• SmsProv.log
• BgbServer.log
• StateSys.log

Clientzijde:

• CcmNotificationAgent.log
• Scripts.log
• StateMessage.log

Zie Logbestanden en Problemen met CMPivot oplossen voor meer informatie.

Volgende stappen

• Wijzigingen in CMPivot
• Problemen met CMPivot oplossen
• PowerShell-scripts maken en uitvoeren