Compartir a través de

Get-PSSnapin

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Obtiene los complementos de Windows PowerShell en el equipo.

Syntax

Get-PSSnapin
   [[-Name] <String[]>]
   [-Registered]
   [<CommonParameters>]

Description

El Get-PSSnapin cmdlet obtiene los complementos de Windows PowerShell que se han agregado a la sesión actual o que se han registrado en el sistema. Este cmdlet enumera los complementos en el orden en que se detectan.

Get-PSSnapin obtiene solo los complementos registrados. Para registrar un complemento de Windows PowerShell, use la herramienta InstallUtil incluida en Microsoft .NET Framework 2.0. Para obtener más información, consulte Registro de cmdlets, proveedores y aplicaciones host.

A partir de Windows PowerShell 3.0, los comandos principales que se incluyen en Windows PowerShell se empaquetan en módulos. La excepción es Microsoft.PowerShell.Core, que es un complemento (PSSnapin). De forma predeterminada, solo se agrega el complemento Microsoft.PowerShell.Core a la sesión. Los módulos se importan automáticamente en el primer uso y puede usar el Import-Module cmdlet para importarlos.

Ejemplos

Ejemplo 1: Obtener complementos que están cargados actualmente

PS C:\> Get-PSSnapIn

Este comando obtiene los complementos de Windows PowerShell cargados actualmente en la sesión. Esto incluye los complementos que se instalan con Windows PowerShell y los que se han agregado a la sesión.

Ejemplo 2: Obtener complementos que se han registrado

PS C:\> get-PSSnapIn -Registered

Este comando obtiene los complementos de Windows PowerShell que se han registrado en el equipo, incluidos aquellos que ya se han agregado a la sesión. Los resultados no incluyen los complementos que se instalan con Windows PowerShell ni las bibliotecas de vínculos dinámicos (DLL) de Windows PowerShell que aún no se hayan registrado en el sistema.

Ejemplo 3: Obtener complementos actuales que coinciden con una cadena

PS C:\> Get-PSSnapIn -Name smp*

Este comando obtiene los complementos de Windows PowerShell en la sesión actual que tienen nombres que comienzan por smp.

Parámetros

-Name

Especifica una matriz de nombres de complemento. Este cmdlet obtiene solo los complementos de Windows PowerShell especificados. Se permiten caracteres comodín.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Registered

Indica que este cmdlet obtiene los complementos de Windows PowerShell que se han registrado en el sistema incluso si aún no se han agregado a la sesión.

Los complementos que se instalan con Windows PowerShell no aparecen en esta lista.

Sin este parámetro, Get-PSSnapin obtiene los complementos de Windows PowerShell que se han agregado a la sesión.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

No se puede canalizar la entrada a este cmdlet.

Salidas

PSSnapInInfo

Get-PSSnapin devuelve un objeto para cada complemento que obtiene.

Notas

Windows PowerShell incluye los siguientes alias para Get-PSSnapin:

  • gsnp

A partir de Windows PowerShell 3.0, los comandos principales que se instalan con Windows PowerShell se empaquetan en módulos. En Windows PowerShell 2.0 y en programas host que crean sesiones de estilo anterior en versiones posteriores de Windows PowerShell, los comandos principales se empaquetan en complementos (PSSnapin). La excepción es Microsoft.PowerShell.Core, que siempre es un complemento. Además, las sesiones remotas, como las iniciadas por el New-PSSession cmdlet, son sesiones de estilo anterior que incluyen complementos principales.

Para obtener información sobre el método CreateDefault2 que crea sesiones de estilo más reciente con módulos principales, vea CreateDefault2 Method.