Skip to content

Latest commit

 

History

History
149 lines (106 loc) · 3.83 KB

File metadata and controls

149 lines (106 loc) · 3.83 KB
external help file System.Management.Automation.dll-Help.xml
Locale en-US
Module Name Microsoft.PowerShell.Core
ms.date 10/15/2020
online version https://learn.microsoft.com/powershell/module/microsoft.powershell.core/get-pssubsystem?view=powershell-7.6&WT.mc_id=ps-gethelp
schema 2.0.0
title Get-PSSubsystem

Get-PSSubsystem

SYNOPSIS

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.

Type: System.Management.Automation.Subsystem.SubsystemKind
Parameter Sets: GetByKindSet
Aliases:
Accepted values: CommandPredictor

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-SubsystemType

Specifies the type of subsystem to be returned.

Type: System.Type
Parameter Sets: GetByTypeSet
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

System.Management.Automation.Subsystem.SubsystemKind

System.Type

OUTPUTS

System.Management.Automation.Subsystem.SubsystemInfo

NOTES

RELATED LINKS

about_Experimental_Features

Disable-ExperimentalFeature

Enable-ExperimentalFeature

Get-ExperimentalFeature

Using Experimental Features