Első lépések a Konfigurációkezelő parancsmagokkal

Cikk
2021. 08. 11.

A következőkre vonatkozik: Konfigurációkezelő (aktuális ág)

A Windows PowerShell kezelheti a Konfigurációkezelő hierarchiáját. A WMI és a C# használatával PowerShell-szkriptekkel automatizálhatja vagy kibővítheti Konfigurációkezelő más dokumentált megközelítésekhez hasonló módon. További információ: Konfigurációkezelő SDK.

Futtassa Konfigurációkezelő parancsmagokat és szkripteket a PowerShellben a Konfigurációkezelő konzolról vagy egy Windows PowerShell munkamenetből. Ha a Konfigurációkezelő parancsmagokat a Konfigurációkezelő konzol használatával futtatja, a munkamenet automatikusan a hely környezetében fut.

Megjegyzés

Az aktuális ág összes jelenleg Konfigurációkezelő verziója támogatja Windows PowerShell 5.1-es verziót. Ha már telepítette a PowerShell 7-es verzióját, továbbra is használhatja a PowerShell 5.1-es verzióját. További információ: A PowerShell 7 és az 5.1-es Windows PowerShell használata.

A 2010-es verziótól kezdődően a Konfigurációkezelő PowerShell-parancsmagtár támogatja a PowerShell 7-et. További információ: A PowerShell 7-es verziójának támogatása.

A 2103-as verziótól kezdődően a ConfigurationManager PowerShell-modulhoz Microsoft .NET 4.7.2-es vagy újabb verzió szükséges.

PowerShell a Konfigurációkezelő konzolról

A PowerShell megnyitásának legegyszerűbb módja közvetlenül a Konfigurációkezelő konzolról.

Indítsa el a Konfigurációkezelő konzolt. A bal felső sarokban egy kék téglalap látható. Válassza a kék téglalapban lévő fehér nyilat, majd Csatlakozás a Windows PowerShell.
A Windows PowerShell után adatokat fog látni, amely a helykódot tartalmazza. Ha például a helykód "ABC", a parancssor a következő lesz: PS ABC:\>
A működését a Get-CMSite parancsmag használatával ellenőrizheti. Ez a parancsmag információt ad vissza Konfigurációkezelő aktuálisan csatlakoztatott helyről és az összes gyermekhelyről. Ilyen például a helykiszolgáló neve, a telepítési könyvtár, a hely neve és a verzió.

Az Konfigurációkezelő PowerShell-modul importálása

Csatlakozás meglévő Konfigurációkezelő Windows PowerShell munkamenetből való Windows PowerShell manuálisan kell betöltenie a Konfigurációkezelő modult.

Nyisson meg Windows PowerShell munkamenetet a Start menü.
Importálja Konfigurációkezelő modult az Import-Module parancsmag használatával. Adja meg a modul Konfigurációkezelő elérési útját, vagy váltsa át a modult tartalmazó könyvtárra. Alapértelmezés szerint a modul a következő elérési úton található: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\ConfigurationManager.psd1
Fontos

Ez az elérési út az 1910-es verziótól kezdve a mappa használatára Microsoft Endpoint Manager módosult. Győződjön meg arról, hogy nem importálja a modul egy régebbi verzióját, amely esetleg egy másik mappában is létezik. A modul importálása után a következő parancsokkal ellenőrizze a modul verzióját és elérési útját:

PowerShell
```
(Get-Module -Name ConfigurationManager).Version
(Get-Module -Name ConfigurationManager).Path
```
Az alábbi példa módosítja a modul könyvtárát, majd importálja azt:

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

A környezeti változót SMS_ADMIN_UI_PATH is használhatja. Például:

PowerShell
```
Set-Location "$env:SMS_ADMIN_UI_PATH\..\"
```
A CD-alias használatával a Set-Location parancsmag helyett a könyvtárakat is módosíthatja.
Ha első alkalommal importálja a Konfigurációkezelő modult ezen a számítógépen, előfordulhat, hogy létre kell hoznia a hely meghajtóját. Például:

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

Amikor elindítja a PowerShellt a konzolról, az automatikusan létrehozza a PSDrive-ot az aktuálisan csatlakoztatott hely kényelme érdekében. Ha hierarchiában van, a New-PSDrive segítségével hozzon létre meghajtókat minden helyhez.
A Konfigurációkezelő parancsmagok futtatásához át kell váltania az elérési utat a Konfigurációkezelő helyére. A következő példában a helykód ABC a következő:

PowerShell
```
Set-Location ABC:
```
A Get-CMSite parancsmag használatával ellenőrizze, hogy a PowerShell megfelelően Konfigurációkezelő-e a Konfigurációkezelő modult.

Súgó frissítése

