Compartir a través de

Get-PSSnapin

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Obtiene los complementos de Windows PowerShell en el equipo.

Sintaxis

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

Description

El cmdlet Get-PSSnapin 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 solo obtiene 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 en MSDN Library.

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 cmdlet Import-Module para importarlos.

Ejemplos

Ejemplo 1: Obtener complementos que están cargados actualmente

PS C:\> Get-PSSnapIn

Este comando obtiene los complementos de Windows PowerShell que se cargan 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 los que ya se han agregado a la sesión. La salida no incluye complementos instalados con Windows PowerShell o bibliotecas de vínculos dinámicos (DLL) de complemento de Windows PowerShell que aún no se han 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.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 instalados 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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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

  • 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 cmdlet New-PSSession, 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 método CreateDefault2 en MSDN Library.