about_PSSnapins

Se aplica a: Windows PowerShell 2.0, Windows PowerShell 3.0

TEMA

about_PSSnapins

DESCRIPCIÓN BREVE

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

DESCRIPCIÓN LARGA

Un complemento de Windows PowerShell es un ensamblado de Microsoft .NET Framework que contiene proveedores y cmdlets de Windows PowerShell. Windows PowerShell incluye un conjunto de complementos básicos, pero puede ampliar la eficacia y el valor de Windows PowerShell agregando complementos que contengan proveedores y cmdlets creados por su cuenta u obtenidos de terceros.

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

Para agregar el complemento a todas las sesiones futuras, guárdelo en su perfil de Windows PowerShell. También puede usar el cmdlet Export-Console para guardar los nombres de complemento en un archivo de consola y usarlo en sesiones futuras. Incluso puede guardar varios archivos de consola, cada uno de ellos con un conjunto diferente de complementos.

BUSCAR COMPLEMENTOS

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

       get-pssnapin

Para obtener el complemento de 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>

INSTALAR UN COMPLEMENTO

Los complementos integrados están registrados en el sistema y se agregan a la sesión de manera predeterminada al iniciar Windows PowerShell. Sin embargo, debe registrar los complementos que cree por su cuenta u obtenga de terceros y, posteriormente, agregarlos a la sesión.

REGISTRAR UN COMPLEMENTO

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

La mayoría de los complementos incluyen un programa de instalación (un archivo .exe o .msi) que registra automáticamente el archivo .dll. Sin embargo, si recibe un complemento como un archivo .dll, puede registrarlo en el sistema. Para obtener más información, vea "Cómo registrar cmdlets, proveedores y aplicaciones host" de MSDN (Microsoft Developer Network) Library, en https://go.microsoft.com/fwlink/?LinkID=143619.

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

       get-pssnapin -registered

AGREGAR EL COMPLEMENTO 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 de Microsoft SQL Server a la sesión, escriba:

       add-pssnapin sql

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

GUARDAR LOS COMPLEMENTOS

Para usar un complemento en sesiones futuras de Windows PowerShell, agregue el comando Add-PsSnapin a su perfil de Windows PowerShell. También puede exportar 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 a su perfil de Windows PowerShell, abra el perfil, pegue o escriba el comando y 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 la sesión actual en el archivo NewConsole.psc1 en el directorio actual, escriba:

Insertar el cuerpo de la sección aquí.

       export-console NewConsole

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

ABRIR WINDOWS POWERSHELL CON UN ARCHIVO DE CONSOLA

Para usar un archivo de consola que incluye 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 comando siguiente inicia Windows PowerShell con el archivo de consola NewConsole.psc1:

       PowerShell.exe -psconsolefile NewConsole.psc1

Los proveedores y los cmdlets del complemento ahora 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 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 se carga igualmente, pero ya no están disponibles los proveedores y los cmdlets que admite.

COMANDOS INTEGRADOS

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

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

• Microsoft.PowerShell.Core
  Contiene los proveedores y los cmdlets que se usan para administrar las características básicas de Windows PowerShell. Incluye los proveedores FileSystem, Registry, Alias, Environment, Function y Variable, y cmdlets básicos como Get-Help, Get-Command y Get-History.

• Microsoft.PowerShell.Host
  Contiene cmdlets que usa 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 Certificate 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.

REGISTRAR EVENTOS DE COMPLEMENTO

A partir de Windows PowerShell 3.0, puede registrar eventos de ejecución para los cmdlets en módulos y complementos de Windows PowerShell estableciendo en TRUE la propiedad LogPipelineExecutionDetails de los módulos y los complementos. Para obtener más información, vea about_EventLogs (https://go.microsoft.com/fwlink/?LinkID=113224).

VEA TAMBIÉN

Add-PsSnapin

Get-PsSnapin

Remove-PsSnapin

Export-Console

Get-Command

about_Profiles

about_Modules

PALABRAS CLAVE: about_Snapins, about_Snap_ins, about_Snap-ins