Wprowadzenie do Configuration Manager poleceń cmdletGet started with Configuration Manager cmdlets

Dotyczy: Configuration Manager (Current Branch)Applies to: Configuration Manager (current branch)

Zarządzanie hierarchią Configuration Manager przy użyciu programu Windows PowerShell.Use Windows PowerShell to manage your Configuration Manager hierarchy. Za pomocą skryptów programu PowerShell można zautomatyzować lub zwiększyć Configuration Manager podobne do innych udokumentowanych metod za pomocą usługi WMI i języka C#.You can use PowerShell scripts to automate or extend Configuration Manager similar to other documented approaches using WMI and C#. Aby uzyskać więcej informacji, zobacz Configuration Manager SDK.For more information, see Configuration Manager SDK.

Uruchamianie Configuration Manager poleceń cmdlet i skryptów w programie PowerShell z poziomu konsoli Configuration Manager lub z sesji programu Windows PowerShell.Run Configuration Manager cmdlets and scripts in PowerShell from the Configuration Manager console or from a Windows PowerShell session. Po uruchomieniu Configuration Manager polecenia cmdlet przy użyciu konsoli Configuration Manager, sesja zostanie automatycznie uruchomiona w kontekście lokacji.When you run Configuration Manager cmdlets by using the Configuration Manager console, your session automatically runs in the context of the site.

Uwaga

Wszystkie obecnie obsługiwane wersje programu Configuration Manager Current Branch obsługują program Windows PowerShell w wersji 5,1.All currently supported versions of Configuration Manager current branch support Windows PowerShell version 5.1. Jeśli zainstalowano już program PowerShell w wersji 7, można nadal używać programu PowerShell w wersji 5,1.If you've already installed PowerShell version 7, you can still use PowerShell version 5.1. Aby uzyskać więcej informacji, zobacz Korzystanie z programu PowerShell 7 obok siebie przy użyciu programu Windows PowerShell 5,1.For more information, see Using PowerShell 7 side-by-side with Windows PowerShell 5.1.

Począwszy od wersji 2010, Biblioteka poleceń cmdlet programu Configuration Manager PowerShell obsługuje program PowerShell 7.Starting in version 2010, the Configuration Manager PowerShell cmdlet library supports PowerShell 7. Aby uzyskać więcej informacji, zobacz Obsługa programu PowerShell w wersji 7.For more information, see Support for PowerShell version 7.

Program PowerShell z poziomu konsoli Configuration ManagerPowerShell from the Configuration Manager console

Najprostsza metoda otwierania programu PowerShell jest bezpośrednio z konsoli Configuration Manager.The easiest method to open PowerShell is directly from the Configuration Manager console.

  1. Uruchom konsolę Configuration Manager.Launch the Configuration Manager console. W lewym górnym rogu znajduje się niebieski prostokąt.In the upper-left corner, there's a blue rectangle. Wybierz strzałkę w niebieskie prostokąt, a następnie wybierz pozycję Połącz za pośrednictwem programu Windows PowerShell.Select the white arrow in the blue rectangle, and choose Connect via Windows PowerShell.

  2. Po załadowaniu programu Windows PowerShell zostanie wyświetlony monit zawierający kod lokacji.After Windows PowerShell loads, you'll see a prompt that contains your site code. Na przykład, jeśli kod lokacji to "ABC", monit wygląda następująco: PS ABC:\>For example, if the site code is "ABC", the prompt looks like: PS ABC:\>

  3. Aby sprawdzić działanie, użyj polecenia cmdlet Get-CMSite .To verify it works, use the Get-CMSite cmdlet. To polecenie cmdlet zwraca informacje o lokacji Configuration Manager, z którą obecnie jest nawiązane połączenie, oraz o wszystkich lokacjach podrzędnych.This cmdlet returns information about the Configuration Manager site you're currently connected to and any child sites. Na przykład nazwa serwera lokacji, dyrektor instalacji, Nazwa lokacji i wersja.For example, the site server name, installation director, site name, and version.

Importowanie modułu Configuration Manager PowerShellImport the Configuration Manager PowerShell module

