Compartilhar via


about_Providers

TÓPICO
    about_Providers

DESCRIÇÃO RESUMIDA
    Descreve como os provedores do Windows PowerShell fornecem acesso 
    a dados e componentes que, de outra forma, não estariam facilmente 
    acessíveis na linha de comando. Os dados são apresentados em um 
    formato consistente semelhante a uma unidade do sistema de arquivos.


DESCRIÇÃO LONGA
    Os provedores do Windows PowerShell são programas baseados no 
    Microsoft .NET Framework que disponibilizam no Windows PowerShell 
    os dados contidos em um repositório especializado. Dessa forma, 
    você pode exibi-los e gerenciá-los.
 

    Os dados que um provedor expõe aparecem em uma unidade e você 
    acessa os dados em um caminho da mesma forma que faria em uma 
    unidade de disco rígido. Você pode usar qualquer um dos cmdlets 
    internos suportados pelo provedor para gerenciar os dados na 
    unidade do provedor. Além disso, é possível usar os cmdlets 
    personalizados que foram projetados especialmente para obter 
    os dados. 


    Os provedores também podem adicionar parâmetros dinâmicos aos 
    cmdlets internos. Esses parâmetros só estão disponíveis quando 
    você usa o cmdlet com os dados do provedor.


PROVEDORES INTERNOS
    O Windows PowerShell inclui um conjunto de provedores internos 
    que pode ser usado para acessar diferentes tipos de repositórios 
    de dados.


    Provedor            Unidade     Repositório de dados
    -----------------   ---------   ----------------------------------------
    Alias               Alias:      Aliases do Windows PowerShell
 
    Certificate         Cert:       Certificados x509 para assinaturas digitais

    Environment         Env:        Variáveis de ambiente do Windows

    FileSystem          *       Unidades do sistema de arquivos, 
                        diretórios e arquivos

    Function            Function:   Funções do Windows PowerShell

    Registry            HKLM:, HKCU Registro do Windows

    Variable            Variable:   Variáveis do Windows PowerShell

    WS-Management   WSMan       Informações de configuração de WS-Management

   *As unidades FileSystem variam em cada ambiente.

    Também é possível criar seus próprios provedores do Windows 
    PowerShell e instalar provedores desenvolvidos por terceiros. 
    Para listar os provedores disponíveis na sua sessão, digite:

       get-psprovider


INSTALAÇÃO E REMOÇÃO DE PROVEDORES
    Os provedores do Windows PowerShell são enviados a você nos 
    snap-ins do Windows PowerShell, que são programas baseados no 
    .NET Framework compilados em arquivos .dll. Os snap-ins podem 
    incluir provedores e cmdlets.


    Antes de usar os recursos do provedor, você precisa instalar 
    o snap-in e adicioná-lo à sessão do Windows PowerShell. 
    Para obter mais informações, consulte about_PsSnapins.


    Não é possível desinstalar um provedor, embora você possa remover 
    o snap-in do Windows PowerShell para o provedor na sessão atual. 
    Se fizer isso, você removerá todo o conteúdo do snap-in, incluindo 
    os cmdlets.


    Para remover um provedor da sessão atual, use o cmdlet Remove-PsSnapin. 
    Esse cmdlet não desinstala o provedor, mas torna o provedor indisponível 
    na sessão.


    Também é possível usar o cmdlet Remove-PsDrive para remover 
    qualquer unidade da sessão atual. Os dados na unidade não são 
    afetados, mas a unidade não estará mais disponível nessa sessão 
    do console.


EXIBIÇÃO DE PROVEDORES
    Para exibir os provedores do Windows PowerShell no seu 
    computador, digite:

    get-psprovider


    A saída lista os provedores internos e os provedores que você 
    adicionou à sessão.


OS CMDLETS DE PROVEDOR
    Os cmdlets a seguir foram projetados para trabalhar com os dados 
    expostos por qualquer provedor. Você pode usar os mesmos cmdlets 
    da mesma maneira para gerenciar os diferentes tipos de dados 
    expostos pelos provedores. Depois que você aprende a gerenciar os 
    dados de um provedor, pode aplicar os mesmos procedimentos aos 
    dados de qualquer outro provedor.
     

    Por exemplo, o cmdlet New-Item cria um novo item. Na unidade C: 
    suportada pelo provedor FileSystem, você pode usar New-Item para 
    criar um novo arquivo ou uma nova pasta. Nas unidades suportadas pelo 
    provedor Registry, você pode usar New-Item para criar uma nova chave 
    do Registro. Na unidade Alias:, você pode usar New-Item para criar um 
    novo alias.
 

    Para obter informações detalhadas sobre qualquer um dos cmdlets 
    a seguir, digite:

        get-help <nome-do-cmdlet> -detailed

    
    CMDLETS CHILDITEM
        Get-ChildItem

    CMDLETS DE CONTEÚDO
        Add-Content
        Clear-Content
        Get-Content
        Set-Content

    CMDLETS DE ITEM
        Clear-Item
        Copy-Item
        Get-Item
        Invoke-Item
        Move-Item
        New-Item
        Remove-Item
        Rename-Item
        Set-Item

    CMDLETS ITEMPROPERTY
        Clear-ItemProperty
        Copy-ItemProperty
        Get-ItemProperty
        Move-ItemProperty
        New-ItemProperty
        Remove-ItemProperty
        Rename-ItemProperty
        Set-ItemProperty

    CMDLETS DE LOCALIZAÇÃO
        Get-Location
        Pop-Location
        Push-Location
        Set-Location

    CMDLETS DE CAMINHO
        Join-Path
        Convert-Path
        Split-Path
        Resolve-Path
        Test-Path

    CMDLETS PSDRIVE
        Get-PSDrive
        New-PSDrive
        Remove-PSDrive

    CMDLETS PSPROVIDER
        Get-PSProvider


EXIBIÇÃO DE DADOS DO PROVEDOR
    O principal benefício de um provedor é que ele expõe seus dados 
    de maneira familiar e consistente. O modelo de apresentação de 
    dados é uma unidade do sistema de arquivos.
 

    Para usar dados expostos pelo provedor, exiba-os, navegue por 
    esses dados e altere-os, mesmo que estejam em uma unidade de 
    disco rígido. Portanto, a informação mais importante sobre um 
    provedor é o nome da unidade que recebe suporte do provedor.


    A unidade é relacionada na exibição padrão do cmdlet Get-PsProvider, 
    mas é possível obter informações sobre a unidade do provedor 
    usando o cmdlet Get-PsDrive. Por exemplo, para obter todas as 
    propriedades da unidade Function:, digite:

    get-psdrive Function | format-list *


    Você pode exibir e navegar pelos dados em uma unidade do provedor 
    da mesma forma que faria em uma unidade do sistema de arquivos.
 

    Para exibir o conteúdo de uma unidade do provedor, use o cmdlet 
    Get-Item ou Get-ChildItem. Digite o nome da unidade seguido de 
    dois-pontos (:). Por exemplo, para exibir o conteúdo da unidade 
    Alias:, digite:

        get-item alias:


    É possível exibir e gerenciar os dados em qualquer unidade 
    a partir de outra unidade, incluindo o nome da unidade no caminho. 
    Por exemplo, para exibir a chave de registro HKLM\Software na 
    unidade HKLM: de outra unidade, digite:

        get-childitem hklm:\software


    Para abrir a unidade, use o cmdlet Set-Location. Lembre-se de 
    incluir os dois-pontos ao especificar o caminho da unidade. Por 
    exemplo, para alterar seu local para o diretório raiz da unidade 
    Cert:, digite:

        set-location cert:


    Em seguida, para exibir o conteúdo da unidade Cert:, digite:

    get-childitem


NAVEGAÇÃO EM DADOS HIERÁRQUICOS
    Você pode mover-se por uma unidade de provedor da mesma forma que 
    faria em uma unidade de disco rígido. Se os dados estiverem 
    organizados em uma hierarquia de itens dentro de itens, use uma barra 
    invertida (\) para indicar um item filho. Use o seguinte formato:

    drive:\location\child-location\...


    Por exemplo, para alterar seu local para a chave do Registro 
    HKLM\Software, digite um comando Set-Location, como:

        set-location hklm:\software


    É possível também usar referências relativas para locais. Um ponto (.) 
    representa o local atual. Por exemplo, se você estiver na chave do 
    Registro HKLM:\Software\Microsoft e quiser listar as subchaves do 
    Registro na chave HKLM:\Software\Microsoft\PowerShell, digite este 
    comando:

        get-childitem .\powershell 


LOCALIZAÇÃO DE PARÂMETROS DINÂMICOS
    Parâmetros dinâmicos são parâmetros cmdlet adicionados a um cmdlet 
    por um provedor. Esses parâmetros só estão disponíveis quando 
    o cmdlet é usado com o provedor que os adicionou.
 

    Por exemplo, a unidade Cert: adiciona o parâmetro CodeSigningCert aos 
    cmdlets Get-Item e Get-ChildItem. Você só pode usar esse parâmetro 
    quando usar Get-Item ou Get-ChildItem na unidade Cert:.


    Para obter uma lista dos parâmetros dinâmicos que recebem suporte 
    de um provedor, consulte o arquivo de Ajuda para o provedor. Digite:

    get-help <nome_do_provedor>


    Por exemplo:

    get-help certificate


INFORMAÇÕES SOBRE PROVEDORES
    Embora todos os dados de provedores sejam exibidos em unidades 
    e os mesmos métodos sejam utilizados para navegar por esses dados, 
    não há muitas semelhanças entre os provedores. Os repositórios de 
    dados que podem ser expostos pelo provedor variam tanto quanto os 
    locais do Active Directory e das caixas de correio do Microsoft 
    Exchange Server.


    Para obter informações sobre os provedores individuais do Windows 
    PowerShell, digite:

    get-help <ProviderName>


    Por exemplo:

    get-help registry


    Para obter uma lista de tópicos da Ajuda sobre os provedores, digite:

    get-help * -category provider       


CONSULTE TAMBÉM
    about_Locations
    about_Path_Syntax