Compartilhar via


Get-PSProvider

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

Sintaxe

Default (Padrão)

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

Description

O cmdlet Get-PSProvider 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

Este 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

Este 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 à 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 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 na sessão e os formata em uma tabela com os valores de suas propriedades Name, Module e PSSnapin.

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

Exemplo 4: Resolver o caminho da propriedade Home do provedor FileSystem

C:\> Resolve-Path ~
Path
----
C:\Users\User01
PS C:\> (Get-PSProvider FileSystem).Home
C:\Users\User01

Este exemplo mostra que o símbolo de til (~) representa o valor da propriedade Home do provedor FileSystem. O valor da propriedade Home é opcional, mas para o provedor FileSystem, é 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.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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.