Get-PSProvider

Módulo:: Microsoft.PowerShell.Management Module

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

Sintaxe

Default (Default)

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 determinada unidade ou todas as unidades existentes 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.

Propriedades do parâmetro

Tipo:	String[]
Valor padrão:	None
Dá suporte a curingas:	True
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 Windows PowerShell na sessão.

Compartilhar via