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

Se aplica a: Configuration Manager (rama actual)Applies to: Configuration Manager (current branch)

Use Windows PowerShell para administrar la jerarquía Administrador de configuración usuario.Use Windows PowerShell to manage your Configuration Manager hierarchy. Puede usar scripts de PowerShell para automatizar o ampliar Administrador de configuración similares a otros enfoques documentados mediante WMI y C#.You can use PowerShell scripts to automate or extend Configuration Manager similar to other documented approaches using WMI and C#. Para obtener más información, consulte Administrador de configuración SDK.For more information, see Configuration Manager SDK.

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

Nota

Todas las versiones admitidas actualmente Administrador de configuración la rama actual admiten Windows PowerShell versión 5.1.All currently supported versions of Configuration Manager current branch support Windows PowerShell version 5.1. Si ya ha instalado PowerShell versión 7, todavía puede usar PowerShell versión 5.1.If you've already installed PowerShell version 7, you can still use PowerShell version 5.1. Para obtener más información, consulte Uso de PowerShell 7 en paralelo con Windows PowerShell 5.1.For more information, see Using PowerShell 7 side-by-side with Windows PowerShell 5.1.

A partir de la versión 2010, la biblioteca Administrador de configuración cmdlets de PowerShell admite PowerShell 7.Starting in version 2010, the Configuration Manager PowerShell cmdlet library supports PowerShell 7. Para más información, consulte Compatibilidad con PowerShell versión 7.For more information, see Support for PowerShell version 7.

PowerShell desde la consola de Administrador de configuraciónPowerShell from the Configuration Manager console

El método más sencillo para abrir PowerShell es directamente desde Administrador de configuración consola.The easiest method to open PowerShell is directly from the Configuration Manager console.

  1. Inicie la Administrador de configuración consola.Launch 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 Conectar mediante Windows PowerShell.Select the white arrow in the blue rectangle, and choose Connect via Windows PowerShell.

  2. Después Windows PowerShell carga, verá un mensaje que contiene el código de 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 tiene el siguiente aspecto: PS ABC:\>For example, if the site code is "ABC", the prompt looks like: PS ABC:\>

  3. Para comprobar que funciona, use el cmdlet Get-CMSite.To verify it works, use the Get-CMSite cmdlet. Este cmdlet devuelve información sobre el Administrador de configuración al que está conectado actualmente y los sitios secundarios.This cmdlet returns information about the Configuration Manager site you're currently connected to and any child sites. Por ejemplo, el nombre del servidor de sitio, el director de instalación, el nombre del sitio y la versión.For example, the site server name, installation director, site name, and version.

Importación de Administrador de configuración módulo de PowerShellImport the Configuration Manager PowerShell module

Conéctese a Administrador de configuración desde una sesión de Windows PowerShell existente mediante la carga manual del Administrador de configuración módulo.Connect to Configuration Manager from an existing Windows PowerShell session by manually loading the Configuration Manager module.

  1. Abra una Windows PowerShell sesión desde el menú Inicio.Open a Windows PowerShell session from the Start menu.

  2. Importe el Administrador de configuración módulo mediante el cmdlet Import-Module.Import the Configuration Manager module by using the Import-Module cmdlet. Especifique la ruta de acceso al Administrador de configuración módulo o cambie al directorio que contiene el módulo.Specify the path to the Configuration Manager module, or change to the directory that contains the module. De forma predeterminada, el módulo se encuentra en la ruta de acceso siguiente: 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

    Importante

    Esta ruta de acceso cambió a partir de la versión 1910 para usar la Microsoft Endpoint Manager carpeta .This path changed starting in version 1910 to use the Microsoft Endpoint Manager folder. Asegúrese de no importar una versión anterior del módulo que pueda existir en otra carpeta.Make sure you don't import an older version of the module that might exist in another folder. Después de importar el módulo, use los siguientes comandos para comprobar la versión y la ruta de acceso del módulo: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
    

    En el ejemplo siguiente se cambian los cambios en el directorio del módulo y, a continuación, se importa: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
    

    Sugerencia

    También puede usar la variable SMS_ADMIN_UI_PATH de entorno.You can also use the SMS_ADMIN_UI_PATH environment variable. Por ejemplo:For example:

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

    Además, puede usar el alias cd para cambiar los directorios en lugar del cmdlet Set-Location.Also, you can use the cd alias to change directories instead of the Set-Location cmdlet.

  3. Si es la primera vez que importa el módulo Administrador de configuración en este equipo, es posible que tenga que crear la unidad del sitio.If it's the first time importing the Configuration Manager module on this computer, you may need to create the site drive. Por ejemplo:For example:

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

    Sugerencia

    Cuando se inicia PowerShell desde la consola, se crea automáticamente PSDrive como una comodidad para el sitio conectado actualmente.When you start PowerShell from the console, it automatically creates the PSDrive as a convenience for the currently connected site. Si está en una jerarquía, use New-PSDrive para crear unidades para cada sitio.If you're in a hierarchy, use New-PSDrive to create drives for each site.

  4. Para ejecutar los cmdlets Administrador de configuración, debe cambiar la ruta de acceso al Administrador de configuración sitio.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:

    Set-Location ABC:
    
  5. Confirme que PowerShell cargó correctamente Administrador de configuración módulo mediante el cmdlet Get-CMSite.Confirm that PowerShell properly loaded the Configuration Manager module by using the Get-CMSite cmdlet.

