Get-PSSubsystem
Retrieves information about the subsystems registered in PowerShell.
Syntax
GetAllSet (Default)
Get-PSSubsystem
[<CommonParameters>]
GetByKindSet
Get-PSSubsystem
-Kind <SubsystemKind>
[<CommonParameters>]
GetByTypeSet
Get-PSSubsystem
-SubsystemType <Type>
[<CommonParameters>]
Description
Retrieves information about the subsystems registered in PowerShell.
Note
This is an experimental feature. This cmdlet is only available when the PSSubsystemPluginModel
feature is enabled. For more information, see
Using Experimental Features.
The feature makes it possible to separate components of System.Management.Automation.dll into
individual subsystems that reside in their own assembly. This separation reduces the disk footprint
of the core PowerShell engine and allows these components to become optional features for a minimal
PowerShell installation.
Currently, only the CommandPredictor subsystem is supported. This subsystem is used along with
the PSReadLine module to provide custom prediction plugins. In future, Job,
CommandCompleter, Remoting and other components could be separated into subsystem assemblies
outside of System.Management.Automation.dll.
Examples
Example 1 - Display all available subsystems
Get-PSSubsystem
Kind SubsystemType IsRegistered Implementations
---- ------------- ------------ ---------------
CommandPredictor ICommandPredictor False {}
Example 2 - Display all available subsystems of a specific kind
PS> Get-PSSubsystem -Kind CommandPredictor | Format-List
Kind : CommandPredictor
SubsystemType : System.Management.Automation.Subsystem.ICommandPredictor
AllowUnregistration : True
AllowMultipleRegistration : True
RequiredCmdlets : {}
RequiredFunctions : {}
IsRegistered : False
Implementations : {}
Parameters
-Kind
Specifies the kind of subsystem to be returned. Valid values are: CommandPredictor.
Parameter properties
| Type: | SubsystemKind |
| Default value: | None |
| Accepted values: | CommandPredictor |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
GetByKindSet
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SubsystemType
Specifies the type of subsystem to be returned.
Parameter properties
| Type: | Type |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
GetByTypeSet
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
