sobre_Fornecedores

Breve descrição

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 de 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 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 suportados pelo provedor para gerenciar os dados na unidade do provedor. Além disso, 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.

Fornecedores integrados

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

(*) As unidades FileSystem variam em cada sistema.

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

Get-PSProvider

Instalação e remoção de fornecedores

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

Você pode descarregar um provedor da sessão atual usando o cmdlet Remove-Module. Esse cmdlet não desinstala o provedor, mas o torna 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.

Visualizando 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 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 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. Na unidade suportada C: pelo provedor FileSystem , você pode usar New-Item para criar um novo arquivo ou pasta. Nas unidades suportadas pelo fornecedor de de registo, pode utilizar New-Item para criar uma nova chave de registo. Na unidade 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

• Adicionar Conteúdo
• Limpar conteúdo
• Get-Content
• Definir conteúdo

Item Cmdlets

• Limpar-Item
• Copiar-Item
• Obter-Item
• Invoke-Item
• Move-Item
• Novo-Item
• Comando "Remove-Item"
• Renomear item
• Definir-Item

Cmdlets ItemProperty

• Clear-ItemProperty
• Copy-ItemProperty
• Get-ItemProperty
• Move-ItemProperty
• New-ItemProperty
• Remove-ItemProperty
• Rename-ItemProperty
• Set-ItemProperty

Cmdlets de localização

• Get-Localização
• de localização pop
• Push-Localização
• Set-Localização

Cmdlets de caminho

• de Caminho de Adesão
• Convert-Path
• de caminhos divididos
• Resolve-Path
• Caminho de teste

Cmdlets PSDrive

• Get-PSDrive
• Novo PSDrive
• Remover-PSDrive

PSProvider Cmdlets

• Get-PSProvider

Visualizando dados do provedor

O principal benefício de um provedor é que ele expõe seus dados de forma familiar e consistente. O modelo para apresentação de dados é uma unidade de sistema de arquivos.

O provedor permite visualizar, navegar e alterar 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 suporta.

A unidade está listada na exibição padrão do cmdlet Get-PSProvider, mas você pode 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 visualizar e mover os dados em uma unidade de provedor da mesma forma que 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 da unidade seguido de dois pontos (:). Por exemplo, para exibir o conteúdo da unidade Alias:, digite:

Get-Item alias:

Você pode visualizar e gerenciar os dados em qualquer unidade de outra unidade incluindo o nome da unidade no caminho. Por exemplo, para visualizar a chave de registo HKLM\Software na unidade HKLM: a partir de outra unidade, escreva:

Get-ChildItem HKLM:\SOFTWARE\

Para abrir a unidade, use o cmdlet Set-Location. Lembre-se dos dois pontos quando 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 visualizar o conteúdo da unidade Cert:, digite:

Get-ChildItem

Movendo-se através de dados hierárquicos

Pode mover-se através de uma unidade de fornecedor tal como faria com uma unidade de disco rígido. Se os dados estiverem organizados em uma hierarquia de itens dentro dos 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\

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 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

Além disso, pontos duplos (..) refere-se ao diretório ou contêiner diretamente acima de sua localização atual. Você pode usar pontos duplos (..) para navegar por uma hierarquia de provedores.

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

Página inicial do provedor

Os fornecedores também têm uma localização Home. Esta localização é partilhada por todos os PSDrives apoiados pelo fornecedor. Ele pode ser recuperado visualizando 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, consulte sobre_Variáveis_Automáticas.

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 Home 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 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 aos cmdlets Get-Item e Get-ChildItem. Você pode usar esse parâmetro somente quando usar Get-Item ou Get-ChildItem na unidade Cert:.

Para obter uma lista dos parâmetros dinâmicos suportados por um provedor, consulte o arquivo de Ajuda do provedor. Tipo:

Get-Help <provider-name>

Por exemplo:

Get-Help certificate

Aprender sobre os fornecedores

Embora todos os dados do provedor apareçam em unidades e você use os mesmos métodos para percorrê-los, a semelhança para aí. Os armazenamentos de dados que o provedor expõe podem ser tão variados quanto locais do Ative Directory e caixas de correio do Microsoft Exchange Server.

Para obter informações sobre provedores individuais do 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

Ver também

• about_Locations
• sobre_Sintaxe_de_Caminhos