Wprowadzenie do Menedżer konfiguracji cmdlet

  • Artykuł

Dotyczy: Menedżer konfiguracji (Current Branch)

Użyj Windows PowerShell do zarządzania hierarchią Menedżer konfiguracji zarządzania. Skryptów programu PowerShell można używać do automatyzowania lub rozszerzania Menedżer konfiguracji podobnych do innych udokumentowanych podejść przy użyciu usługi WMI i języka C#. Aby uzyskać więcej informacji, zobacz Menedżer konfiguracji SDK.

Uruchom Menedżer konfiguracji cmdlet i skrypty w programie PowerShell z Menedżer konfiguracji konsoli programu lub z Windows PowerShell sesji. Po uruchomieniu Menedżer konfiguracji cmdlet przy użyciu konsoli Menedżer konfiguracji, sesja zostanie automatycznie uruchomiona w kontekście lokacji.

Uwaga

Wszystkie obecnie obsługiwane wersje programu Menedżer konfiguracji Current Branch obsługują Windows PowerShell wersji 5.1. Jeśli masz już zainstalowany program PowerShell w wersji 7, nadal możesz używać programu PowerShell w wersji 5.1. Aby uzyskać więcej informacji, zobacz Using PowerShell 7 side-by-side with Windows PowerShell 5.1 (Używanie programu PowerShell 7 razem z programem Windows PowerShell 5.1).

Począwszy od wersji 2010, biblioteka Menedżer konfiguracji poleceń cmdlet programu PowerShell obsługuje program PowerShell 7. Aby uzyskać więcej informacji, zobacz Support for PowerShell version 7 (Obsługa programu PowerShell w wersji 7).

Począwszy od wersji 2103 moduł ConfigurationManager programu PowerShell Microsoft .NET wersji 4.7.2 lub nowszej.

Program PowerShell z Menedżer konfiguracji aplikacji

Najprostszą metodą otwierania programu PowerShell jest bezpośrednie Menedżer konfiguracji konsoli programu .

  1. Uruchom konsolę Menedżer konfiguracji. W lewym górnym rogu znajduje się niebieski prostokąt. Wybierz białą strzałkę w niebieskim prostokącie, a następnie wybierz pozycję Połączenie za pośrednictwem Windows PowerShell.

  2. Po Windows PowerShell zostanie wyświetlony monit zawierający kod lokacji. Jeśli na przykład kod lokacji to "ABC", monit wygląda następująco: PS ABC:\>

  3. Aby sprawdzić, czy działa, użyj polecenia cmdlet Get-CMSite. To polecenie cmdlet zwraca informacje Menedżer konfiguracji lokacji, z która jest aktualnie nałączona, oraz wszystkich lokacji podrzędnych. Na przykład nazwa serwera lokacji, katalog instalacji, nazwa lokacji i wersja.

Importowanie Menedżer konfiguracji programu PowerShell

Połączenie, Menedżer konfiguracji z istniejącej sesji Windows PowerShell, ręcznie ładuj moduł Menedżer konfiguracji.

  1. Otwórz sesję Windows PowerShell z menu Start.

  2. Zaimportuj Menedżer konfiguracji za pomocą polecenia cmdlet Import-Module. Określ ścieżkę do Menedżer konfiguracji lub zmień katalog, który zawiera moduł. Domyślnie moduł ma następującą ścieżkę: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\ConfigurationManager.psd1

    Ważne

    Ta ścieżka zmieniła się, począwszy od wersji 1910, tak aby używać Microsoft Endpoint Manager folderu . Upewnij się, że nie importujesz starszej wersji modułu, która może istnieć w innym folderze. Po zaimportowaniu modułu użyj następujących poleceń, aby sprawdzić wersję i ścieżkę modułu:

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

    Poniższy przykład zmienia katalog modułu, a następnie importuje go:

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

    Porada

    Można również użyć zmiennej SMS_ADMIN_UI_PATH środowiskowej . Na przykład:

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

    Ponadto możesz użyć aliasu cd do zmiany katalogów zamiast polecenia cmdlet Set-Location.

  3. W przypadku pierwszego importowania modułu Menedżer konfiguracji na tym komputerze może być konieczne utworzenie dysku lokacji. Na przykład:

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

    Porada

    Po uruchomieniu programu PowerShell z konsoli programu automatycznie tworzy ono usługę PSDrive jako udogodnienie dla aktualnie połączonej witryny. Jeśli znajdujesz się w hierarchii, użyj new-PSDrive do tworzenia dysków dla każdej lokacji.

  4. Aby uruchomić Menedżer konfiguracji cmdlet, należy przełączyć ścieżkę do Menedżer konfiguracji lokacji. W poniższym przykładzie kod lokacji to ABC :

    Set-Location ABC:

  5. Upewnij się, że program PowerShell poprawnie Menedżer konfiguracji moduł za pomocą polecenia cmdlet Get-CMSite.

Aktualizowanie pomocy