Połącz się z Configuration Manager z istniejącej sesji programu Windows PowerShell, ręcznie ładując moduł Configuration Manager.Connect to Configuration Manager from an existing Windows PowerShell session by manually loading the Configuration Manager module.

  1. Otwórz sesję programu Windows PowerShell z menu Start.Open a Windows PowerShell session from the Start menu.

  2. Zaimportuj moduł Configuration Manager za pomocą polecenia cmdlet Import-Module .Import the Configuration Manager module by using the Import-Module cmdlet. Określ ścieżkę do modułu Configuration Manager lub przejdź do katalogu, który zawiera moduł.Specify the path to the Configuration Manager module, or change to the directory that contains the module. Domyślnie moduł znajduje się w następującej ścieżce: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\ConfigurationManager.psd1By default, the module is at the following path: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\ConfigurationManager.psd1

    Ważne

    Ta ścieżka została zmieniona począwszy od wersji 1910, aby można było użyć tego Microsoft Endpoint Manager folderu.This path changed starting in version 1910 to use the Microsoft Endpoint Manager folder. Upewnij się, że nie zaimportowano starszej wersji modułu, która może istnieć w innym folderze.Make sure you don't import an older version of the module that might exist in another folder. Po zaimportowaniu modułu Użyj następujących poleceń, aby sprawdzić wersję i ścieżkę modułu:After you import the module, use the following commands to check the module version and path:

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

    Poniższy przykład zmienia katalog modułu, a następnie importuje go:The following example changes to the module's directory and then imports it:

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

    Porada

    Można również użyć zmiennej środowiskowej SMS_ADMIN_UI_PATH .You can also use the SMS_ADMIN_UI_PATH environment variable. Na przykład:For example:

    Set-Location $env:SMS_ADMIN_UI_PATH\..\
    

    Ponadto można użyć aliasu CD , aby zmienić katalogi zamiast polecenia cmdlet Set-Location .Also, you can use the cd alias to change directories instead of the Set-Location cmdlet.

  3. Jeśli po raz pierwszy zaimportowano moduł Configuration Manager na tym komputerze, może być konieczne utworzenie dysku lokacji.If it's the first time importing the Configuration Manager module on this computer, you may need to create the site drive. Na przykład:For example:

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

    Porada

    Po uruchomieniu programu PowerShell z konsoli programu Program automatycznie tworzy PSDrive jako wygodę dla aktualnie podłączonej lokacji.When you start PowerShell from the console, it automatically creates the PSDrive as a convenience for the currently connected site. Jeśli jesteś w hierarchii, użyj polecenie New-PSDrive , aby utworzyć dyski dla każdej lokacji.If you're in a hierarchy, use New-PSDrive to create drives for each site.

  4. Aby uruchomić Configuration Manager polecenia cmdlet, należy przełączyć ścieżkę do witryny Configuration Manager.To run the Configuration Manager cmdlets, you need to switch the path to the Configuration Manager site. W poniższym przykładzie kod lokacji to ABC :In the following example, the site code is ABC:

    Set-Location ABC:
    
  5. Upewnij się, że program PowerShell prawidłowo załadował moduł Configuration Manager za pomocą polecenia cmdlet Get-CMSite .Confirm that PowerShell properly loaded the Configuration Manager module by using the Get-CMSite cmdlet.

Pomoc dotycząca aktualizacjiUpdate help

Począwszy od wersji 2010, aby uzyskać najnowsze informacje dotyczące modułu Configuration Manager PowerShell, użyj polecenia cmdlet Update-help .Starting in version 2010, to get the latest information for the Configuration Manager PowerShell module, use the Update-Help cmdlet. Ta zawartość jest taka sama jak opublikowana w usłudze docs.microsoft.com dla modułu ConfigurationManager.This content is the same as what's published on docs.microsoft.com for the ConfigurationManager module.

Komputer, na którym uruchamiasz to polecenie cmdlet, musi mieć dostęp do Internetu, w odniesieniu do tego pshelpprod.blob.core.windows.net .The computer on which you run this cmdlet needs internet access, specifically pshelpprod.blob.core.windows.net. Uruchom następujące polecenie:Then run the following command:

Update-Help –Module ConfigurationManager

Po zaktualizowaniu pomocy polecenia cmdlet Configuration Manager można uzyskać pomoc dotyczącą poleceń cmdlet za pomocą polecenia cmdlet Get-Help .After you update the Configuration Manager cmdlet help, you can get help about the cmdlets by using the Get-Help cmdlet. Na przykład:For example:

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

Aby uzyskać więcej informacji, zobacz następujący wpis w blogu programu PowerShell: masz Pomoc.For more information, see the following PowerShell blog post: You've got Help!.

Parametry wspólneCommon parameters

Wszystkie polecenia cmdlet Configuration Manager obsługują typowe parametry programu PowerShell:All Configuration Manager cmdlets support the common PowerShell parameters:

  • DebugowanieDebug
  • ErrorActionErrorAction
  • ErrorVariableErrorVariable
  • InformationActionInformationAction
  • InformationVariableInformationVariable
  • OutVariableOutVariable
  • OutBufferOutBuffer
  • PipelineVariablePipelineVariable
  • PełnyVerbose
  • WarningActionWarningAction
  • WarningVariableWarningVariable

Aby uzyskać więcej informacji, zobacz about_CommonParameters.For more information, see about_CommonParameters.

