about_Providers
Aplica-se a: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.0
TÓPICO
about_Providers
DESCRIÇÃO BREVE
Descreve como provedores Windows PowerShell fornecem acesso a dados e componentes que não seriam facilmente acessíveis na linha de comando. Os dados são apresentados em um formato consistente que se parece com uma unidade de sistema de arquivos.
DESCRIÇÃO LONGA
Os provedores do Windows PowerShell são programas com base em Microsoft .NET Framework que disponibilizam dados em um armazenamento de dados especializado disponível no Windows PowerShell para que você possa vê-los e gerenciá-los facilmente.
Os dados que um provedor expõe são exibidos em uma unidade, e são exibidos em um caminho da mesma forma como em uma unidade de disco rígido. Você pode usar qualquer um dos cmdlets internos aos quais o provedor dá suporte a fim de gerenciar os dados na unidade do provedor. E, você pode usar os cmdlets personalizados projetados especialmente para os dados.
Os provedores também podem adicionar parâmetros dinâmicos para os cmdlets internos. Esses são os parâmetros disponíveis somente quando você usa o cmdlet com os dados do provedor.
PROVEDORES INTERNOS
O Windows PowerShell inclui um conjunto de provedores internos que você pode usar para acessar os diferentes tipos de armazenamentos de dados.
Provider Drive Data store
-------- ----- ----------
Alias Alias: Windows PowerShell aliases
Certificate Cert: x509 certificates for digital signatures
Environment Env: Windows environment variables
FileSystem * File system drives, directories, and files
Function Function: Windows PowerShell functions
Registry HKLM:, HKCU: Windows registry
Variable Variable: Windows PowerShell variables
WSMan WSMan: WS-Management configuration information
* As unidades do FileSystem variam em cada sistema.
Você também pode criar seus próprios provedores do Windows PowerShell e pode instalar provedores desenvolvidos por outras pessoas. Para listar os provedores disponíveis em sua sessão, digite:
get-psprovider
INSTALAÇÃO E REMOÇÃO DE PROVEDORES
Provedores do Windows PowerShell são entregues em snap-ins do Windows PowerShell, que são programas baseados no .NET Framework compilados em arquivos .dll. Os snap-ins podem incluir cmdlets e provedores.
Antes de usar os recursos do provedor, você precisa instalar o snap-in e, em seguida, adicioná-lo à sessão do Windows PowerShell. Para obter mais informações, consulte about_PSSnapins.
Não é possível desinstalar um provedor, entretanto, é possível remover o snap-in do Windows PowerShell para o provedor da sessão atual. Se você fizer isso, removerá todo o conteúdo do snap-in, incluindo seus cmdlets.
Você também pode usar o cmdlet Remove-PSDrive para remover qualquer unidade da sessão atual. Esses dados na unidade não são afetados, mas a unidade não fica mais disponível nessa sessão.
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 DO PROVEDOR
Os seguintes cmdlets são projetados para funcionar com os dados apresentados por qualquer provedor. Você pode usar os mesmos cmdlets da mesma maneira para gerenciar os diferentes tipos de dados que os provedores apresentam. Depois de aprender a gerenciar os dados de um provedor, você pode usar os mesmos procedimentos com os dados de qualquer provedor.
Por exemplo, o cmdlet New-Item cria um novo item. Na unidade C: à qual o provedor do FileSystem dá suporte, você pode usar Novo Item para criar um novo arquivo ou pasta. Nas unidades com suporte pelo provedor do Registro, você pode usar o novo Item para criar uma nova chave do Registro. Na unidade do Alias: você pode usar o novo Item para criar um novo alias.
Para obter informações detalhadas sobre qualquer um dos seguintes cmdlets, digite:
get-help <cmdlet-name> -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 LOCAL
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 DE PSPROVIDER
Get-PSProvider
EXIBINDO DADOS DE PROVEDOR
O principal benefício de um provedor é que ele expõe seus dados de uma maneira familiar e consistente. O modelo de apresentação de dados é uma unidade de sistema de arquivos.
Para usar dados que o provedor expõe, você os exibe, os altera e passa por eles como se fossem dados em um disco rígido. Portanto, a informação mais importante sobre um provedor é o nome da unidade à qual ele dá suporte.
A unidade está listada na exibição padrão do cmdlet Get-PSProvider, mas você pode obter informações sobre a unidade de provedor usando o cmdlet Get-PSDrive. Por exemplo, para obter todas as propriedades da função: , digite:
get-psdrive Function | format-list *
Você pode exibir e percorrer os dados em uma unidade de provedor, assim como você faria em uma unidade de sistema de arquivos.
Para exibir o conteúdo de uma unidade de provedor, use os cmdlets Get-Item ou Get-ChildItem. Digite o nome de unidade seguido por dois-pontos (:). Por exemplo, para exibir o conteúdo da unidade Alias: , digite:
get-item alias:
Você pode exibir e gerenciar os dados em qualquer unidade de outra unidade, incluindo o nome de unidade no caminho. Por exemplo, para exibir a chave do Registro HKLM\Software. em HKLM: unidade de outra unidade, digite:
get-childitem hklm:\software
Para abrir a unidade, use o cmdlet Set-Location. Lembre-se dos dois-pontos ao especificar o caminho da unidade. Por exemplo, para alterar o local para o diretório raiz do certificado: , digite:
set-location cert:
Em seguida, para exibir o conteúdo do certificado: , digite:
get-childitem
PASSANDO POR DADOS HIERÁRQUICOS
Você pode passar por uma unidade de provedor assim como faria em uma unidade de disco rígido. Se os dados forem 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 o local da chave do Registro HKLM\Software, digite um comando Set-Location, como:
set-location hklm:\software
Você também pode usar referências relativas aos locais. Um ponto (.) representa o local atual. Por exemplo, se você estiver na chave do Registro HKLM:\Software\Microsoft, e deseja listar as subchaves do Registro na chave HKLM:\Software\Microsoft\PowerShell, digite o seguinte comando:
get-childitem .\PowerShell
PARÂMETROS DINÂMICOS DE LOCALIZAÇÃO
Parâmetros dinâmicos são parâmetros de cmdlet adicionados a um cmdlet por um provedor. Esses parâmetros estão disponíveis somente quando o cmdlet é usado com o provedor que os adicionou.
Por exemplo, a unidade Cert: adiciona o parâmetro CodeSigningCert para os cmdlets Get-Item e Get-ChildItem. Você pode usar esse parâmetro somente quando usar o Get-Item ou Get-ChildItem da unidade Cert: .
Para obter uma lista dos parâmetros dinâmicos aos quais um provedor dá suporte, consulte o arquivo de ajuda do provedor. Digite:
get-help <provider-name>
Por exemplo:
get-help certificate
APRENDENDO SOBRE PROVEDORES
Embora todos os dados do provedor sejam exibidos em unidades, você usa os mesmos métodos para passar por eles, a semelhança termina aqui. Os armazenamentos de dados que o provedor expõe podem ser tão diversos como locais do Active Directory e caixas de correio do Microsoft Exchange Server.
Para obter informações sobre provedores Windows PowerShell individuais, 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