Get-PSProvider

Gets information about the specified Windows PowerShell provider.

Syntax

	Copy Code
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

	Copy Code
C:\PS>get-psprovider Description ----------- This command displays a list of all available Windows PowerShell providers.

Example 2

	Copy Code
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

	Copy Code
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.

Copy Code

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

	Copy Code
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.