Compartilhar via


about_Pssnapins

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