Get-PSProvider

Referência

Módulo:: Microsoft.PowerShell.Management

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

Sintaxe

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

Description

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

Os provedores do Windows 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 Windows PowerShell, consulte about_Providers.

Exemplos

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

PS C:\> Get-PSProvider

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

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

PS C:\> Get-PSProvider f*, r* | Format-List

Este comando exibe uma lista de todos os provedores do Windows 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

PS C:\> Get-PSProvider | Format-Table name, module, pssnapin -auto

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

PS C:\> Get-PSProvider | Where {$_.pssnapin -eq "Microsoft.PowerShell.Security"}

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

Esses comandos encontram os snap-ins ou módulos do Windows PowerShell que adicionaram provedores à sessão. Todos os elementos do Windows 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 usa o cmdlet Where-Object 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

PS 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 Windows 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:	True

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 Windows PowerShell na sessão.

Compartilhar via