TÓPICO
about_PSSnapins
DESCRIÇÃO RESUMIDA
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 potencial e o valor do Windows PowerShell adicionando
snap-ins que contêm provedores e cmdlets que você mesmo cria ou obtém
de outras fontes.
Quando você adiciona um snap-in, os cmdlets e os provedores que
ele contém são disponibilizados imediatamente 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 de snap-in em um arquivo de
console e usá-los em sessões futuras.
Você pode até mesmo salvar vários arquivos de console, cada um com um
conjunto diferente de snap-ins.
SNAP-INS INTERNOS
O Windows PowerShell inclui um conjunto de snap-ins que contém
provedores e cmdlets internos.
Microsoft.PowerShell.Core
Contém provedores e cmdlets usados para gerenciar os recursos
básicos do Windows PowerShell. Estão incluídos os provedores
FileSystem, Registry, Alias, Environment, Function e Variable e os
cmdlets básicos, como o Get-Help, Get-Command e o Get-History.
Microsoft.PowerShell.Host
Contém os 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, usados para
gerenciar recursos baseados no Windows.
Microsoft.PowerShell.Security
Contém 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.
ENCONTRANDO OS 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 <nome_do_snap-in>
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ê tem de
registrar os snap-ins que cria ou obter de outras fontes e adicionar
os snap-ins à sua sessão.
REGISTRANDO UM SNAP-IN
Um snap-in do Windows PowerShell é um programa escrito em uma
linguagem do .NET Framework 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 faz o registro do arquivo .dll para
você. Porém, 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 do MSDN
(Microsoft Developer Network) em
http://go.microsoft.com/fwlink/?LinkID=143619.
Para obter todos os snap-ins registrados no 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 é concluído, os provedores e os cmdlets do
snap-in são disponibilizados na sessão. Porém, eles estarã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 futuras do Windows PowerShell,
adicione o comando Add-PsSnapin ao seu perfil do 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 será
disponibilizado em todas as sessões futuras do Windows PowerShell. Se você
exportar os nomes dos snap-ins na sua sessão, só poderá usar o arquivo de
exportação quando precisar dos snap-ins.
Para adicionar o comando Add-PsSnapin ao seu perfil do 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 em um arquivo de console
(.psc1), use o cmdlet Export-Console. Por exemplo, para salvar os
snap-ins da configuração de sessão atual no arquivo NewConsole.psc1 no
diretório atual, digite:
export-console NewConsole
Para obter mais informações, consulte Export-Console.
ABRINDO JANELAS DO POWERSHELL COM UM ARQUIVO DE CONSOLE
Para usar um arquivo de console que inclui o snap-in, inicialize o
Windows PowerShell (Powershell.exe) no prompt de comando em 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 seguinte comando inicia o Windows PowerShell com o arquivo de console
NewConsole.psc1:
powershell.exe -psconsolefile NewConsole.psc1
Os provedores e os cmdlets no snap-in 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 permanecerá
carregado, mas os provedores e os cmdlets aos quais ele oferece
suporte não estarão mais disponíveis.
CONSULTE TAMBÉM
Add-PsSnapin
Get-PsSnapin
Remove-PsSnapin
Export-Console
Get-Command
about_Profiles