Get-PSProvider

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

Syntax

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 disponíveis do PowerShell.

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ódulo que adicionou provedores à 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 encontram os snap-ins ou módulos do PowerShell que adicionaram provedores à sessão. Todos os elementos do PowerShell, incluindo provedores, se originam 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 provenientes 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 de bloco (~) 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 os nomes dos provedores do PowerShell sobre os quais esse cmdlet obtém informações.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String[]

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

Saídas

ProviderInfo

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