Actualización de la ayudaUpdate help

A partir de la versión 2010, para obtener la información más reciente de Administrador de configuración módulo de PowerShell, use el cmdlet Update-Help.Starting in version 2010, to get the latest information for the Configuration Manager PowerShell module, use the Update-Help cmdlet. Este contenido es el mismo que está publicado en docs.microsoft.com para el módulo ConfigurationManager.This content is the same as what's published on docs.microsoft.com for the ConfigurationManager module.

Importante

Debido a un cambio en la forma en que el contenido actualizable se estructura y publica con el lanzamiento de la versión 2103, no use Update-Help en un sitio de la versión 2010.Because of a change in how the updateable content is structured and published with the release of version 2103, don't use Update-Help on a version 2010 site. Actualice el sitio a la versión 2103 y, a continuación, actualice el contenido de la ayuda local.Update the site to version 2103, and then update the local help content.

Para obtener más información, consulte las notas de la versión 2103 de PowerShell.For more information, see PowerShell version 2103 release notes.

Es necesario que el equipo en que se ejecuta este cmdlet tenga acceso a Internet, específicamente a pshelpprod.blob.core.windows.net.The computer on which you run this cmdlet needs internet access, specifically pshelpprod.blob.core.windows.net. A continuación, ejecute el siguiente comando desde una sesión de PowerShell con privilegios elevados:Then run the following command from an elevated PowerShell session:

Update-Help –Module ConfigurationManager

Después de actualizar la Administrador de configuración cmdlet, puede obtener ayuda sobre los cmdlets mediante el cmdlet Get-Help.After you update the Configuration Manager cmdlet help, you can get help about the cmdlets by using the Get-Help cmdlet. Por ejemplo:For example:

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

Para obtener más información, vea la siguiente entrada de blog de PowerShell: You've got Help!.For more information, see the following PowerShell blog post: You've got Help!.

Parámetros comunesCommon parameters

Todos Administrador de configuración cmdlets admiten los parámetros comunes de PowerShell:All Configuration Manager cmdlets support the common PowerShell parameters:

  • DepurarDebug
  • ErrorActionErrorAction
  • ErrorVariableErrorVariable
  • InformationActionInformationAction
  • InformationVariableInformationVariable
  • OutVariableOutVariable
  • OutBufferOutBuffer
  • PipelineVariablePipelineVariable
  • VerboseVerbose
  • WarningActionWarningAction
  • WarningVariableWarningVariable

Para obtener más información, consulta about_CommonParameters.For more information, see about_CommonParameters.

Compatibilidad con PowerShell, versión 7Support for PowerShell version 7

A partir de la versión 2010, la Administrador de configuración de cmdlets de PowerShell admite PowerShell versión 7.Starting in version 2010, the Configuration Manager PowerShell cmdlet library supports PowerShell version 7. Para obtener más información sobre PowerShell 7, incluidas las instrucciones sobre cómo descargarlo e instalarlo, vea Instalación de PowerShell en Windows.For more information on PowerShell 7, including directions on how to download and install it, see Install PowerShell on Windows.

Sugerencia

