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.