A 2010-es verziótól kezdődően az Update-Help parancsmag használatával lekért Konfigurációkezelő PowerShell-modul legfrissebb információit. Ez a tartalom megegyezik a ConfigurationManagermodul docs.microsoft.com közzétett tartalommal.

Fontos

A frissíthető tartalom strukturálható és a 2103-as verzió kiadásával való közzététele miatt ne használja az Update-Helpt a 2010-es verziójú webhelyen. Frissítse a webhelyet a 2103-as verzióra, majd frissítse a helyi súgótartalmat.

További információ: A PowerShell 2103-as verziójának kibocsátási megjegyzései.

A parancsmagot futtató számítógépnek internet-hozzáférésre van szüksége, pontosabban pshelpprod.blob.core.windows.net a következőre: . Ezután futtassa a következő parancsot egy emelt szintű PowerShell-munkamenetből:

PowerShell

Update-Help -Module ConfigurationManager

A parancsmag Konfigurációkezelő frissítése után a Get-Help parancsmag használatával segítséget kaphat a parancsmagokkal kapcsolatban. Például:

PowerShell

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

További információt a következő PowerShell-blogbejegyzésben talál: You've got Help!.

Gyakori paraméterek

Minden Konfigurációkezelő parancsmag támogatja a gyakori PowerShell-paramétereket:

Hibakeresés
ErrorAction
ErrorVariable (Hibaválható)
InformationAction
InformationVariable (Információválható)
OutVariable (Nem állítható be)
OutBuffer (Hibakeresés)
PipelineVariable (Folyamatválható)
Részletes
WarningAction
WarningVariable (Figyelmeztetésválható)

További információ: about_CommonParameters.

A PowerShell 7-es verziójának támogatása

A 2010-es verziótól kezdődően a Konfigurációkezelő PowerShell-parancsmagtár támogatja a PowerShell 7-es verzióját. További információ a PowerShell 7-ről, beleértve a letöltésére és telepítésére vonatkozó utasításokat: A PowerShell telepítése a Windows.

Tipp.

A PowerShell 7 a következőként fut: pwsh.exe . A PowerShell korábbi verziói a következőként futnak: powershell.exe .

A PowerShell 7-es verzióját nem támogató parancsmagok

A következő parancsmagok nem támogatják a PowerShell 7-et:

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

A PowerShell 7.NET-keretrendszer verziójával használt .NET Core helyett a parancssori verziót igénylik.

Ha a 2103-as verziótól kezdve ezeket a parancsmagokat egy 7-es verziójú PowerShell-munkamenetben próbálja használni, a következő hibaüzenet jelenik meg: This cmdlet only supports the ".NET Framework" runtime.

A PowerShell 7-es verziójának ismert problémái

A PowerShell 7 nem indíthető el közvetlenül a Konfigurációkezelő konzolról. Indítsa el manuálisan a PowerShell 7-et, majd importálja Konfigurációkezelő modult.
Jelenleg csak a Konfigurációkezelő támogatása támogatott. Előfordulhat, hogy Konfigurációkezelő PowerShellre támaszkodó egyéb funkciói nem támogatják a 7-es verziót. Ilyen például a Parancsfájlok futtatása, a CMPivotvagy a PowerShell-parancsfájl futtatása feladatütemezési lépés.

Visszajelzés a PowerShell-ről

Ha visszajelzést szeretne küldeni a Konfigurációkezelő PowerShell-parancsmagokkal kapcsolatban, használja ugyanezeket a beállításokat a Konfigurációkezelő konzolon is. További információ: Termékkel kapcsolatos visszajelzés.

Rosszalkodás esetén a PowerShellre vonatkozó további információkat is meg kell küldenie:

A pontos szkript- vagy parancsszintaxis, amely segítségével a Microsoft megpróbálhatja reprodukálni a problémát.
Milyen viselkedést várt a tényleges viselkedéshez képest?
A teljes kimenetet futtatja a Verbose közös paraméterrel.
A ConfigurationManager modul verziója és elérési útja. Például foglalja bele a következő parancsok kimenetét:

PowerShell
```
(Get-Module -Name ConfigurationManager).Version
(Get-Module -Name ConfigurationManager).Path
```
Ha egy parancsmag hibát ad vissza, a következő paranccsal lekért kivétel részletei:

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

Előzetes kiadási megjegyzések

Az alapdokumentációtár technikai előzetes funkciókkal kapcsolatos cikke a PowerShell kibocsátási megjegyzéseit tartalmazza. Lásd például a Technical Preview 2106-os verzióját.

Következő lépések

A legújabb kiadásban történt változásokkal kapcsolatos további Konfigurációkezelő a tartalomjegyzékben válassza a legújabb kibocsátási megjegyzéseket.

További információ az egyes parancsmagokkal kapcsolatban: Konfigurációkezelő parancsmagok referenciája.

További információ a powershell 101Windows PowerShell való tanulásról és az első lépésekről.

Megosztás a következőn keresztül: