Share via


Get-PSProvider

Applies To: Windows PowerShell 2.0

Gets information about the specified Windows PowerShell provider.

Syntax

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

Description

The Get-PSProvider cmdlet gets the Windows PowerShell providers in the current session. You can get a particular drive or all drives in the session.

Windows PowerShell providers let you access a variety of data stores as though they were file system drives. For information about Windows PowerShell providers, see about_Providers.

Parameters

-PSProvider <string[]>

Specifies the name or names of the Windows PowerShell providers about which to retrieve information.

Required?

false

Position?

1

Default Value

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This command supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, OutBuffer, OutVariable, WarningAction, and WarningVariable. For more information, see about_CommonParameters.

Inputs and Outputs

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet returns.

Inputs

None

You cannot pipe objects to this cmdlet.

Outputs

System.Management.Automation.ProviderInfo

Get-PSProvider returns objects that represent the Windows PowerShell providers in the session.

Example 1

C:\PS>get-psprovider

Description
-----------
This command displays a list of all available Windows PowerShell providers.





Example 2

C:\PS>get-psprovider f*, r* | format-list

Description
-----------
This command displays a list of all Windows PowerShell providers with names that begin with the letter "f" or "r".





Example 3

C:\PS>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

C:\PS> get-psprovider | where {$_.pssnapin -eq "Microsoft.PowerShell.Security"}

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

Description
-----------
These commands find the Windows PowerShell snap-ins or modules that added providers to your session. All Windows PowerShell elements, including providers, originate in a snap-in or in a module.

These commands use the PSSnapin and Module properties of the ProviderInfo object that Get-PSProvider returns. The values of these properties contain the name of the snap-in or module that adds the provider.

The first command gets all of the providers in the session and formats them in a table with the values of their Name, Module, and PSSnapin properties.

The second command uses the Where-Object cmdlet to get the providers that come from the Microsoft.PowerShell.Security snap-in.





Example 4

C:\PS>resolve-path ~

Path
----
C:\Users\User01

C:\PS> (get-psprovider FileSystem).home
C:\Users\User01

Description
-----------
This example shows that the tilde symbol (~) represents the value of the Home property of the FileSystem provider. The Home property value is optional, but for the FileSystem provider, it is defined as $env:homedrive\$env:homepath or $home.





See Also

Concepts

about_Providers