Začínáme s rutinami Configuration Manager

Článek
08/11/2021

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.

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

otevřete Windows PowerShell relaci z nabídka Start.
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 .
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.
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:
```
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

PowerShell 7 nemůžete spustit přímo z konzoly Configuration Manager. Ručně spusťte PowerShell 7 a pak Importujte modul Configuration Manager.
Aktuální podpora je určena pouze pro rutiny Configuration Manager. Jiné funkce Configuration Manager, které spoléhají na prostředí PowerShell, nemusí podporovat verzi 7. Například spusťte skripty, CMPivotnebo krok pořadí úkolů Spustit skript prostředí PowerShell .

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.

Sdílet prostřednictvím