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