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 https://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