Acerca do PSSnapins

Artigo
05/09/2024

BREVE DESCRIÇÃO

Descreve Windows PowerShell snap-ins e mostra como utilizá-los e geri-los.

DESCRIÇÃO LONGA

Um Windows PowerShell snap-in é uma assemblagem do Microsoft .NET Framework que contém Windows PowerShell fornecedores e/ou cmdlets. Windows PowerShell inclui um conjunto de snap-ins básicos, mas pode expandir a potência e o valor das Windows PowerShell ao adicionar snap-ins que contêm fornecedores e cmdlets que cria ou obtém de outras pessoas.

Quando adiciona um snap-in, os cmdlets e fornecedores que contém estão imediatamente disponíveis para utilização 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, guarde-o no seu perfil de Windows PowerShell. Também pode utilizar o cmdlet Export-Console para guardar os nomes de snap-in num ficheiro de consola e, em seguida, utilizá-lo em sessões futuras. Pode até guardar vários ficheiros de consola, cada um com um conjunto diferente de snap-ins.

NOTA: Windows PowerShell snap-ins (PSSnapins) estão disponíveis para utilização no Windows PowerShell 3.0 e Windows PowerShell 2.0. Podem ser alterados ou indisponíveis em versões subsequentes. Para empacotar Windows PowerShell cmdlets e fornecedores, utilize módulos. Para obter informações sobre como criar módulos e converter snap-ins em módulos, veja Writing a Windows PowerShell Module (Escrever um Módulo Windows PowerShell).

LOCALIZAR SNAP-INS

Para obter uma lista dos Windows PowerShell snap-ins no seu computador, escreva:

Get-PSSnapin

Para obter o snap-in para cada fornecedor de Windows PowerShell, escreva:

Get-PSProvider | Format-List name, pssnapin

Para obter uma lista dos cmdlets num Windows PowerShell snap-in, escreva:

Get-Command -Module <snap-in_name>

INSTALAR UM SNAP-IN

Os snap-ins incorporados são registados no sistema e adicionados à sessão predefinida quando inicia Windows PowerShell. No entanto, tem de registar snap-ins que cria ou obtém de outras pessoas e, em seguida, adicionar os snap-ins à sua sessão.

REGISTAR UM SNAP-IN

Um Windows PowerShell snap-in é um programa escrito numa linguagem .NET Framework que é compilado num ficheiro .dll. Para utilizar os fornecedores e cmdlets num snap-in, primeiro tem de registar o snap-in (adicioná-lo ao registo).

A maioria dos snap-ins inclui um programa de instalação (um ficheiro .exe ou .msi) que regista o ficheiro de .dll por si. No entanto, se receber um snap-in como um ficheiro .dll, pode registá-lo no seu sistema. Para obter mais informações, veja Como Registar Cmdlets, Fornecedores e Aplicações de Anfitrião na biblioteca do MSDN.

Para obter todos os snap-ins registados no seu sistema ou para verificar se está registado um snap-in, escreva:

Get-PSSnapin -registered

ADICIONAR O SNAP-IN À SESSÃO ATUAL

Para adicionar um snap-in registado à sessão atual, utilize o cmdlet Add-PSSnapin. Por exemplo, para adicionar o snap-in do Microsoft SQL Server à sessão, escreva:

Add-PSSnapin sql

Após a conclusão do comando, os fornecedores e cmdlets no snap-in estão disponíveis na sessão. No entanto, só estão disponíveis na sessão atual, a menos que as guarde.

GUARDAR OS SNAP-INS

Para utilizar um snap-in em futuras sessões de Windows PowerShell, adicione o comando Add-PSSnapin ao seu perfil de Windows PowerShell. Em alternativa, exporte os nomes de snap-in para um ficheiro de consola.

Se adicionar o comando Add-PSSnapin ao seu perfil, este estará disponível em todas as futuras sessões de Windows PowerShell. Se exportar os nomes dos snap-ins na sua sessão, só pode utilizar o ficheiro de exportação quando precisar dos snap-ins.

