Začínáme s rutinami Configuration Manager

Platí pro: Configuration Manager (Current Branch)

pomocí Windows PowerShell můžete spravovat Configuration Manager hierarchii. Skripty PowerShellu můžete použít k automatizaci nebo rozšiřování Configuration Manager podobných jiným dokumentovaným přístupům pomocí rozhraní WMI a jazyka C#. Další informace najdete v tématu Configuration Manager SDK.

spouštějte rutiny Configuration Manager a skripty v powershellu z konzoly Configuration Manager nebo z relace Windows PowerShell. Když spustíte rutiny Configuration Manager pomocí konzoly Configuration Manager, vaše relace se automaticky spustí v kontextu lokality.

Poznámka

všechny aktuálně podporované verze Configuration Manager podporují aktuální větev Windows PowerShell verze 5,1. Pokud jste už nainstalovali PowerShell verze 7, můžete i nadále používat PowerShell verze 5,1. další informace najdete v tématu použití powershellu 7 vedle sebe s Windows PowerShell 5,1.

Počínaje verzí 2010 podporuje knihovna rutin Configuration Manager PowerShellu PowerShell 7. Další informace najdete v tématu Podpora PowerShellu verze 7.

Počínaje verzí 2103 modul ConfigurationManager PowerShell vyžaduje Microsoft .NET verze 4.7.2 nebo novější.

PowerShell z konzoly Configuration Manager

Nejjednodušší způsob, jak otevřít PowerShell, je přímo z konzoly Configuration Manager.

  1. Spusťte konzolu Configuration Manager. V levém horním rohu je modrý obdélník. vyberte bílou šipku v modrém obdélníku a zvolte Připojení přes Windows PowerShell.

  2. po načtení Windows PowerShell se zobrazí výzva, která obsahuje kód vašeho webu. Například pokud je kód lokality "ABC", výzva vypadá takto: PS ABC:\>

  3. K ověření funguje pomocí rutiny Get-CMSite . Tato rutina vrací informace o Configuration Manager lokalitě, ke které jste aktuálně připojeni, a k jakýmkoli podřízeným webům. Například název serveru lokality, režisér instalace, název lokality a verze.

Import modulu Configuration Manager PowerShell

Připojení Configuration Manager z existující relace Windows PowerShell ručním načítáním modulu Configuration Manager.

  1. otevřete Windows PowerShell relaci z nabídka Start.

  2. Importujte modul Configuration Manager pomocí rutiny Import-Module . Zadejte cestu k modulu Configuration Manager nebo přejděte do adresáře, který obsahuje modul. Ve výchozím nastavení je modul v následující cestě: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\ConfigurationManager.psd1

    Důležité

    Tato cesta se od verze 1910 změnila tak, aby používala Microsoft Endpoint Manager složku. Ujistěte se, že neimportujete starší verzi modulu, která může existovat v jiné složce. Po importu modulu pomocí následujících příkazů ověřte verzi modulu a cestu:

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

    Následující příklad změní adresář modulu a pak ho importuje:

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

    Tip

    Můžete také použít proměnnou prostředí SMS_ADMIN_UI_PATH . Například:

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

    Také můžete použít alias CD pro změnu adresářů místo rutiny set-Location .

  3. Pokud se modul Configuration Manager v tomto počítači poprvé importuje, možná budete muset vytvořit jednotku webu. Například:

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

    Tip

    Když spustíte PowerShell z konzoly nástroje, automaticky se vytvoří PSDrive jako pohodlí pro aktuálně připojenou lokalitu. Pokud jste v hierarchii, pomocí New-psdrive vytvořte jednotky pro každou lokalitu.

  4. Chcete-li spustit rutiny Configuration Manager, je nutné přepnout cestu k webu Configuration Manager. V následujícím příkladu je kód lokality ABC :

    Set-Location ABC:
    
  5. Pomocí rutiny Get-CMSite ověřte, že PowerShell správně načetl modul Configuration Manager.

Aktualizovat Help

Od verze 2010 získáte nejnovější informace o modulu Configuration Manager PowerShellu pomocí rutiny Update-Help . Tento obsah je stejný jako ten, který je publikovaný v docs.microsoft.com pro modul ConfigurationManager.

