Compartilhar via


Get-PSProvider

Obtém informações sobre o provedor do PowerShell especificado.

Sintaxe

Get-PSProvider
   [[-PSProvider] <String[]>]
   [<CommonParameters>]

Description

O Get-PSProvider cmdlet obtém os provedores do PowerShell na sessão atual. Você pode obter uma determinada unidade ou todas as unidades existentes na sessão.

Os provedores do PowerShell permitem que você acesse uma variedade de armazenamentos de dados como se fossem unidades do sistema de arquivos. Para obter informações sobre provedores do PowerShell, consulte about_Providers.

Exemplos

Exemplo 1: Exibir uma lista de todos os provedores disponíveis

Get-PSProvider

Esse comando exibe uma lista de todos os provedores do PowerShell disponíveis.

Exemplo 2: exibir uma lista de todos os provedores do PowerShell que começam com letras especificadas

Get-PSProvider f*, r* | Format-List

Esse comando exibe uma lista de todos os provedores do PowerShell com nomes que começam com a letra f ou r.

Exemplo 3: Localizar snap-ins ou módulos que adicionaram provedores à sua sessão

Get-PSProvider | Format-Table Name, Module, PSSnapIn -AutoSize

Name        Module                        PSSnapIn
----        ------                        --------
Registry                                  Microsoft.PowerShell.Core
Alias                                     Microsoft.PowerShell.Core
Environment                               Microsoft.PowerShell.Core
FileSystem                                Microsoft.PowerShell.Core
Function                                  Microsoft.PowerShell.Core
Variable                                  Microsoft.PowerShell.Core
Certificate Microsoft.PowerShell.Security
WSMan       Microsoft.WSMan.Management

Get-PSProvider | Where {$_.ModuleName -eq "Microsoft.PowerShell.Security"}

Name            Capabilities      Drives
----            ------------      ------
Certificate     ShouldProcess     {cert}

Esses comandos localizam os snap-ins ou módulos do PowerShell que adicionaram provedores à sua sessão. Todos os elementos do PowerShell, incluindo provedores, são originados em um snap-in ou em um módulo.

Esses comandos usam as propriedades PSSnapin e Module do objeto ProviderInfo que Get-PSProvider retorna. Os valores dessas propriedades contêm o nome do snap-in ou módulo que adiciona o provedor.

O primeiro comando obtém todos os provedores existentes na sessão e formata-os em uma tabela com os valores de suas propriedades Name (nome), Module (módulo) e PSSnapin.

O segundo comando usa o Where-Object cmdlet para obter os provedores que vêm do snap-in Microsoft.PowerShell.Security .

Exemplo 4: Resolver o caminho da propriedade Home do provedor do sistema de arquivos

C:\> Resolve-Path ~

Path
----
C:\Users\User01

PS C:\> (get-psprovider FileSystem).home

C:\Users\User01

Este exemplo mostra que o símbolo til (~) representa o valor da propriedade Home do provedor FileSystem. O valor da propriedade Home é opcional, mas para o provedor FileSystem , ele é definido como $env:HOMEDRIVE\$env:HOMEPATH ou $HOME.

Parâmetros

-PSProvider

Especifica o nome ou nomes dos provedores do PowerShell sobre os quais esse cmdlet obtém informações.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

Você pode canalizar uma ou mais cadeias de caracteres de nome de provedor para esse cmdlet.

Saídas

ProviderInfo

Esse cmdlet retorna objetos que representam os provedores do PowerShell na sessão.