Partilhar via

Get-PSSnapin

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

Obtém os snap-ins do Windows PowerShell 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. Este cmdlet lista os snap-ins na ordem em que são detetados.

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, apenas o snap-in Microsoft.PowerShell.Core é adicionado à sessão. Os módulos são importados automaticamente na primeira utilização 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

Este 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

Este 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 instalados com bibliotecas de vínculo dinâmico (DLLs) de snap-in do Windows PowerShell ou do Windows PowerShell que ainda não foram registradas no sistema.

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

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

Este 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. Este cmdlet obtém apenas os snap-ins especificados do Windows PowerShell. Caracteres curinga são permitidos.

Tipo:String[]
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 nesta lista.

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

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

Saídas

PSSnapInInfo

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

Notas

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 iniciadas New-PSSession 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.