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


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

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.

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

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

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

  1. Nyisson meg Windows PowerShell munkamenetet a Start menü.

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

    (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:

    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:

    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.

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

    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.

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

    Set-Location ABC:
    
  5. 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:

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:

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

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:

    (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:

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