Sobre PSSnapins

Artigo
06/21/2023

DESCRIÇÃO BREVE

Descreve Windows PowerShell snap-ins e mostra como usá-los e gerenciá-los.

DESCRIÇÃO LONGA

Um snap-in Windows PowerShell é um assembly do Microsoft .NET Framework que contém provedores de Windows PowerShell e/ou cmdlets. Windows PowerShell inclui um conjunto de snap-ins básicos, mas você pode estender a potência e o valor de Windows PowerShell adicionando snap-ins que contêm provedores e cmdlets que você cria ou obtém de outras pessoas.

Quando você adiciona um snap-in, os cmdlets e provedores que ele contém ficam imediatamente disponíveis para uso na sessão atual, mas a alteração afeta apenas a sessão atual.

Para adicionar o snap-in a todas as sessões futuras, salve-o em seu perfil de Windows PowerShell. Você também pode usar o cmdlet Export-Console para salvar os nomes de snap-in em um arquivo de console e usá-lo em sessões futuras. Você pode até mesmo salvar vários arquivos de console, cada um com um conjunto diferente de snap-ins.

OBSERVAÇÃO: Windows PowerShell snap-ins (PSSnapins) estão disponíveis para uso no Windows PowerShell 3.0 e Windows PowerShell 2.0. Eles podem estar alterados ou indisponíveis nas versões subsequentes. Para compactar provedores e cmdlets do Windows PowerShell, use módulos. Para obter informações sobre como criar módulos e converter snap-ins em módulos, consulte Escrevendo um módulo de Windows PowerShell.

LOCALIZANDO SNAP-INS

Para obter uma lista dos snap-ins Windows PowerShell no computador, digite:

Get-PSSnapin

Para obter o snap-in de cada provedor de Windows PowerShell, digite:

Get-PSProvider | Format-List name, pssnapin

Para obter uma lista dos cmdlets em um snap-in Windows PowerShell, digite:

Get-Command -Module <snap-in_name>

INSTALANDO UM SNAP-IN

Os snap-ins internos são registrados no sistema e adicionados à sessão padrão quando você inicia Windows PowerShell. No entanto, você precisa registrar snap-ins que você cria ou obtém de outras pessoas e, em seguida, adicionar os snap-ins à sessão.

REGISTRAR UM SNAP-IN

Um snap-in Windows PowerShell é um programa escrito em uma linguagem .NET Framework que é compilada em um arquivo .dll. Para usar os provedores e cmdlets em um snap-in, primeiro você deve registrar o snap-in (adicioná-lo ao registro).

A maioria dos snap-ins inclui um programa de instalação (um arquivo .exe ou .msi) que registra o arquivo de .dll para você. No entanto, se você receber um snap-in como um arquivo .dll, poderá registrá-lo em seu sistema. Para obter mais informações, consulte Como registrar cmdlets, provedores e aplicativos host na biblioteca MSDN.

Para obter todos os snap-ins registrados em seu sistema ou verificar se um snap-in está registrado, digite:

Get-PSSnapin -registered

ADICIONANDO O SNAP-IN À SESSÃO ATUAL

Para adicionar um snap-in registrado à sessão atual, use o cmdlet Add-PSSnapin. Por exemplo, para adicionar o snap-in do Microsoft SQL Server à sessão, digite:

Add-PSSnapin sql

Depois que o comando for concluído, os provedores e cmdlets no snap-in estarão disponíveis na sessão. No entanto, eles só estão disponíveis na sessão atual, a menos que você os salve.

SALVANDO OS SNAP-INS

Para usar um snap-in em sessões de Windows PowerShell futuras, adicione o comando Add-PSSnapin ao seu perfil de Windows PowerShell. Ou exporte os nomes de snap-in para um arquivo de console.

Se você adicionar o comando Add-PSSnapin ao seu perfil, ele estará disponível em todas as sessões futuras Windows PowerShell. Se você exportar os nomes dos snap-ins em sua sessão, poderá usar o arquivo de exportação somente quando precisar dos snap-ins.

