about_PSSnapins

  • Artículo

Descripción breve

Describe los complementos de Windows PowerShell y muestra cómo usar y administrarlos.

Descripción larga

Un complemento de Windows PowerShell es un ensamblado de Microsoft .NET Framework que puede contener proveedores y cmdlets de Windows PowerShell. Windows PowerShell incluye un conjunto de complementos básicos, pero puede ampliar la potencia y el valor de Windows PowerShell agregando complementos que contengan proveedores y cmdlets que cree o obtenga de otros usuarios.

Al agregar un complemento, los cmdlets y proveedores que contiene están disponibles inmediatamente para su uso en la sesión actual, pero el cambio afecta solo a la sesión actual.

Para agregar el complemento a todas las sesiones futuras, guárdela en el perfil de Windows PowerShell. También puede usar el Export-Console cmdlet para guardar los nombres de complemento en un archivo de consola y, a continuación, usar esa configuración guardada en sesiones futuras.

A partir de Windows PowerShell 3.0, los cmdlets que se incluyen con PowerShell se empaquetan en módulos. La excepción es Microsoft.PowerShell.Core, que es el único complemento restante. El complemento Microsoft.PowerShell.Core se carga en cada sesión de forma predeterminada. Los módulos restantes se cargan automáticamente en el primer uso. Para obtener más información, consulte about_Modules.

Buscar un complemento

Para obtener una lista de los complementos de Windows PowerShell en el equipo, escriba:

Get-PSSnapin

Para obtener el complemento para cada proveedor de Windows PowerShell, escriba:

Get-PSProvider | Format-List name, pssnapin

Para obtener todos los complementos registrados en el sistema o para comprobar que un complemento está registrado, escriba:

Get-PSSnapin -registered

Para obtener una lista de los cmdlets de un complemento de Windows PowerShell, escriba:

Get-Command -Module <snap-in_name>

Instalación de un complemento

Los complementos integrados se registran en el sistema y se agregan a la sesión predeterminada al iniciar Windows PowerShell. Sin embargo, debe registrar complementos que cree o obtenga de otros usuarios y, a continuación, agregar los complementos a la sesión.

Agregar un complemento a la sesión actual

Para agregar un complemento registrado a la sesión actual, use el Add-PsSnapin cmdlet . Por ejemplo, para agregar el complemento Microsoft SQL Server a la sesión, escriba:

Add-PSSnapin sql

Una vez completado el comando, los proveedores y cmdlets del complemento están disponibles en la sesión. Sin embargo, solo están disponibles en la sesión actual a menos que los guarde.

Guardar complementos

Para usar un complemento en futuras sesiones de Windows PowerShell, agregue el Add-PsSnapin comando al perfil de Windows PowerShell. O bien, exporte los nombres de complemento a un archivo de consola.

Si agrega el Add-PSSnapin comando a su perfil, está disponible en todas las sesiones futuras de Windows PowerShell. Si exporta los nombres de los complementos de la sesión, puede usar el archivo de exportación solo cuando necesite los complementos.

Para agregar el Add-PsSnapin comando al perfil de Windows PowerShell, abra el perfil, pegue o escriba el comando y, a continuación, guarde el perfil. Para obtener más información, consulte about_Profiles.

Para guardar los complementos de una sesión en el archivo de consola (.psc1), use el Export-Console cmdlet . Por ejemplo, para guardar los complementos en la configuración de sesión actual en el NewConsole.psc1 archivo del directorio actual, escriba:

Export-Console NewConsole

Para obtener más información, vea Export-Console.

Abrir Windows PowerShell mediante un archivo de consola

Para usar un archivo de consola que incluya el complemento, inicie Windows PowerShell (powershell.exe) desde el símbolo del sistema en cmd.exe o en otra sesión de Windows PowerShell. Use el parámetro PsConsoleFile para especificar el archivo de consola que incluye el complemento. Por ejemplo, el siguiente comando inicia Windows PowerShell con el archivo de NewConsole.psc1 consola:

PowerShell.exe -psconsolefile NewConsole.psc1

Los proveedores y cmdlets del complemento ya están disponibles para su uso en la sesión.

Quitar un complemento

Para quitar un complemento de Windows PowerShell de la sesión actual, use el Remove-PsSnapin cmdlet . Por ejemplo, para quitar el complemento de SQL Server de la sesión actual, escriba:

Remove-PSSnapin sql

Este cmdlet quita el complemento de la sesión. El complemento todavía se carga, pero los proveedores y cmdlets que admite ya no están disponibles.

Registrar eventos de complemento

A partir de Windows PowerShell 3.0, puede registrar eventos de ejecución para los cmdlets de los módulos y complementos de Windows PowerShell estableciendo la propiedad LogPipelineExecutionDetails de módulos y complementos en $true. Para obtener más información, consulte about_EventLogs.

Consulte también