PowerShell 7 se ejecuta como pwsh.exe.PowerShell 7 runs as pwsh.exe. Las versiones anteriores de PowerShell se ejecutan como powershell.exe.Earlier versions of PowerShell run as powershell.exe.

Cmdlets que no admiten la versión 7 de PowerShellCmdlets that don't support PowerShell version 7

Los cmdlets siguientes no admiten PowerShell 7:The following cmdlets don't support PowerShell 7:

  • Import-CMPackageImport-CMPackage
  • Import-CMDriverPackageImport-CMDriverPackage
  • Import-CMTaskSequenceImport-CMTaskSequence
  • Export-CMPackageExport-CMPackage
  • Export-CMDriverPackageExport-CMDriverPackage
  • Export-CMTaskSequenceExport-CMTaskSequence

Necesitan .NET Framework en lugar de .NET Core que se usa con la versión 7 de PowerShell.They require the .NET Framework instead of .NET Core that's used with PowerShell version 7.

A partir de la versión 2103, si intenta usar estos cmdlets en una sesión de PowerShell versión 7, se producirá el siguiente error: This cmdlet only supports the ".NET Framework" runtime.Starting in version 2103, if you try to use these cmdlets in a PowerShell version 7 session, they fail with the following error: This cmdlet only supports the ".NET Framework" runtime.

Problemas conocidos de PowerShell versión 7Known issues with PowerShell version 7

  • No se puede iniciar PowerShell 7 directamente desde la Administrador de configuración consola.You can't launch PowerShell 7 directly from the Configuration Manager console. Inicie manualmente PowerShell 7 y, a continuación, importe el módulo de Configuration Manager.Manually start PowerShell 7, and then import the Configuration Manager module.

  • La compatibilidad actual solo es para los Administrador de configuración cmdlets.Current support is only for the Configuration Manager cmdlets. Otras características de Configuration Manager que se basan en PowerShell podrían no admitir la versión 7.Other features of Configuration Manager that rely on PowerShell may not support version 7. Por ejemplo, Ejecutar scripts, CMPivot o el paso de secuencia de tareas Ejecutar script de PowerShell.For example, Run Scripts, CMPivot, or the Run PowerShell Script task sequence step.

Comentarios para PowerShellFeedback for PowerShell

Si tiene comentarios sobre los cmdlets de PowerShell de Configuration Manager, use las mismas opciones de la consola de Configuration Manager para enviarlos.If you have feedback on the Configuration Manager PowerShell cmdlets, use the same options in the Configuration Manager console to send feedback. Para obtener más información, vea Comentarios sobre el producto.For more information, see Product feedback.

Cuando envíe una desaprobación, incluya la siguiente información adicional específica de PowerShell:When you send a frown, include the following additional information specific to PowerShell:

  • El script o la sintaxis de comandos exactos que haya usado para que Microsoft pueda intentar reproducir el problema.The exact script or command syntax that you used so that Microsoft can try to reproduce the issue.

  • El comportamiento esperado en comparación con el comportamiento real.What behavior you expected compared to the actual behavior.

  • La salida completa cuando se ejecuta con el parámetro común Verbose.The full output when you run it with the Verbose common parameter.

  • La versión y la ruta de acceso del módulo ConfigurationManager.The version and path of the ConfigurationManager module. Por ejemplo, incluya la salida de los comandos siguientes:For example, include the output of the following commands:

    (Get-Module -Name ConfigurationManager).Version
    (Get-Module -Name ConfigurationManager).Path
    
  • Si un cmdlet devuelve un error, use el comando siguiente para obtener los detalles de la excepción:If a cmdlet returns an error, use the following command to get exception details:

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

Notas de la versión preliminarPreview release notes

A partir de la versión 2012 de la rama technical preview, el artículo de características de technical preview de la biblioteca de documentación principal incluye notas de la versión de PowerShell.Starting with technical preview branch version 2012, the technical preview features article in the core documentation library includes release notes for PowerShell.

Pasos siguientesNext steps

Para obtener más información sobre lo que ha cambiado en la versión más reciente de Administrador de configuración, seleccione las notas de la versión más recientes en la tabla de contenido.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.

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

Para obtener más información sobre el aprendizaje y la introducción a Windows PowerShell, vea PowerShell 101.For more information on learning and getting started with Windows PowerShell, see PowerShell 101.