Począwszy od wersji 2010, aby uzyskać najnowsze informacje dotyczące modułu Menedżer konfiguracji PowerShell, użyj polecenia cmdlet Update-Help. Ta zawartość jest taka sama jak zawartość opublikowana na stronie docs.microsoft.com modułu ConfigurationManager.

Ważne

Ze względu na zmianę struktury zawartości z aktualizacją i opublikowania jej w wersji 2103 nie należy używać aktualizacji pomocy w witrynie w wersji 2010. Zaktualizuj witrynę do wersji 2103, a następnie zaktualizuj lokalną zawartość pomocy.

Aby uzyskać więcej informacji, zobacz Informacje o wersji programu PowerShell w wersji 2103.

Komputer, na którym jest uruchamiane to polecenie cmdlet, musi mieć dostęp do Internetu, a w szczególności . pshelpprod.blob.core.windows.net Następnie uruchom następujące polecenie w sesji programu PowerShell z podwyższonym poziomem uprawnień:

Update-Help -Module ConfigurationManager

Po zaktualizowaniu pomocy Menedżer konfiguracji cmdlet możesz uzyskać pomoc o poleceniach cmdlet za pomocą polecenia cmdlet Get-Help. Na przykład:

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: You've got Help! (Masz pomoc!).

Typowe parametry

Wszystkie Menedżer konfiguracji cmdlet obsługują typowe parametry programu PowerShell:

  • Debugowanie
  • Erroraction
  • ErrorVariable
  • InformationAction
  • InformationVariable
  • OutVariable (Niezmienny).
  • OutBuffer
  • PipelineVariable
  • Pełny
  • Warningaction
  • WarningVariable

Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Obsługa programu PowerShell w wersji 7

Począwszy od wersji 2010, biblioteka Menedżer konfiguracji poleceń cmdlet programu PowerShell obsługuje program PowerShell w wersji 7. Aby uzyskać więcej informacji na temat programu PowerShell 7, w tym wskazówki dotyczące pobierania i instalowania go, zobacz Instalowanie programu PowerShellna Windows .

Porada

Program PowerShell 7 działa jako pwsh.exe . Wcześniejsze wersje programu PowerShell działają jako powershell.exe .

Polecenia cmdlet, które nie obsługują programu PowerShell w wersji 7

Następujące polecenia cmdlet nie obsługują programu PowerShell 7:

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

Wymagają one .NET Framework zamiast programu .NET Core używanego z programem PowerShell w wersji 7.

Począwszy od wersji 2103, próba użycia tych poleceń cmdlet w sesji programu PowerShell w wersji 7 nie powiedzie się z następującym błędem: This cmdlet only supports the ".NET Framework" runtime.

Znane problemy z programem PowerShell w wersji 7

  • Nie można uruchomić programu PowerShell 7 bezpośrednio z Menedżer konfiguracji konsoli programu . Ręcznie uruchom program PowerShell 7, a następnie zaimportuj Menedżer konfiguracji modułu.

  • Bieżąca obsługa jest dostępna tylko dla Menedżer konfiguracji cmdlet. Inne funkcje programu Menedżer konfiguracji, które korzystają z programu PowerShell, mogą nie obsługiwać wersji 7. Na przykład uruchom skrypty, cmpivotlub krok sekwencji zadań Uruchom skrypt programu PowerShell.

Opinie dotyczące programu PowerShell

Jeśli masz opinię na temat Menedżer konfiguracji cmdlet programu PowerShell, użyj tych samych opcji w konsoli Menedżer konfiguracji, aby wysłać opinię. Aby uzyskać więcej informacji, zobacz Opinie o produkcie.

Podczas wysyłania frustratora dołącz następujące dodatkowe informacje specyficzne dla programu PowerShell:

  • Dokładna składnia skryptu lub polecenia, która jest używana, aby firma Microsoft próbowała odtworzyć problem.

  • Jakie zachowanie było oczekiwane w porównaniu z rzeczywistym zachowaniem.

  • Pełne dane wyjściowe po uruchomieniu z pełnym parametrem wspólnym.

  • Wersja i ścieżka modułu ConfigurationManager. Na przykład dołącz dane wyjściowe następujących poleceń:

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

  • Jeśli polecenie cmdlet zwraca błąd, użyj następującego polecenia, aby uzyskać szczegóły wyjątku:

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

Informacje o wersji zapoznawczej

Artykuł na temat funkcji w wersji Technical Preview w podstawowej bibliotece dokumentacji zawiera informacje o wersji programu PowerShell. Zobacz na przykład wersję Technical Preview 2106.

Następne kroki

Aby uzyskać więcej informacji o tym, co zmieniło się w najnowszej wersji Menedżer konfiguracji, wybierz najnowsze informacje o wersji ze spisu treści.

Aby uzyskać więcej informacji o poszczególnych poleceniach cmdlet, zobacz Menedżer konfiguracji polecenia cmdlet.

Aby uzyskać więcej informacji na temat nauki i rozpoczynania pracy z Windows PowerShell, zobacz PowerShell 101.