Sobre o PSSnapins

DESCRIÇÃO BREVE

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

DESCRIÇÃO LONGA

Um snap-in do Windows PowerShell é um assembly do Microsoft .NET Framework que contém provedores e/ou cmdlets do Windows PowerShell. O Windows PowerShell inclui um conjunto de snap-ins básicos, mas você pode estender o poder e o valor do 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 do Windows PowerShell. Você também pode usar o cmdlet Export-Console para salvar os nomes dos snap-ins em um arquivo de console e usá-lo em sessões futuras. Você pode até salvar vários arquivos de console, cada um com um conjunto diferente de snap-ins.

OBSERVAÇÃO: os snap-ins do Windows PowerShell (PSSnapins) estão disponíveis para uso no Windows PowerShell 3.0 e no Windows PowerShell 2.0. Eles podem ser alterados ou indisponíveis em versões subsequentes. Para empacotar cmdlets e provedores 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 do Windows PowerShell.

ENCONTRANDO SNAP-INS

Para obter uma lista dos snap-ins do Windows PowerShell em seu computador, digite:

Get-PSSnapin

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

Get-PSProvider | Format-List name, pssnapin

Para obter uma lista dos cmdlets em um snap-in do 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 o Windows PowerShell. No entanto, você precisa registrar snap-ins criados ou obtidos de outras pessoas e, em seguida, adicionar os snap-ins à sua sessão.

REGISTRANDO UMA SNAP-IN

Um snap-in do Windows PowerShell é um programa escrito em uma linguagem .NET Framework compilado em um arquivo .dll. Para usar os provedores e cmdlets em um snap-in, você deve primeiro 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 .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 para 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 estão disponíveis apenas na sessão atual, a menos que você os salve.

SALVANDO O SNAP-INS

Para usar um snap-in em sessões futuras do Windows PowerShell, adicione o comando Add-PSSnapin ao seu perfil do Windows PowerShell. Ou exporte os nomes dos snap-ins 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 do 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 seu perfil do Windows PowerShell, abra seu 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 o Windows PowerShell (PowerShell.exe) no prompt de comando no Cmd.exe ou em outra sessão do 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 o 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 do Windows PowerShell da sessão atual, use o cmdlet Remove-PSSnapin. Por exemplo, para remover o snap-in do 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.

BUILT-IN COMANDOS

No Windows PowerShell 2.0 e em programas host de estilo mais antigo no Windows PowerShell 3.0 e posterior, os comandos internos instalados com o Windows PowerShell são empacotados em snap-ins que são adicionados automaticamente a cada sessão do 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 Núcleo é incluído em todas as sessões por padrão. Os módulos integrados são carregados automaticamente no primeiro uso.

OBSERVAÇÃO: as sessões remotas, incluindo as 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 o 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 do 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 cmdlets usados para gerenciar a segurança do Windows PowerShell, 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 cmdlets que gerenciam o serviço de Gerenciamento Remoto do Windows, como Connect-WSMan e Enable-WSManCredSSP.

REGISTRANDO SNAP-IN EVENTOS

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.