Kom igång med Konfigurationshanteraren-cmdlets

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 2010 stöder Konfigurationshanteraren PowerShell-cmdlet-biblioteket PowerShell 7. Mer information finns i Support for PowerShell version 7 (Stöd för PowerShell version 7).

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.

1. 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.

2. 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:\>

3. 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.

Importera Konfigurationshanteraren PowerShell-modulen

Anslut att Konfigurationshanteraren från en befintlig Windows PowerShell-session genom att läsa in Konfigurationshanteraren modulen manuellt.

1. Öppna en Windows PowerShell session från Start-menyn.

2. 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:

   (Get-Module -Name ConfigurationManager).Version
   (Get-Module -Name ConfigurationManager).Path
   

   Följande exempel ändras till modulens katalog och importerar den sedan:

   Set-Location 'C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin'
   Import-Module .\ConfigurationManager.psd1
   

   Tips

   Du kan också använda SMS_ADMIN_UI_PATH miljövariabeln. Ett exempel:

   Set-Location "$env:SMS_ADMIN_UI_PATH\..\"
   

   Du kan också använda cd-aliaset för att ändra kataloger i stället för cmdleten Set-Location.

3. Om det är första gången du importerar Konfigurationshanteraren modulen på den här datorn kan du behöva skapa platsenheten. Ett exempel:

   New-PSDrive -Name "ABC" -PSProvider "AdminUI.PS.Provider\CMSite" -Root "siteserver.contoso.com" -Description "Primary site"
   

   Tips

   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.

4. 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:
   

5. 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.

Mer information finns i Viktig information för PowerShell version 2103.

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:

Get-Help Get-CMDevice
Get-Help Get-CMDevice -Examples
Get-Help Get-CMDevice -Parameter *

Mer information finns i följande PowerShell-blogginlägg: You've got Help!.

Vanliga parametrar

Alla Konfigurationshanteraren cmdlets stöder vanliga PowerShell-parametrar:

• Felsöka
• ErrorAction
• ErrorVariable
• InformationAction
• InformationVariable
• OutVariable
• OutBuffer
• PipelineVariable
• Verbose
• WarningAction
• WarningVariable

Mer information finns i about_CommonParameters.

Stöd för PowerShell version 7

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.

• Det aktuella stödet gäller endast för Konfigurationshanteraren cmdlets. Andra funktioner i Konfigurationshanteraren som förlitar sig på PowerShell kanske inte stöder version 7. Du kan till exempel köra skript, CMPivoteller aktivitetssekvenssteget Kör PowerShell-skript.

Feedback för PowerShell

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:

  (Get-Module -Name ConfigurationManager).Version
  (Get-Module -Name ConfigurationManager).Path
  

• 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.

Mer information om enskilda cmdlet:ar finns i Konfigurationshanteraren cmdlet-referensen.

Mer information om hur du lär dig och kommer igång med Windows PowerShell finns i PowerShell 101.