Para adicionar o comando Add-PSSnapin ao seu perfil de Windows PowerShell, abra o seu perfil, cole ou escreva o comando e, em seguida, guarde o perfil. Para obter mais informações, veja about_Profiles.

Para guardar os snap-ins de uma sessão no ficheiro de consola (.psc1), utilize o cmdlet Export-Console. Por exemplo, para guardar os snap-ins na configuração da sessão atual no ficheiro NewConsole.psc1 no diretório atual, escreva:

Export-Console NewConsole

Para obter mais informações, veja Exportar Consola.

ABRIR O WINDOWS POWERSHELL COM UM FICHEIRO DE CONSOLA

Para utilizar um ficheiro de consola que inclua o snap-in, inicie Windows PowerShell (PowerShell.exe) a partir da linha de comandos no Cmd.exe ou noutra sessão de Windows PowerShell. Utilize o parâmetro PsConsoleFile para especificar o ficheiro de consola que inclui o snap-in. Por exemplo, o seguinte comando começa Windows PowerShell com o ficheiro de consola NewConsole.psc1:

PowerShell.exe -psconsolefile NewConsole.psc1

Os fornecedores e cmdlets no snapin estão agora disponíveis para utilização na sessão.

REMOVER UM SNAP-IN

Para remover um Windows PowerShell snap-in da sessão atual, utilize o cmdlet Remove-PSSnapin. Por exemplo, para remover o SQL Server snap-in da sessão atual, escreva:

Remove-PSSnapin sql

Este cmdlet remove o snap-in da sessão. O snap-in ainda está carregado, mas os fornecedores e cmdlets que suporta já não estão disponíveis.

COMANDOS INCORPORADOS

No Windows PowerShell 2.0 e em programas anfitriões de estilo mais antigo no Windows PowerShell 3.0 e posterior, os comandos incorporados que são instalados com Windows PowerShell são empacotados em snap-ins que são adicionados automaticamente a cada sessão Windows PowerShell.

A partir do Windows PowerShell 3.0, em programas anfitriões de estilo mais recente - aqueles que iniciam sessões com o método InitialSessionState.CreateDefault2 - os comandos incorporados são empacotados em módulos. A exceção é Microsoft.PowerShell.Core, que aparece sempre como um snap-in. Por predefinição, o snap-in Core está incluído em todas as sessões. Os módulos incorporados são carregados automaticamente na primeira utilização.

NOTA: as sessões remotas, incluindo sessões iniciadas com o cmdlet New-PSSession, são sessões de estilo mais antigo nas quais os comandos incorporados são empacotados em snap-ins.

Os seguintes snap-ins (ou módulos) são instalados com Windows PowerShell.

Microsoft.PowerShell.Core - Contém fornecedores e cmdlets utilizados para gerir as funcionalidades básicas do Windows PowerShell. Inclui os fornecedores 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 utilizados pelo anfitrião Windows PowerShell, como Start-Transcript e Stop-Transcript.
Microsoft.PowerShell.Management - Contém cmdlets como Get-Service e Get-ChildItem que são utilizados para gerir funcionalidades baseadas no Windows.
Microsoft.PowerShell.Security - Contém o fornecedor de certificados e cmdlets utilizados para gerir Windows PowerShell segurança, como Get-Acl, Get-AuthenticodeSignature e ConvertTo-SecureString.
Microsoft.PowerShell.Utility - Contém cmdlets utilizados para manipular objetos e dados, como Get-Member, Write-Host e Format-List.
Microsoft.WSMan.Management - Contém o fornecedor E cmdlets WSMan que gerem o serviço de Gestão Remota do Windows, como Connect-WSMan e Enable-WSManCredSSP.

REGISTAR EVENTOS DE SNAP-IN

A partir do Windows PowerShell 3.0, pode gravar eventos de execução para os cmdlets no Windows PowerShell módulos e snap-ins ao definir a propriedade LogPipelineExecutionDetails de módulos e snap-ins como VERDADEIRO. Para obter mais informações, consulte about_EventLogs.