about_Providers

Artigo
06/21/2023

Descrição breve

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 .NET que fornecem acesso a armazenamentos de dados especializados para facilitar a exibição e o gerenciamento. Os dados são exibidos 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 que o provedor dá suporte para gerenciar os dados na unidade do provedor. E você pode usar cmdlets personalizados projetados especialmente para 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 PowerShell inclui um conjunto de provedores internos que você pode usar para acessar os diferentes tipos de armazenamentos de dados.

Provedor	Drive(s)	OutputType
Alias	Alias:	System.Management.Automation.AliasInfo
Certificado	Cert:	Microsoft.PowerShell.Commands.X509StoreLocation
		System.Security.Cryptography.X509Certificates.X509Certificate2
Ambiente	Env:	System.Collections.DictionaryEntry
FileSystem	C: (*)	System.IO.FileInfo
		System.IO.DirectoryInfo
Função	Função:	System.Management.Automation.FunctionInfo
Registro	HKLM: HKCU:	Microsoft.Win32.RegistryKey
Variável	Variável:	System.Management.Automation.PSVariable
WSMan	WSMan:	Microsoft.WSMan.Management.WSManConfigContainerElement

(*) As unidades do FileSystem 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

Observação

Os provedores de Certificado, Registro e WSMan só estão disponíveis na plataforma Windows.

Instalando e removendo provedores

Normalmente, os provedores são instalados por meio de módulos do PowerShell. Importar o módulo carrega o provedor em sua sessão. Não é possível desinstalar os provedores internos. Você pode desinstalar provedores carregados por outros módulos.

Você pode descarregar um provedor da sessão atual usando o Remove-Module cmdlet. Esse cmdlet não desinstala o provedor, mas torna o provedor indisponível na sessão.

Você também pode usar o Remove-PSDrive cmdlet 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 no 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 New-Item cmdlet 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 do Registro , você pode usar New-Item para criar uma nova chave do Registro. Alias: Na unidade, 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

Cmdlets ItemProperty

Cmdlets de localização

Cmdlets de caminho

Cmdlets do 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.

O provedor permite que você exiba, navegue e altere itens no armazenamento de dados como se fossem dados em um sistema de arquivos. O armazenamento de dados é acessado pelo nome da unidade que ele dá suporte.

A unidade está 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 exatamente como faria em uma unidade do sistema de arquivos.

Para exibir o conteúdo de uma unidade de provedor, use os cmdlets Get-Item ou Get-ChildItem. Digite o nome da unidade seguido de dois-pontos (:). Por exemplo, para exibir o conteúdo do Alias: unidade, 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 HKLM\Registro de software no HKLM: unidade 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 do Cert: unidade, digite:

Set-Location cert:

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

Get-ChildItem

Movendo-se através de dados hierárquicos

Você pode mover-se por uma unidade de provedor exatamente como 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 sua localização para a chave do registro HKLM\Software, digite um comando Set-Location, como:

Set-Location HKLM:\SOFTWARE\

Se qualquer elemento no nome totalmente qualificado incluir espaços, você deverá colocar o nome entre aspas duplas ("). O exemplo a seguir mostra um caminho totalmente qualificado que inclui espaços.

"C:\Program Files\Internet Explorer\iexplore.exe"

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

Get-ChildItem .\PowerShell

Além disso, pontos duplos (..) referem-se ao diretório ou contêiner diretamente acima do local atual. Você pode usar dois ponto (..) para navegar por uma hierarquia de provedor.

PS HKLM:\SYSTEM\CurrentControlSet\Services\LanmanServer\Parameters\> cd ..\..\LanmanWorkstation\Parameters
PS HKLM:\SYSTEM\CurrentControlSet\Services\LanmanWorkstation\Parameters>

Página Inicial do Provedor

Os provedores também têm uma localização inicial . Esse local é compartilhado por todos os PSDrives recursos 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\username
Function
Variable
Certificate

O provedor FileSystem é o único provedor que tem um valor padrão para Home. É o mesmo valor que $Home. Para obter mais informações, confira 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 inicial definido, você verá um erro.

Cert:\> Set-Location ~

Set-Location : Home location for this provider isn't 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 ficam disponíveis somente quando o cmdlet é usado com o provedor que os adicionou.

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

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 sejam exibidos em unidades e você use os mesmos métodos para movê-los, a similaridade para lá. Os armazenamentos de dados expostos pelo provedor podem ser tão variados quanto locais do Active Directory e Microsoft Exchange Server caixas de correio.

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

Get-Help <ProviderName>