Enables the session configurations on the local computer. (Enable-PSSessionConfiguration)
# NAME
Enable-PSSessionConfiguration
# SYNOPSIS
Enables the session configurations on the local computer.
# SYNTAX
Enable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-SecurityDescriptorSDDL <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
# DESCRIPTION
The Enable-PSSessionConfiguration cmdlet re-enables registered session configurations that have been disabled by using the Disable-PSSessionConfiguration 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 used 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 specify.
-- 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.
# PARAMETERS
-Force [<SwitchParameter>]
Suppresses all user prompts, and restarts the WinRM service without prompting. Restarting the service makes the configuration change effective.
To prevent a restart and suppress the restart prompt, use the NoServiceRestart parameter.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Name <string[]>
Specifies the names of session configurations to enable. Enter one or more configuration names. Wildcards are permitted.
You can also pipe a string that contains a configuration name or a session configuration object to Enable-PSSessionConfiguration.
If you omit this parameter, Enable-PSSessionConfiguration enables the Microsoft.PowerShell session configuration.
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? true
-SecurityDescriptorSDDL <string>
Replaces the security descriptor on the session configuration with the specified security descriptor.
If you omit this parameter, Enable-PSSessionConfiguration just deletes the "deny all" item from the security descriptor.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before executing the command.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Describes what would happen if you executed the command without actually executing the command.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
# INPUTS
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration, System.String
You can pipe a session configuration object or a string that contains the name of a session configuration to Enable-PSSessionConfiguration.
# OUTPUTS
None
This cmdlet does not return any objects.
# NOTES
To run this cmdlet on Windows Vista, Windows Server 2008, and later versions of Windows, you must start Windows PowerShell with the "Run as administrator" option.
# 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-188441444-3100496)S:P"
# Description
-----------
This command re-enables the MaintenanceShell session configuration and specifies a new security descriptor for the configuration.
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
C:\Windows>powershell get-help Disable-PSSessionConfiguration -full
ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.