Get-PSSnapin

  • Referência
Módulo:
Microsoft.PowerShell.Core

Obtém os snap-ins do Windows PowerShell presentes no computador.

Sintaxe

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

Description

O Get-PSSnapin cmdlet obtém os snap-ins do Windows PowerShell que foram adicionados à sessão atual ou que foram registrados no sistema. Esse cmdlet lista os snap-ins na ordem em que são detectados.

Get-PSSnapin obtém apenas snap-ins registrados. Para registrar um snap-in do Windows PowerShell, use a ferramenta InstallUtil incluída no Microsoft .NET Framework 2.0. Para obter mais informações, consulte Como registrar cmdlets, provedores e aplicativos host.

A partir do Windows PowerShell 3.0, os comandos principais incluídos no Windows PowerShell são empacotados em módulos. A exceção é Microsoft.PowerShell.Core, que é um snap-in (PSSnapin). Por padrão, somente o snap-in Microsoft.PowerShell.Core é adicionado à sessão. Os módulos são importados automaticamente no primeiro uso e você pode usar o Import-Module cmdlet para importá-los.

Exemplos

Exemplo 1: Obter snap-ins que estão carregados no momento

PS C:\> Get-PSSnapIn

Esse comando obtém os snap-ins do Windows PowerShell que estão atualmente carregados na sessão. Isso inclui os snap-ins instalados com o Windows PowerShell e aqueles que foram adicionados à sessão.

Exemplo 2: Obter snap-ins que foram registrados

PS C:\> get-PSSnapIn -Registered

Esse comando obtém os snap-ins do Windows PowerShell que foram registrados no computador, incluindo aqueles que já foram adicionados à sessão. A saída não inclui snap-ins que são instalados com o Windows PowerShell ou do snap-ins de bibliotecas de vínculo dinâmico (DLLs) do Windows PowerShell que ainda não foram registrados no sistema.

Exemplo 3: Obter snap-ins atuais que correspondem a uma cadeia de caracteres

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

Esse comando obtém os snap-ins do Windows PowerShell na sessão atual que têm nomes que começam com smp.

Parâmetros

-Name

Especifica uma matriz de nomes de snap-in. Esse cmdlet obtém apenas os snap-ins especificados do Windows PowerShell. Caracteres curinga são permitidos.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Registered

Indica que esse cmdlet obtém os snap-ins do Windows PowerShell que foram registrados no sistema, mesmo que ainda não tenham sido adicionados à sessão.

Os snap-ins instalados com o Windows PowerShell não aparecem nessa lista.

Sem esse parâmetro, Get-PSSnapin obtém os snap-ins do Windows PowerShell que foram adicionados à sessão.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Não é possível redirecionar a entrada para este cmdlet.

Saídas

PSSnapInInfo

Get-PSSnapin retorna um objeto para cada snap-in obtido.

Observações

O Windows PowerShell inclui os seguintes aliases para Get-PSSnapin:

  • gsnp

A partir do Windows PowerShell 3.0, os comandos principais instalados com o Windows PowerShell são empacotados em módulos. No Windows PowerShell 2.0 e em programas host que criam sessões de estilo mais antigo em versões posteriores do Windows PowerShell, os comandos principais são empacotados em snap-ins (PSSnapin). A exceção é Microsoft.PowerShell.Core, que é sempre um snap-in. Além disso, as sessões remotas, como as New-PSSession iniciadas pelo cmdlet, são sessões de estilo mais antigo que incluem snap-ins principais.

Para obter informações sobre o método CreateDefault2 que cria sessões de estilo mais recente com módulos principais, consulte Método CreateDefault2.