about_PSSnapins
Aplica-se a: Windows PowerShell 2.0, Windows PowerShell 3.0
TÓPICO
about_PSSnapins
DESCRIÇÃO BREVE
Descreve Windows PowerShell snap-ins e mostra como usar e gerenciá-los.
DESCRIÇÃO LONGA
Um Windows PowerShell snap-in é um assembly do Microsoft .NET Framework que contém Windows PowerShell provedores 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 criam ou obtenha de outras pessoas.
Quando você adiciona um snap-in, os cmdlets e provedores que ele contém são imediatamente disponíveis para uso na sessão atual, mas a alteração afeta somente a sessão atual.
Para adicionar o snap-in para todas as futuras sessões, salve-o em seu Windows PowerShell perfil. Você também pode usar o cmdlet Export-Console para salvar os nomes de snap-in em um arquivo de console e, em seguida, usá-los no futuro. Você ainda pode 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 em Windows PowerShell 3.0 e Windows PowerShell 2.0. Eles podem ser alterados ou não estar disponíveis em versões subsequentes. Para empacotar Windows PowerShell cmdlets e provedores, use módulos. Para obter informações sobre como criar módulos e converter os snap-ins em módulos, consulte "escrevendo um Windows PowerShell Module" no MSDN em https://go.microsoft.com/fwlink/?LinkID=141556.
LOCALIZANDO OS SNAP-INS
Para obter uma lista de Windows PowerShell snap-ins no seu computador, digite:
get-pssnapin
Para obter o snap-in para cada Windows PowerShell provedor, 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>
INSTALAÇÃO DE 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ê deve registrar o snap-ins que você cria ou obtém de outras pessoas e, em seguida, adicionar os snap-ins para sua sessão.
REGISTRO DE UM SNAP-IN
Um Windows PowerShell snap-in é um programa gravado em uma linguagem do .NET Framework que é compilada em um arquivo. dll. Para usar os cmdlets e provedores em um snap-in, você deve primeiro registrar o snap-in (Adicionar ao registro).
A maioria dos snap-ins inclui um programa de instalação (um arquivo msi ou. .exe) que registra o arquivo. dll para você. No entanto, se você receber um snap-in como um arquivo. dll, você pode registrá-lo em seu sistema. Para obter mais informações, consulte "Como registrar Cmdlets, provedores e aplicativos de Host" na biblioteca MSDN (Microsoft Developer Network) em https://go.microsoft.com/fwlink/?LinkID=143619.
Para obter todos os snap-ins registrados no sistema ou para verificar se um snap-in é registrado, digite:
get-pssnapin -registered
ADICIONANDO O SNAP-IN PARA A SESSÃO ATUAL
Para adicionar um snap-in registrado para a sessão atual, use o cmdlet Add-PsSnapin. Por exemplo, para adicionar o snap-in do Microsoft SQL Server para a sessão, digite:
add-pssnapin sql
Após o comando ter sido 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 OS SNAP-INS
Para usar um snap-in em sessões Windows PowerShell futuras, adicione o comando Add-PsSnapin ao seu Windows PowerShell perfil. Ou exporte os nomes de snap-in em um arquivo de console.
Se você adicionar o comando Add-PSSnapin ao seu perfil, estará disponível em todas as futuras Windows PowerShell sessões. Se você exportar os nomes dos snap-ins em sua sessão, você pode usar o arquivo de exportação somente quando precisar dos snap-ins.
Para adicionar o comando Add-PsSnapin ao seu Windows PowerShell perfil, abra seu perfil, cole ou digite o comando e, em seguida, 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:
Insira o corpo da seção aqui.
export-console NewConsole
Para obter mais informações, consulte Export-Console.
ABRIR O WINDOWS POWERSHELL COM UM ARQUIVO DE CONSOLE
Para usar um arquivo de console que inclui o snap-in, inicie Windows PowerShell (PowerShell.exe) no prompt de comando em Cmd.exe ou em outra sessão 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 snap-in agora estão disponíveis para uso na sessão.
REMOVENDO UM SNAP-IN
Para remover um Windows PowerShell snap-in da sessão atual, use o cmdlet Remove-PsSnapin. Por exemplo, para remover o snap-in do SQL Server da sessão atual, digite o corpo da sessão Inserte aqui.
remove-pssnapin sql
Esse cmdlet remove o snap-in da sessão. O snap-in ainda é carregado, mas os provedores e cmdlets que ele suporta não estão mais disponíveis.
COMANDOS INTERNOS
No Windows PowerShell 2.0 e em programas do host de estilo antigo no Windows PowerShell 3.0 e posterior, os comandos internos que são instalados com Windows PowerShell são empacotados em snap-ins que são adicionados automaticamente a cada sessão Windows PowerShell.
Começando no Windows PowerShell 3.0, em programas de host com estilo mais novo — aqueles que iniciam a sessão usando o método InitialSessionState.CreateDefault2 – os principais comandos são empacotados em módulos. A exceção é Microsoft.PowerShell.Core, que sempre aparece como um snap-in. O snap-in de núcleo está incluído em cada sessão, por padrão. Os módulos internos são carregados automaticamente no primeiro uso.
Observação
As sessões remotas, inclusive as sessões iniciadas usando o cmdlet New-PSSession, são sessões de estilo antigo no qual os comandos internos são empacotados em snap-ins.
Microsoft.PowerShell.Core
Contém os provedores e cmdlets usados para gerenciar os recursos básicos do Windows PowerShell. Ele inclui os provedores FileSystem, registro, Alias, ambiente, função e variáveis e cmdlets básicos como Get-Help Get-Command e o histórico de Get.
Microsoft.PowerShell.Host
Contém cmdlets usados pelo Windows PowerShell host, como Start-Transcript e Stop-Transcript.
Microsoft.PowerShell.Management
Contém cmdlets, como Get-Service e Get-ChildItem que são usados para gerenciar os recursos baseados em Windows.
Microsoft.PowerShell.Security
Contém o provedor de certificado 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 cmdlets que gerenciam o serviço Windows Remote Management, como conectar WSMan e Enable-WSManCredSSP.
LOG DE EVENTOS DE SNAP-IN
A partir do Windows PowerShell 3.0, você pode registrar eventos de execução para os cmdlets em módulos Windows PowerShell e snap-ins, definindo a propriedade LogPipelineExecutionDetails dos módulos e snap-ins para TRUE. Para obter mais informações, consulte about_EventLogs (https://go.microsoft.com/fwlink/?LinkID=113224).
CONSULTE TAMBÉM
Add-PsSnapin
Get-PsSnapin
Remove-PsSnapin
Export-Console
Get-Command
about_Profiles
about_Modules
about_Snapins, about_Snap_ins, about_Snap-ins