Acerca de PSSnapins

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 contiene proveedores o 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 cmdlet Export-Console para guardar los nombres de los complementos en un archivo de consola y, a continuación, usarlo en sesiones futuras. Incluso puede guardar varios archivos de consola, cada uno con un conjunto diferente de complementos.

NOTA: Los complementos de Windows PowerShell (PSSnapins) están disponibles para su uso en Windows PowerShell 3.0 y Windows PowerShell 2.0. Es posible que se modifiquen o no estén disponibles en versiones posteriores. Para empaquetar cmdlets y proveedores de Windows PowerShell, use módulos. Para obtener información sobre cómo crear módulos y convertir complementos en módulos, vea Escribir un módulo de Windows PowerShell.

ENCONTRAR SNAP-INS

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 una lista de los cmdlets de un complemento de Windows PowerShell, escriba:

Get-Command -Module <snap-in_name>

INSTALACIÓN DE UN SNAP-IN

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.

REGISTRO DE UN SNAP-IN

Un complemento de Windows PowerShell es un programa escrito en un lenguaje .NET Framework que se compila en un archivo .dll. Para usar los proveedores y cmdlets en un complemento, primero debe registrar el complemento (agregarlo al registro).

La mayoría de los complementos incluyen un programa de instalación (un archivo de .exe o .msi) que registra el archivo .dll automáticamente. Sin embargo, si recibe un complemento como un archivo .dll, puede registrarlo en su sistema. Para obtener más información, consulte Registro de cmdlets, proveedores y aplicaciones host en MSDN Library.

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

Get-PSSnapin -registered

ADICIÓN DEL SNAP-IN A LA SESIÓN ACTUAL

Para agregar un complemento registrado a la sesión actual, use el cmdlet Add-PSSnapin. 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.

SALVANDO EL SNAP-INS

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

Si agrega el comando Add-PSSnapin a su perfil, estará 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 comando Add-PSSnapin 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 cmdlet Export-Console. Por ejemplo, para guardar los complementos de la configuración de sesión actual en el archivo NewConsole.psc1 del directorio actual, escriba:

Export-Console NewConsole

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

ABRIR WINDOWS POWERSHELL CON 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 consola NewConsole.psc1:

PowerShell.exe -psconsolefile NewConsole.psc1

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

ELIMINACIÓN DE UN SNAP-IN

Para quitar un complemento de Windows PowerShell de la sesión actual, use el cmdlet Remove-PSSnapin. 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.

BUILT-IN COMANDOS

En Windows PowerShell 2.0 y en programas host de estilo antiguo en Windows PowerShell 3.0 y versiones posteriores, los comandos integrados que se instalan con Windows PowerShell se empaquetan en complementos que se agregan automáticamente a cada sesión de Windows PowerShell.

A partir de Windows PowerShell 3.0, en los programas host de estilo más reciente (aquellos que inician sesiones mediante el método InitialSessionState.CreateDefault2), los comandos integrados se empaquetan en módulos. La excepción es Microsoft.PowerShell.Core, que siempre aparece como un complemento. El complemento Principal se incluye en todas las sesiones de forma predeterminada. Los módulos incorporados se cargan automáticamente en el primer uso.

NOTA: Las sesiones remotas, incluidas las sesiones que se inician mediante el cmdlet New-PSSession, son sesiones de estilo antiguo en las que los comandos integrados se empaquetan en complementos.

Los siguientes complementos (o módulos) se instalan con Windows PowerShell.

Microsoft.PowerShell.Core: contiene proveedores y cmdlets que se usan para administrar las características básicas de Windows PowerShell. Incluye los proveedores FileSystem, Registry, Alias, Environment, Function y Variable, así como cmdlets básicos como Get-Help, Get-Command y Get-History.
Microsoft.PowerShell.Host: contiene cmdlets usados por el host de Windows PowerShell, como Start-Transcript y Stop-Transcript.
Microsoft.PowerShell.Management: contiene cmdlets como Get-Service y Get-ChildItem que se usan para administrar características basadas en Windows.
Microsoft.PowerShell.Security: contiene el proveedor de certificados y los cmdlets que se usan para administrar la seguridad de Windows PowerShell, como Get-Acl, Get-AuthenticodeSignature y ConvertTo-SecureString.
Microsoft.PowerShell.Utility: contiene cmdlets usados para manipular objetos y datos, como Get-Member, Write-Host y Format-List.
Microsoft.WSMan.Management: contiene el proveedor de WSMan y los cmdlets que administran el servicio de administración remota de Windows, como Connect-WSMan y Enable-WSManCredSSP.

REGISTRO SNAP-IN EVENTOS

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 los módulos y complementos en TRUE. Para obtener más información, consulte about_EventLogs.