Get-PSSnapin
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
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.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de