Gäller för: Konfigurationshanteraren (aktuell gren)
Använd Windows PowerShell att hantera din Konfigurationshanteraren hierarki. Du kan använda PowerShell-skript för att automatisera eller utöka Konfigurationshanteraren liknar andra dokumenterade metoder med hjälp av WMI och C#. Mer information finns i Konfigurationshanteraren SDK.
Kör Konfigurationshanteraren-cmdlets och skript i PowerShell från Konfigurationshanteraren konsolen eller från en Windows PowerShell-session. När du kör Konfigurationshanteraren-cmdlets med Konfigurationshanteraren-konsolen körs sessionen automatiskt i platskontexten.
Anteckning
Alla versioner av den Konfigurationshanteraren för närvarande stöder Windows PowerShell version 5.1. Om du redan har installerat PowerShell version 7 kan du fortfarande använda PowerShell version 5.1. Mer information finns i Använda PowerShell 7 sida vid sida med Windows PowerShell 5.1.
Från och med version 2103 kräver ConfigurationManager PowerShell-modulen Microsoft .NET version 4.7.2 eller senare.
PowerShell från Konfigurationshanteraren konsolen
Den enklaste metoden för att öppna PowerShell är direkt från Konfigurationshanteraren konsolen.
Starta Konfigurationshanteraren konsolen. I det övre vänstra hörnet finns en blå rektangel. Välj den vita pilen i den blå rektangeln och välj Anslut via Windows PowerShell.
När Windows PowerShell har laddats visas en uppmaning som innehåller din webbplatskod. Om platskoden till exempel är "ABC" ser prompten ut så här: PS ABC:\>
Kontrollera att det fungerar med cmdleten Get-CMSite. Den här cmdleten returnerar information Konfigurationshanteraren den plats som du för närvarande är ansluten till och eventuella underordnade platser. Det kan till exempel vara platsservernamn, installationskatalog, platsnamn och version.
Anslut att Konfigurationshanteraren från en befintlig Windows PowerShell-session genom att läsa in Konfigurationshanteraren modulen manuellt.
Öppna en Windows PowerShell session från Start-menyn.
Importera Konfigurationshanteraren modulen med hjälp av cmdleten Import-Module. Ange sökvägen till Konfigurationshanteraren modulen eller ändra till den katalog som innehåller modulen. Som standard finns modulen på följande sökväg: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\ConfigurationManager.psd1
Viktigt
Den här sökvägen ändrades från och med version 1910 för att använda Microsoft Endpoint Manager mappen . Se till att du inte importerar en äldre version av modulen som kan finnas i en annan mapp. När du har importerat modulen använder du följande kommandon för att kontrollera modulversionen och sökvägen:
När du startar PowerShell från -konsolen skapas automatiskt PSDrive för den plats som är ansluten. Om du är i en hierarki använder du New-PSDrive för att skapa enheter för varje plats.
Om du vill Konfigurationshanteraren-cmdletarna måste du växla sökvägen till Konfigurationshanteraren platsen. I följande exempel är platskoden ABC :
Set-Location ABC:
Bekräfta att PowerShell har läst Konfigurationshanteraren modulen med hjälp av cmdleten Get-CMSite.
Uppdatera hjälp
Från och med version 2010 använder du cmdleten Update-Help för att hämta den senaste informationen för Konfigurationshanteraren PowerShell-modulen. Det här innehållet är detsamma som det som publiceras på docs.microsoft.com för ConfigurationManager-modulen.
Viktigt
På grund av en ändring i hur det uppdateringsbara innehållet struktureras och publiceras med version 2103 bör du inte använda Update-Help på en webbplats för version 2010. Uppdatera platsen till version 2103 och uppdatera sedan det lokala hjälpinnehållet.
Datorn där du kör den här cmdleten behöver Internetåtkomst, särskilt pshelpprod.blob.core.windows.net . Kör sedan följande kommando från en upphöjd PowerShell-session:
Update-Help -Module ConfigurationManager
När du har uppdaterat Konfigurationshanteraren cmdlet-hjälpen kan du få hjälp om cmdletarna med hjälp av cmdleten Get-Help. Ett exempel:
Från och med version 2010 stöder Konfigurationshanteraren PowerShell-cmdlet-biblioteket PowerShell version 7. Mer information om PowerShell 7, inklusive anvisningar om hur du laddar ned och installerar det, finns i Installera PowerShell på Windows.
Tips
PowerShell 7 körs som pwsh.exe . Tidigare versioner av PowerShell körs som powershell.exe .
Cmdlets som inte stöder PowerShell version 7
Följande cmdlets stöder inte PowerShell 7:
Import-CMPackage
Import-CMDriverPackage
Import-CMTaskSequence
Export-CMPackage
Export-CMDriverPackage
Export-CMTaskSequence
De kräver .NET Framework stället för .NET Core som används med PowerShell version 7.
Från och med version 2103 misslyckas de med följande fel om du försöker använda dessa cmdlets i en PowerShell version 7-session: This cmdlet only supports the ".NET Framework" runtime.
Kända problem med PowerShell version 7
Du kan inte starta PowerShell 7 direkt från Konfigurationshanteraren konsolen. Starta PowerShell 7 manuellt och importera sedan Konfigurationshanteraren modulen.
Om du har feedback om Konfigurationshanteraren PowerShell-cmdlets använder du samma alternativ i Konfigurationshanteraren konsolen för att skicka feedback. Mer information finns i Produktfeedback.
När du skickar en bägare ska du inkludera följande ytterligare information som är specifik för PowerShell:
Det exakta skript eller kommandosyntax som du använde så att Microsoft kan försöka återskapa problemet.
Vilket beteende du förväntade dig jämfört med det faktiska beteendet.
Fullständiga utdata när du kör den med den utförliga gemensamma parametern.
Version och sökväg för ConfigurationManager-modulen. Ta till exempel med utdata från följande kommandon:
Om en cmdlet returnerar ett fel använder du följande kommando för att hämta undantagsinformation:
$Error[0].Exception | Format-List * -Force
Förhandsversion av information
Artikeln om funktioner i den tekniska förhandsversionen i kärndokumentationsbiblioteket innehåller viktig information för PowerShell. Se till exempel Technical preview version 2106.
Nästa steg
Om du vill ha mer information om vad som har ändrats i den senaste versionen Konfigurationshanteraren du den senaste viktig information från innehållsförteckningen.
Den här utbildningsvägen introducerar dig för Windows PowerShell och ger en översikt över produktens funktioner. Den förklarar hur du öppnar och konfigurerar Windows PowerShell, kör kommandon och använder det inbyggda hjälpsystemet.
Demonstrate the use of Microsoft Power Platform solutions to simplify, automate, and empower business processes for organizations in the role of a Functional Consultant.