Get-PSSnapin
Obtém os snap-ins do Windows PowerShell no computador.
Sintaxe
Default (Default)
Get-PSSnapin
[[-Name] <String[]>]
[-Registered]
[<CommonParameters>]
Description
O cmdlet Get-PSSnapin 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 somente 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 cmdlet Import-Module 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 instalados com as DLLs (bibliotecas de vínculo dinâmico) do Windows PowerShell ou do Windows PowerShell que ainda não foram registradas no sistema.
Exemplo 3: Obter snap-ins atuais que correspondam 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 do Windows PowerShell especificados. Caracteres curinga são permitidos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
None
Não é possível redirecionar a entrada para este cmdlet.
Saídas
PSSnapInInfo
Get-PSSnapin retorna um objeto para cada snap-in que ele obtém.
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, sessões remotas, como as iniciadas pelo cmdlet New-PSSession, 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.
