PowerShell Logo Small

Enable-PSSessionConfiguration



This is the built-in help made by Microsoft for the command 'Enable-PSSessionConfiguration', in PowerShell version 2 - as retrieved from Windows version 'Microsoft® Windows Vista™ Ultimate ' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Enables the session configurations on the local computer.

SYNTAX


Enable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-SecurityDescriptorSDDL <string>] [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Enable-PSSessionConfiguration cmdlet re-enables registered session configurations that have been disabled by using the Disable-PSSessionConfi
guration cmdlet. This is an advanced cmdlet that is designed to be used by system administrators to manage customized session configurations for
their users.

Without parameters, Enable-PSSessionConfiguration re-enables the Microsoft.PowerShell configuration, which is the default configuration that is u
sed for sessions.

This cmdlet performs the following operations for each enabled configuration:
-- Removes the "deny all" setting from the security descriptor of the configuration or replaces the security descriptor with one that you specif
y.
-- Turns on the listener that accepts requests on any IP address.
-- Restarts the WinRM service.

The Enable-PSSessionConfiguration cmdlet calls the Set-WSManQuickConfig cmdlet. However, it should not be used to enable remoting on the computer
. Instead, use the more comprehensive cmdlet, Enable-PSRemoting.



<

RELATED LINKS

Online version: http://go.microsoft.com/fwlink/?LinkID=144301
about_Session_Configurations
Disable-PSSessionConfiguration
Get-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration
WS-Management
Provider



REMARKS

<

Examples


-------------------------- EXAMPLE 1 --------------------------

C:\PS>Enable-PSSessionConfiguration



Description
-----------
This command re-enables the Microsoft.PowerShell default session configuration on the computer.








-------------------------- EXAMPLE 2 --------------------------

C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell, AdminShell



Description
-----------
This command re-enables the MaintenanceShell and AdminShell session configurations on the computer.








-------------------------- EXAMPLE 3 --------------------------

C:\PS>Enable-PSSessionConfiguration -name *

C:\PS> Get-PSSessionConfiguration | Enable-PSSessionConfiguration



Description
-----------
These commands re-enable all session configurations on the computer. The commands are equivalent, so you can use either one.

Enable-PSSessionConfiguration does not generate an error if you enable a session configuration that is already enabled.








-------------------------- EXAMPLE 4 --------------------------

C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell -securityDescriptorSDDL "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-1884
41444-3100496)S:P"



Description
-----------
This command re-enables the MaintenanceShell session configuration and specifies a new security descriptor for the configuration.