Důležité

Kvůli změně v tom, jak je aktualizovatelný obsah strukturovaný a publikovaný s vydáním verze 2103, nepoužívejte Update-Help na webu verze 2010. Aktualizujte lokalitu na verzi 2103 a pak aktualizujte místní obsah.

Další informace najdete v poznámkách k verzi pro PowerShell verze 2103.

Počítač, na kterém spouštíte tuto rutinu, potřebuje přístup k Internetu, konkrétně pshelpprod.blob.core.windows.net . Pak z relace PowerShellu se zvýšenými oprávněními spusťte následující příkaz:

Update-Help -Module ConfigurationManager

Po aktualizaci pomoci rutiny Configuration Manager můžete získat nápovědu k rutinám pomocí rutiny Get-Help . Například:

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

Další informace najdete v tomto blogovém příspěvku o PowerShellu: máte nápovědu.

Společné parametry

Všechny rutiny Configuration Manager podporují společné parametry prostředí PowerShell:

  • Ladění
  • ErrorAction
  • ErrorVariable
  • InformationAction
  • InformationVariable
  • OutVariable
  • OutBuffer
  • PipelineVariable
  • Verbose
  • WarningAction
  • WarningVariable

Další informace najdete v tématu about_CommonParameters.

Podpora pro PowerShell verze 7

Počínaje verzí 2010 podporuje knihovna rutin Configuration Manager PowerShellu verzi 7 pro PowerShell. Další informace o PowerShellu 7, včetně pokynů ke stažení a instalaci, najdete v tématu instalace PowerShellu na Windows.

Tip

PowerShell 7 se spustí jako pwsh.exe . Starší verze PowerShellu se spouštějí jako powershell.exe .

Rutiny, které nepodporují PowerShell verze 7

Následující rutiny nepodporují PowerShell 7:

  • Import-CMPackage
  • Import-CMDriverPackage
  • Import-CMTaskSequence
  • Export-CMPackage
  • Export-CMDriverPackage
  • Export-CMTaskSequence

místo rozhraní .net Core, které se používá s prostředím PowerShell verze 7, vyžadují .NET Framework.

Pokud se verze 2103 pokusíte použít tyto rutiny v relaci prostředí PowerShell verze 7, dojde k jejich selhání s následující chybou: This cmdlet only supports the ".NET Framework" runtime.

Známé problémy s prostředím PowerShell verze 7

Zpětná vazba pro PowerShell

Pokud máte zpětnou vazbu k rutinám Configuration Manager PowerShellu, použijte stejné možnosti v konzole Configuration Manager k odeslání zpětné vazby. Další informace najdete v tématu o zpětné vazbě produktu.

Když odesíláte zamračení, zahrňte do PowerShellu následující další informace, které jsou specifické pro:

  • Přesný skript nebo syntaxe příkazu, který jste použili, aby se Microsoft mohl pokusit o reprodukování problému.

  • Jaké chování jste očekávali v porovnání se skutečným chováním.

  • Úplný výstup, když ho spustíte s parametrem verbose Common.

  • Verze a cesta k modulu ConfigurationManager Například zahrňte výstup následujících příkazů:

    (Get-Module -Name ConfigurationManager).Version
    (Get-Module -Name ConfigurationManager).Path
    
  • Pokud rutina vrátí chybu, použijte následující příkaz pro získání podrobností o výjimce:

    $Error[0].Exception | Format-List * -Force
    

Zpráva k vydání verze Preview

Článek s funkcemi Technical Preview v základní knihovně dokumentace obsahuje poznámky k verzi pro PowerShell. Podívejte se například na verzi Technical preview 2106.

Další kroky

Pokud chcete získat další informace o tom, co se změnilo v nejnovější verzi Configuration Manager, vyberte z obsahu nejnovější poznámky k verzi .

Další informace o jednotlivých rutinách najdete v tématu Configuration Manager Reference k rutinám.

další informace o studiu a začínáme s Windows PowerShell najdete v tématu PowerShell 101.