Beginnen Sie mit Configuration Manager CmdletsGet started with Configuration Manager cmdlets

Gilt für: System Center Configuration Manager (Current Branch)Applies to: System Center Configuration Manager (Current Branch)

Verwenden Sie Windows PowerShell zum Verwalten Ihrer Configuration Manager-Hierarchie mit Skripts, Cmdlets und dem Laufwerks Anbieter.Use Windows PowerShell to manage your Configuration Manager hierarchy with scripts, cmdlets, and the drive provider.

Die grundlegende Methode zum Zugreifen auf Configuration Manager Funktionalität erfolgt über den SMS-Anbieter (WMI).The basic method of accessing Configuration Manager functionality is through the SMS Provider (WMI). Das Erstellen von PowerShell-Skripts zur Automatisierung oder Erweiterung von Configuration Manager ähnelt anderen dokumentierten Ansätzen mithilfe von VBScript und c#.Building PowerShell scripts to automate or extend Configuration Manager is similar to other documented approaches using VBScript and C#. Weitere Informationen finden Sie unter Configuration Manager SDK.For more information, see Configuration Manager SDK.

Verwenden der Configuration Manager-CmdletsUsing the Configuration Manager cmdlets

Führen Sie Configuration Manager-Cmdlets und-Skripts mithilfe der Configuration Manager-Konsole oder mithilfe einer Windows PowerShell-Sitzung aus.Run Configuration Manager cmdlets and scripts by using the Configuration Manager console or by using a Windows PowerShell session. Wenn Sie Configuration Manager-Cmdlets mit der Configuration Manager-Konsole ausführen, wird die Sitzung im Kontext des-Standorts ausgeführt.When you run Configuration Manager cmdlets by using the Configuration Manager console, your session runs in the context of the site.

Laden von Windows PowerShell über die Configuration Manager KonsoleLoad Windows PowerShell from the Configuration Manager console

Die einfachste Methode zum Laden von Windows PowerShell ist direkt über die Configuration Manager Konsole.The easiest method to load Windows PowerShell is directly from the Configuration Manager console.

  1. Starten Sie, indem Sie die Configuration Manager-Konsole starten.Start by launching the Configuration Manager console. In der oberen linken Ecke gibt es ein blaues Rechteck.In the upper-left corner, there's a blue rectangle. Wählen Sie den weißen Pfeil im blauen Rechteck aus, und wählen Sie über Windows PowerShell verbindenaus.Select the white arrow in the blue rectangle, and choose Connect via Windows PowerShell.

  2. Nachdem Windows PowerShell geladen wurde, wird eine Eingabeaufforderung angezeigt, die ihren Standortcode enthält.After Windows PowerShell loads, you'll see a prompt that contains your site code. Wenn beispielsweise der Standortcode "ABC" lautet, sieht die Eingabeaufforderung wie folgt aus:For example, if the site code is "ABC", the prompt looks like:

    PS ABC:\>  
    
  3. Vergewissern Sie sich zunächst, dass alles funktioniert Get-CMSite , indem Sie das Cmdlet verwenden.First verify everything is working by using the Get-CMSite cmdlet. Dieses Cmdlet gibt Informationen zu der Configuration Manager Site zurück, mit der Sie derzeit verbunden sind.This cmdlet returns information about the Configuration Manager site you're currently connected to. In Ihrem Windows PowerShell-Fenster sollte eine Ausgabe angezeigt werden, die dem folgenden Beispiel ähnelt:In your Windows PowerShell window you should see output similar to the following example:

    PS ABC:\> Get-CMSite  
    
    BuildNumber       : 7958  
    Features          : 0000000000000000000000000000000000000000000000000000000000000000  
    InstallDir        : C:\Program Files\Microsoft Configuration Manager  
    Mode              : 0  
    ReportingSiteCode :  
    RequestedStatus   : 110  
    ServerName        : SDKTESTLAB.test.lab  
    SiteCode          : ABC  
    SiteName          : ABC Test Site  
    Status            : 1  
    TimeZoneInfo      : 000001E0 0000 000B 0000 0001 0002 0000 0000 0000 00000000 0000 0003 0000 0002 0002 0000 0000 0000  
                        FFFFFFC4  
    Type              : 2  
    Version           : 5.00.7958.1000  
    
    

