Sobre os provedores

Descrição curta

Descreve como os provedores do PowerShell fornecem acesso a dados e componentes que, de outra forma, não seriam facilmente acessíveis na linha de comando. Os dados são apresentados em um formato consistente que se assemelha a uma unidade do sistema de arquivos.

Descrição longa

Os provedores do PowerShell são programas baseados no Microsoft .NET Framework que disponibilizam os dados em um armazenamento de dados especializado no PowerShell para que você possa exibi-los e gerenciá-los.

Os dados que um provedor expõe aparecem em uma unidade e você acessa os dados em um caminho como faria em uma unidade de disco rígido. Você pode usar qualquer um dos cmdlets internos aos quais o provedor dá suporte para gerenciar os dados na unidade do provedor. Além disso, você pode usar cmdlets personalizados que são projetados especialmente para os dados.

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

Provedores internos

O PowerShell inclui um conjunto de provedores internos que você pode usar para acessar os diferentes tipos de armazenamentos de dados.

Fornecedor	Unidade	Armazenamento de dados
Apelido	Cognome:	Aliases do PowerShell
Certificado	Cert:	Certificados X509 para assinaturas digitais
Ambiente	Env:	Variáveis de ambiente do Windows
Sistema de Arquivos	(*)	Unidades, diretórios e arquivos do sistema de arquivos
Função	Função:	Funções do PowerShell
Registro	HKLM:, HKCU:	Registro do Windows
Variável	Variável:	Variáveis do PowerShell
WSMan	WSMan:	WS-Management informações de configuração

(*) As unidades do sistema de arquivos variam em cada sistema.

Você também pode criar seus próprios provedores do PowerShell e instalar provedores que outras pessoas desenvolvem. Para listar os provedores disponíveis em sua sessão, digite:

Get-PSProvider

Instalando e removendo provedores

Os provedores do PowerShell são entregues a você em snap-ins do 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 à sua sessão do PowerShell. Para obter mais informações, consulte about_PSSnapins.

Você não pode desinstalar um provedor, embora possa remover o snap-in do PowerShell para o provedor da sessão atual. Se você fizer isso, removerá todo o conteúdo do snap-in, incluindo seus cmdlets.

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

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 está mais disponível nessa sessão.

Exibindo provedores

Para exibir os provedores do PowerShell em 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 cmdlets a seguir são 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 que os provedores expõem. 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. C: Na unidade com suporte do provedor FileSystem, você pode usar New-Item para criar um novo arquivo ou pasta. Nas unidades compatíveis com o provedor Registry, você pode usar New-Item para criar uma nova chave do Registro. Na unidade de Alias:, você pode usar New-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

Item Cmdlets

Limpar item
de Item de Cópia
Obter Item
Invocar item
Mover Item
Novo item
Remover Item
de renomeação de item
Definir item

Cmdlets ItemProperty

Cmdlets Location

Obter localização
pop-location
de localização por push
Definir localização

Cmdlets Path

de junção de caminho
convert-path
de caminho dividido
resolve-caminho
Caminho de teste

Cmdlets PSDrive

Obter PSDrive
New-PSDrive
Remove-PSDrive

PSProvider Cmdlets

Get-PSProvider

Exibindo 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 os dados que o provedor expõe, você os visualiza, percorre-os e altera-os como se fossem dados em um disco rígido. Portanto, a informação mais importante sobre um provedor é o nome da unidade que ele suporta.

A unidade é listada na exibição padrão do Get-PSProvider cmdlet, mas você pode obter informações sobre a unidade do provedor usando o Get-PSDrive cmdlet. Por exemplo, para obter todas as propriedades da função: unidade, digite:

Get-PSDrive Function | Format-List *

Você pode exibir e mover os 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 os cmdlets Get-Item ou Get-ChildItem. Digite o nome da 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 da unidade no caminho. Por exemplo, para exibir a chave do 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 dos dois-pontos quando você 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

Movendo dados hierárquicos

Você pode mover-se por uma unidade de provedor da mesma forma que faria com 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 seu local para a chave do Registro HKLM\Software, digite um comando Set-Location, como:

Set-Location HKLM:\SOFTWARE\

Você também pode usar referências relativas a locais. Um ponto (.) representa a localização 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 o seguinte comando:

Get-ChildItem .\PowerShell

Página Inicial do Provedor

Os provedores também têm um local Home. Esse local é compartilhado por todos os PSDrives apoiados pelo provedor. Ele pode ser recuperado exibindo a propriedade Home do provedor.

Get-PSProvider | Format-Table Name, Home

Name        Home
----        ----
Registry
Alias
Environment
FileSystem  C:\Users\robreed
Function
Variable
Certificate

O provedor FileSystem é o único provedor que tem um valor padrão para Home. É o mesmo valor que $Home ver about_Automatic_Variables.

Você pode definir o diretório Home para um provedor, para a sessão atual, usando sua propriedade.

(Get-PSProvider FileSystem).Home = "C:\"

O caractere ~ pode ser usado para representar o diretório base do provedor. Se o provedor não tiver um local de Início definido, você verá um erro.

Cert:\> Set-Location ~

Set-Location : Home location for this provider is not set. To set the home
location, call "(get-psprovider 'Certificate').Home = 'path'".
At line:1 char:1
+ Set-Location ~
+ ~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidOperation: (:) [Set-Location],
                              PSInvalidOperationException
...

Localizando parâmetros dinâmicos

Parâmetros dinâmicos são parâmetros de cmdlet que são 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 aos quais um provedor dá suporte, consulte o arquivo de Ajuda para o provedor. Tipo:

Get-Help <provider-name>

Por exemplo:

Get-Help certificate

Aprendendo sobre provedores

Embora todos os dados do provedor apareçam nas unidades e você use os mesmos métodos para percorrê-los, a semelhança para por aí. Os armazenamentos de dados expostos pelo provedor podem ser tão variados quanto os locais do Active Directory e as caixas de correio do Microsoft Exchange Server.

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

Get-Help <ProviderName>