about_PSSnapins

Aplica-se a: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.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.

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.

• 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