Get-PSProvider

NAME Get-PSProvider



SYNOPSIS

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 this cmdlet gets information.



Required? false

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None

You cannot pipe objects to this cmdlet.





OUTPUTS

System.Management.Automation.ProviderInfo

This cmdlet returns objects that represent the Windows PowerShell providers in the session.





NOTES









Example 1: Display a list of all available providers



PS C:\\>Get-PSProvider



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

Example 2: Display a list of all Windows PowerShell providers that begin with specified letters



PS C:\\>Get-PSProvider f*, r* | Format-List



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

Example 3: Find snap-ins or module that added providers to your session



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}



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: Resolve the path of the Home property of the file system provider



PS C:\\>Resolve-Path ~



Path

----

C:\\Users\\User01



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

C:\\Users\\User01



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.



RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?linkid=821592