Obsługa programu PowerShell w wersji 7Support for PowerShell version 7

Począwszy od wersji 2010, Biblioteka poleceń cmdlet programu Configuration Manager PowerShell obsługuje program PowerShell w wersji 7.Starting in version 2010, the Configuration Manager PowerShell cmdlet library supports PowerShell version 7. Aby uzyskać więcej informacji na temat programu PowerShell 7, w tym wskazówki dotyczące sposobu pobierania i instalowania, zobacz Instalowanie programu PowerShell w systemie Windows.For more information on PowerShell 7, including directions on how to download and install it, see Install PowerShell on Windows.

Porada

Program PowerShell 7 działa jako pwsh.exe .PowerShell 7 runs as pwsh.exe. Wcześniejsze wersje programu PowerShell są uruchamiane jako powershell.exe .Earlier versions of PowerShell run as powershell.exe.

Znane problemy z programem PowerShell w wersji 7Known issues with PowerShell version 7

  • Programu PowerShell 7 nie można uruchomić bezpośrednio z poziomu konsoli Configuration Manager.You can't launch PowerShell 7 directly from the Configuration Manager console. Uruchom ręcznie program PowerShell 7, a następnie zaimportuj moduł Configuration Manager.Manually start PowerShell 7, and then import the Configuration Manager module.

  • Polecenia cmdlet Configuration Manager z czasownikami importu i eksportu mogą nie działać zgodnie z oczekiwaniami.Configuration Manager cmdlets with Import- and Export- verbs may not function as expected.

  • Bieżąca obsługa jest tylko dla Configuration Manager poleceń cmdlet.Current support is only for the Configuration Manager cmdlets. Inne funkcje Configuration Manager, które opierają się na programie PowerShell, mogą nie obsługiwać wersji 7.Other features of Configuration Manager that rely on PowerShell may not support version 7. Na przykład Uruchom skrypt, CMPivotlub krok sekwencji zadań Uruchom skrypt programu PowerShell .For example, Run Scripts, CMPivot, or the Run PowerShell Script task sequence step.

Opinie dotyczące programu PowerShellFeedback for PowerShell

Jeśli masz opinię na temat poleceń cmdlet programu PowerShell w programie Configuration Manager, Użyj tych samych opcji w konsoli Configuration Manager, aby wysłać opinię.If you have feedback on the Configuration Manager PowerShell cmdlets, use the same options in the Configuration Manager console to send feedback. Aby uzyskać więcej informacji, zobacz opinie o produkcie.For more information, see Product feedback.

Po wysłaniu niezadowolenia należy uwzględnić następujące informacje dodatkowe dotyczące programu PowerShell:When you send a frown, include the following additional information specific to PowerShell:

  • Dokładna składnia skryptu lub polecenia, która została użyta, aby firma Microsoft mogła próbować odtworzyć problem.The exact script or command syntax that you used so that Microsoft can try to reproduce the issue.

  • Zachowanie oczekiwane w porównaniu z rzeczywistym zachowaniem.What behavior you expected compared to the actual behavior.

  • Pełne dane wyjściowe po uruchomieniu go z pełnym wspólnym parametrem.The full output when you run it with the Verbose common parameter.

  • Wersja i ścieżka modułu ConfigurationManager .The version and path of the ConfigurationManager module. Na przykład Uwzględnij dane wyjściowe następujących poleceń:For example, include the output of the following commands:

    (Get-Module -Name ConfigurationManager).Version
    (Get-Module -Name ConfigurationManager).Path
    
  • Jeśli polecenie cmdlet zwróci błąd, użyj następującego polecenia, aby uzyskać szczegóły wyjątku:If a cmdlet returns an error, use the following command to get exception details:

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

Informacje o wersji zapoznawczejPreview release notes

Począwszy od wersji Technical Preview rozgałęzienie 2012, artykuł funkcje w wersji zapoznawczej w podstawowej bibliotece dokumentacji zawiera informacje o wersji dla programu PowerShell.Starting with technical preview branch version 2012, the technical preview features article in the core documentation library includes release notes for PowerShell.

Następne krokiNext steps

Aby uzyskać więcej informacji na temat zmian w najnowszej wersji Configuration Manager, wybierz najnowsze Informacje o wersji z spisu treści.For more information about what's changed in the most recent release of Configuration Manager, select the latest Release Notes from the table of contents.

Aby uzyskać więcej informacji na temat poszczególnych poleceń cmdlet, zobacz dokumentacja poleceń cmdlet Configuration Manager.For more information on individual cmdlets, see the Configuration Manager cmdlet reference.

Aby uzyskać więcej informacji o uczeniu i rozpoczynaniu pracy z programem Windows PowerShell, zobacz PowerShell 101.For more information on learning and getting started with Windows PowerShell, see PowerShell 101.