Para adicionar o comando Add-PSSnapin ao perfil Windows PowerShell, abra o perfil, cole ou digite o comando e salve o perfil. Para obter mais informações, consulte about_Profiles.

Para salvar os snap-ins de uma sessão no arquivo de console (.psc1), use o cmdlet Export-Console. Por exemplo, para salvar os snap-ins na configuração da sessão atual no arquivo NewConsole.psc1 no diretório atual, digite:

Export-Console NewConsole

Para obter mais informações, consulte Export-Console.

ABRINDO O WINDOWS POWERSHELL COM UM ARQUIVO DE CONSOLE

Para usar um arquivo de console que inclua o snap-in, inicie Windows PowerShell (PowerShell.exe) no prompt de comando em Cmd.exe ou em outra sessão de Windows PowerShell. Use o parâmetro PsConsoleFile para especificar o arquivo de console que inclui o snap-in. Por exemplo, o comando a seguir inicia Windows PowerShell com o arquivo de console NewConsole.psc1:

PowerShell.exe -psconsolefile NewConsole.psc1

Os provedores e cmdlets no snapin agora estão disponíveis para uso na sessão.

REMOVENDO UM SNAP-IN

Para remover um snap-in Windows PowerShell da sessão atual, use o cmdlet Remove-PSSnapin. Por exemplo, para remover o snap-in SQL Server da sessão atual, digite:

Remove-PSSnapin sql

Esse cmdlet remove o snap-in da sessão. O snap-in ainda está carregado, mas os provedores e cmdlets aos quais ele dá suporte não estão mais disponíveis.

COMANDOS INTERNOS

No Windows PowerShell 2.0 e em programas host de estilo mais antigo no Windows PowerShell 3.0 e posteriores, os comandos internos instalados com Windows PowerShell são empacotados em snap-ins que são adicionados automaticamente a cada sessão Windows PowerShell.

A partir do Windows PowerShell 3.0, em programas host de estilo mais recente , aqueles que iniciam sessões usando o método InitialSessionState.CreateDefault2 , os comandos internos são empacotados em módulos. A exceção é Microsoft.PowerShell.Core, que sempre aparece como um snap-in. O snap-in Core é incluído em todas as sessões por padrão. Os módulos internos são carregados automaticamente no primeiro uso.

OBSERVAÇÃO: sessões remotas, incluindo sessões iniciadas usando o cmdlet New-PSSession, são sessões de estilo mais antigo nas quais os comandos internos são empacotados em snap-ins.

Os snap-ins (ou módulos) a seguir são instalados com Windows PowerShell.

Microsoft.PowerShell.Core – contém provedores e cmdlets usados para gerenciar os recursos básicos do Windows PowerShell. Ele inclui os provedores FileSystem, Registry, Alias, Environment, Function e Variable e cmdlets básicos, como Get-Help, Get-Command e Get-History.
Microsoft.PowerShell.Host - Contém cmdlets usados pelo host Windows PowerShell, como Start-Transcript e Stop-Transcript.
Microsoft.PowerShell.Management – contém cmdlets como Get-Service e Get-ChildItem que são usados para gerenciar recursos baseados no Windows.
Microsoft.PowerShell.Security – contém o provedor de certificados e os cmdlets usados para gerenciar Windows PowerShell segurança, como Get-Acl, Get-AuthenticodeSignature e ConvertTo-SecureString.
Microsoft.PowerShell.Utility – contém cmdlets usados para manipular objetos e dados, como Get-Member, Write-Host e Format-List.
Microsoft.WSMan.Management - Contém o provedor WSMan e os cmdlets que gerenciam o serviço de Gerenciamento Remoto do Windows, como Connect-WSMan e Enable-WSManCredSSP.

REGISTRAR EVENTOS DE SNAP-IN EM LOG

A partir do Windows PowerShell 3.0, você pode registrar eventos de execução para os cmdlets em módulos e snap-ins do Windows PowerShell definindo a propriedade LogPipelineExecutionDetails de módulos e snap-ins como TRUE. Para obter mais informações, consulte about_EventLogs.