Importieren des Configuration Manager PowerShell-ModulsImport the Configuration Manager PowerShell module

Eine weitere Methode zum Herstellen einer Verbindung mit Configuration Manager aus Ihrer Windows PowerShell-Umgebung besteht darin, das Configuration Manager Modul manuell zu laden.Another method of connecting to Configuration Manager from your Windows PowerShell environment is to load the Configuration Manager module manually.

  1. Importieren Sie das Configuration Manager Modul mithilfe des Import-Module Cmdlets.Import the Configuration Manager module by using the Import-Module cmdlet. Um das Configuration Manager Modul zu importieren, geben Sie den Pfad zum Configuration Manager Modul an, oder wechseln Sie in das Verzeichnis, in dem sich das Modul befindet.To import the Configuration Manager module, specify the path to the Configuration Manager module, or change to the directory that contains the module. Standardmäßig befindet sich das Modul im folgenden Pfad:C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin\ConfigurationManager.psd1By default, the module is at the following path: C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin\ConfigurationManager.psd1

    Im folgenden Beispiel wird in das Modul Verzeichnis geändert und dann importiert:The following example changes to the module's directory and then imports it:

    PS C:\>  
    PS C:\> CD 'C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin'  
    PS C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin> Import-Module .\ConfigurationManager.psd1  
    
  2. Wenn Sie die Configuration Manager-Cmdlets ausführen möchten, müssen Sie den Pfad zur Configuration Manager Site wechseln.To run the Configuration Manager cmdlets, you need to switch the path to the Configuration Manager site. Im folgenden Beispiel lautet der Standortcode wie folgt ABC:In the following example, the site code is ABC:

    PS C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin> CD ABC:   
    PS ABC:\>  
    
  3. Vergewissern Sie sich, dass PowerShell das Configuration Manager Modul ordnungsgemäß Get-CMSite mithilfe des Cmdlets geladen hat.Confirm that PowerShell properly loaded the Configuration Manager module by using the Get-CMSite cmdlet.

Hilfe aktualisierenUpdate help

Aktualisieren Sie die Windows PowerShell-Hilfe Update-Help mithilfe des-Cmdlets.Update Windows PowerShell help by using the Update-Help cmdlet. Mit dieser Aktion können Sie auch die Hilfe für die Configuration Manager-Cmdlets aktualisieren.This action can also update the help for the Configuration Manager cmdlets. Wenn Ihr Computer mit dem Internet verbunden ist, navigieren Sie zu Ihrem Windows PowerShell-Fenster, und Update-Help –Module configurationmanagergeben Sie ein.If your computer is connected to the internet, go to your Windows PowerShell window, and type in Update-Help –Module configurationmanager. Stellen Sie sicher, dass Sie Windows PowerShell als Administrator ausführen.Make sure that you're running Windows PowerShell as an administrator.

Nachdem Sie die Configuration Manager-Cmdlet-Hilfe installiert haben, können Sie mithilfe des Get-Help Cmdlets Hilfe zu den Cmdlets erhalten.After you have installed the Configuration Manager cmdlet help, you can get help about the cmdlets by using the Get-Help cmdlet. Wechseln Sie beispielsweise zum Windows PowerShell-Fenster, und geben Sie Get-Help Get-CMSiteein.For example, go to your Windows PowerShell window, and type in Get-Help Get-CMSite.

Nächste SchritteNext steps

Wenn Sie weitere Informationen zu den Änderungen in der neuesten Version von Configuration Manager haben, wählen Sie im Inhaltsverzeichnis auf der linken Seite die neuesten Anmerkungen zu dieser Version aus.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 to the left.

Weitere Informationen zu einzelnen Cmdlets finden Sie in der Configuration Manager-Cmdlet-Referenz.For more information on individual cmdlets, see the Configuration Manager cmdlet reference.