Introducción a los cmdlets de Configuration ManagerGet started with Configuration Manager cmdlets

Se aplica a: System Center Configuration Manager (rama actual)Applies to: System Center Configuration Manager (Current Branch)

Usar Windows PowerShell para administrar la jerarquía de Configuration Manager con scripts, los cmdlets y el proveedor de la unidad.Use Windows PowerShell to manage your Configuration Manager hierarchy with scripts, cmdlets, and the drive provider.

El método básico de acceso a la funcionalidad de Configuration Manager es mediante el proveedor de SMS (WMI).The basic method of accessing Configuration Manager functionality is through the SMS Provider (WMI). Creación de scripts de PowerShell para automatizar o extender Configuration Manager es similar a otros enfoques documentadas con VBScript y C#.Building PowerShell scripts to automate or extend Configuration Manager is similar to other documented approaches using VBScript and C#. Para obtener más información, consulte SDK de Configuration Manager.For more information, see Configuration Manager SDK.

Uso de los cmdlets de Configuration ManagerUsing the Configuration Manager cmdlets

Ejecutar scripts y cmdlets de Configuration Manager mediante la consola de Configuration Manager o mediante una sesión de Windows PowerShell.Run Configuration Manager cmdlets and scripts by using the Configuration Manager console or by using a Windows PowerShell session. Al ejecutar los cmdlets de Configuration Manager mediante la consola de Configuration Manager, la sesión se ejecuta en el contexto del sitio.When you run Configuration Manager cmdlets by using the Configuration Manager console, your session runs in the context of the site.

Carga de Windows PowerShell desde la consola de Configuration ManagerLoad Windows PowerShell from the Configuration Manager console

El método más sencillo para cargar Windows PowerShell es hacerlo directamente desde la consola de Configuration Manager.The easiest method to load Windows PowerShell is directly from the Configuration Manager console.

  1. Comience por iniciar la consola de Configuration Manager.Start by launching the Configuration Manager console. En la esquina superior izquierda, hay un rectángulo azul.In the upper-left corner, there's a blue rectangle. Seleccione la flecha blanca en el rectángulo azul y elija Connect a través de Windows PowerShell.Select the white arrow in the blue rectangle, and choose Connect via Windows PowerShell.

  2. Después de que Windows PowerShell se cargue, verá un mensaje que contiene el código del sitio.After Windows PowerShell loads, you'll see a prompt that contains your site code. Por ejemplo, si el código de sitio es "ABC", el símbolo del sistema aspecto:For example, if the site code is "ABC", the prompt looks like:

    PS ABC:\>  
    
  3. En primer lugar, compruebe que todo funciona mediante el uso de la Get-CMSite cmdlet.First verify everything is working by using the Get-CMSite cmdlet. Este cmdlet devuelve información sobre el sitio de Configuration Manager que está conectado actualmente.This cmdlet returns information about the Configuration Manager site you're currently connected to. En la ventana de Windows PowerShell verá un resultado similar al ejemplo siguiente: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  
    

Importe el módulo de PowerShell de Configuration ManagerImport the Configuration Manager PowerShell module

Es otro método para conectar a Configuration Manager desde el entorno de Windows PowerShell cargar el módulo de administrador de configuración manualmente.Another method of connecting to Configuration Manager from your Windows PowerShell environment is to load the Configuration Manager module manually.

  1. Haga clic en el icono de Windows PowerShell y elija "Ejecutar como administrador".Right-click the Windows PowerShell icon and choose "Run as administrator".

  2. Importe el módulo de Configuration Manager mediante el Import-Module cmdlet.Import the Configuration Manager module by using the Import-Module cmdlet. Para importar el módulo de Configuration Manager, especifique la ruta de acceso al módulo de Configuration Manager o cambie al directorio que contiene el módulo.To import the Configuration Manager module, specify the path to the Configuration Manager module, or change to the directory that contains the module. De forma predeterminada, el módulo está en la ruta de acceso siguiente: 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

    El ejemplo siguiente se cambia al directorio del módulo y lo importa: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. Para ejecutar los cmdlets de Configuration Manager, deberá cambiar la ruta de acceso al sitio de Configuration Manager.To run the Configuration Manager cmdlets, you need to switch the path to the Configuration Manager site. En el ejemplo siguiente, el código de sitio es 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. Confirme que PowerShell cargado correctamente el módulo de Configuration Manager mediante el uso de la Get-CMSite cmdlet.Confirm that PowerShell properly loaded the Configuration Manager module by using the Get-CMSite cmdlet.

Actualizar la AyudaUpdate help

Actualizar la Ayuda de Windows PowerShell mediante el uso de la Update-Help cmdlet.Update Windows PowerShell help by using the Update-Help cmdlet. Esta acción también puede actualizar la Ayuda de los cmdlets de Configuration Manager.This action can also update the help for the Configuration Manager cmdlets. Si el equipo está conectado a internet, vaya a la ventana de Windows PowerShell y escriba en 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. Asegúrese de que está ejecutando Windows PowerShell como administrador.Make sure that you're running Windows PowerShell as an administrator.

Después de haber instalado la Ayuda de los cmdlets de Configuration Manager, puede obtener ayuda acerca de los cmdlets de mediante el 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. Por ejemplo, vaya a la ventana de Windows PowerShell y escriba en Get-Help Get-CMSite.For example, go to your Windows PowerShell window, and type in Get-Help Get-CMSite.

Pasos siguientesNext steps

Para obtener más información acerca de qué ha cambiado en la versión más reciente de Configuration Manager, seleccione la versión más reciente notas de la versión desde la tabla de contenido a la izquierda.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.

Para obtener más información sobre los cmdlets individuales, consulte el referencia de cmdlets de Configuration Manager.For more information on individual cmdlets, see the Configuration Manager cmdlet reference.