Edit

Share via

Get-PSSubsystem

  • Reference
Module:
Microsoft.PowerShell.Core

Retrieves information about the subsystems registered in PowerShell.

Syntax

Get-PSSubsystem []
Get-PSSubsystem
   -Kind <SubsystemKind>
   [<CommonParameters>]
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.

Type:SubsystemKind
Accepted values:CommandPredictor
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SubsystemType

Specifies the type of subsystem to be returned.

Type:Type
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Inputs

SubsystemKind

Type

Outputs

SubsystemInfo