Disable-ExperimentalFeature
Disable an experimental feature on startup of new instance of PowerShell.
Syntax
Default (Default)
Disable-ExperimentalFeature
[-Name] <String[]>
[-Scope <ConfigScope>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Disable-ExperimentalFeature cmdlet disables experimental features by removing the named
experimental features from the powershell.config.json settings file read on PowerShell startup.
This cmdlet was introduced in PowerShell 6.2.
Note
Any changes to experimental feature state only takes effect on restart of PowerShell
Examples
Example 1: Disable an experimental feature
In this example, if this experimental feature was previously enabled, then the
powershell.config.json file is updated for the user to not enable that feature once PowerShell is
restarted. Upon success nothing is output to the pipeline and only a warning message is displayed.
Disable-ExperimentalFeature -Name PSImplicitRemotingBatching
WARNING: Enabling and disabling experimental features do not take effect until next start of PowerShell.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Name
The name or names of the experimental features to disable.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Scope
Determines which powershell.config.json to update whether it affects all users or
just the current user.
Parameter properties
| Type: | ConfigScope |
| Default value: | CurrentUser |
| Accepted values: | AllUsers, CurrentUser |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| 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.
Inputs
ExperimentalFeature
Pipe instances of ExperimentalFeature from Get-ExperimentalFeature cmdlet to disable.
Outputs
None
This cmdlet returns no output.
Notes
Changes to state of an experimental feature only take effect on restart of PowerShell.
