PowerShell Logo Small

Enable-PSSessionConfiguration



This is the built-in help made by Microsoft for the command 'Enable-PSSessionConfiguration', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 Standard' 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>] [-SkipNetworkProfileCheck] [-Confirm] [-WhatIf]
[<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Enable-PSSessionConfiguration cmdlet enables registered session configurations that have been disabled, such as by using the
Disable-PSSessionConfiguration or Disable-PSRemoting cmdlets, or the AccessMode parameter of Register-PSSessionConfiguration. 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 enables the Microsoft.PowerShell configuration, which is the default configuration that is
used for sessions.


Enable-PSSessionConfiguration removes the "Deny_All" setting from the security descriptor of the affected session configurations, turns on the
listener that accepts requests on any IP address, and restarts the WinRM service. Beginning in Windows PowerShell 3.0,
Enable-PSSessionConfiguration also sets the value of the Enabled property of the session configuration
(WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) to "True". However, Enable-PSSessionConfiguration does not remove or change the
"Network_Deny_All" (AccessMode=Local) security descriptor setting that allows only users of the local computer to use to the session
configuration.


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
Disable-PSSessionConfiguration
Enable-PSSessionConfiguration
Get-PSSessionConfiguration
New-PSSessionConfigurationFile
New-PSSessionOption
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Test-PSSessionConfigurationFile
Unregister-PSSessionConfiguration
WSMan Provider
about_Session_Configurations
about_Session_Configuration_Files

REMARKS

<

Examples


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

PS C:\>Enable-PSSessionConfiguration



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








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

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



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








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

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



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 --------------------------

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



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