Get-PSProvider

Referência

Módulo:: Microsoft.PowerShell.Management

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 unidade específica ou todas as unidades 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 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

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 fornecedores à 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 originários de um snap-in ou de 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 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[]
Position:	0
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

Entradas

String

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

Saídas

ProviderInfo

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

Partilhar via