Disable PSSessionConfiguration - PowerShell


Disable-PSSessionConfiguration disables a PowerShell session configuration, preventing its use in new remote PowerShell sessions. This command is commonly used to deactivate configurations that are no longer required or secure.


Disable-PSSessionConfiguration [-Name] <string> [-Confirm] [-WhatIf] [-Force]


  • -Name: Specifies the name of the session configuration to disable. Required.
  • -Confirm: Prompts for confirmation before executing the command.
  • -WhatIf: Displays what the command would do without actually executing it.
  • -Force: Disables the session configuration even if it is in use.


Simple usage:

Disable a session configuration named “MySessionConfig”:

Disable-PSSessionConfiguration -Name MySessionConfig

Forcefully disable a session configuration:

Disable a session configuration even if it is in use:

Disable-PSSessionConfiguration -Name MySessionConfig -Force

Confirm before disabling:

Prompt for confirmation before disabling a session configuration:

Disable-PSSessionConfiguration -Name MySessionConfig -Confirm

Common Issues

  • Error: The session configuration could not be found: Ensure that the specified session configuration name is correct.
  • Error: The session configuration is in use: If you encounter this error, you can use the -Force parameter to forcefully disable the configuration.


Disable-PSSessionConfiguration can be used in conjunction with other PowerShell commands, such as Get-PSSessionConfiguration and Remove-PSSessionConfiguration:

  • Get the status of a session configuration:
Get-PSSessionConfiguration -Name MySessionConfig | Select Name, IsEnabled
  • Remove a disabled session configuration:
Remove-PSSessionConfiguration -Name MySessionConfig
  • Enable-PSSessionConfiguration
  • Get-PSSessionConfiguration
  • New-PSSessionConfiguration
  • Remove-PSSessionConfiguration