Erste Schritte 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 wird zum Verwalten von Configuration Manager-Hierarchie mit Skripts, Cmdlets und den laufwerksanbieter.Use Windows PowerShell to manage your Configuration Manager hierarchy with scripts, cmdlets, and the drive provider.

Die grundlegende Methode für den Zugriff auf Configuration Manager-Funktionalität ist über die SMS-Anbieter (WMI).The basic method of accessing Configuration Manager functionality is through the SMS Provider (WMI). Erstellen von PowerShell-Skripts zum Automatisieren, oder Erweitern von Configuration Manager ähnelt dokumentierten Ansätzen mit 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.

Mithilfe der Configuration Manager-cmdletsUsing the Configuration Manager cmdlets

Configuration Manager-Cmdlets und Skripts ausgeführt werden, mithilfe von Configuration Manager-Konsole oder mithilfe einer Windows PowerShell-Sitzungs.Run Configuration Manager cmdlets and scripts by using the Configuration Manager console or by using a Windows PowerShell session. Wenn Sie Configuration Manager-Cmdlets über die 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 Sie Windows PowerShell über die Configuration Manager-KonsoleLoad Windows PowerShell from the Configuration Manager console

Die einfachste Methode zum Laden von Windows PowerShell ist direkt in der 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 wird es ein blaues Rechteck.In the upper-left corner, there's a blue rectangle. Wählen Sie die weiße Pfeile in das blaue Rechteck aus, und wählen Sie verbinden über Windows PowerShell.Select the white arrow in the blue rectangle, and choose Connect via Windows PowerShell.

  2. Nachdem Windows PowerShell geladen wurde, sehen Sie eine Eingabeaufforderung, die Ihr Standortcode enthält.After Windows PowerShell loads, you'll see a prompt that contains your site code. Beispielsweise ist der Standortcode "ABC", sieht die Eingabeaufforderung:For example, if the site code is "ABC", the prompt looks like:

    PS ABC:\>  
    
  3. Zunächst prüfen, ob alles funktioniert mithilfe der Get-CMSite Cmdlet.First verify everything is working by using the Get-CMSite cmdlet. Dieses Cmdlet gibt Informationen über die Configuration Manager-Website, die, der Sie gerade verbunden sind.This cmdlet returns information about the Configuration Manager site you're currently connected to. In Windows PowerShell-Fenster sollte eine Ausgabe ähnlich dem folgenden Beispiel angezeigt werden: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 Sie das Configuration Manager-PowerShell-ModulImport the Configuration Manager PowerShell module

Eine andere Methode für das Herstellen einer Verbindung zu Configuration Manager aus der Windows PowerShell-Umgebung ist manuell im Configuration Manager-Modul zu laden.Another method of connecting to Configuration Manager from your Windows PowerShell environment is to load the Configuration Manager module manually.

  1. Mit der rechten Maustaste in des Windows PowerShell-Symbols, und wählen Sie "Als Administrator ausführen".Right-click the Windows PowerShell icon and choose "Run as administrator".

  2. Importieren Sie das Configuration Manager-Modul mithilfe der Import-Module Cmdlet.Import the Configuration Manager module by using the Import-Module cmdlet. Um das Configuration Manager-Modul zu importieren, geben Sie den Pfad für das Configuration Manager-Modul, oder ändern Sie in das Verzeichnis, das das Modul enthält.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 ist das Modul unter folgendem 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 ändert die Modul Verzeichnis aus, und klicken Sie 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  
    
  3. Führen Sie die Configuration Manager-Cmdlets müssen Sie den Pfad in der Configuration Manager-Standort zu wechseln.To run the Configuration Manager cmdlets, you need to switch the path to the Configuration Manager site. Im folgenden Beispiel wird der Code des Standorts ABC:In the following example, the site code is ABC:

    PS C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin> CD ABC:   
    PS ABC:\>  
    
  4. Bestätigen Sie, dass PowerShell ordnungsgemäß im Configuration Manager-Modul geladen der Get-CMSite Cmdlet.Confirm that PowerShell properly loaded the Configuration Manager module by using the Get-CMSite cmdlet.

Aktualisieren der HilfeUpdate help

Aktualisieren Sie Windows PowerShell-Hilfe, indem die Update-Help Cmdlet.Update Windows PowerShell help by using the Update-Help cmdlet. Dadurch kann 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, wechseln Sie zu Ihrem Windows PowerShell-Fenster, und geben in Update-Help –Module configurationmanager.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 Hilfe zu den Cmdlets abrufen, indem Sie mit der Get-Help Cmdlet.After you have installed the Configuration Manager cmdlet help, you can get help about the cmdlets by using the Get-Help cmdlet. Beispielsweise finden Sie unter Ihrem Windows PowerShell-Fenster, und geben Sie in Get-Help Get-CMSite.For example, go to your Windows PowerShell window, and type in Get-Help Get-CMSite.

Nächste SchritteNext steps

Wählen Sie für Weitere Informationen zu in der neuesten Version von Configuration Manager Änderungen, den letzten Anmerkungen zu dieser Version das Inhaltsverzeichnis auf der linken Seite.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 den einzelnen Cmdlets, finden Sie unter den Configuration Manager-Cmdlet-Referenz.For more information on individual cmdlets, see the Configuration Manager cmdlet reference.