powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Enable-PSSessionConfiguration



NAME
Enable-PSSessionConfiguration

SYNOPSIS
Enables the session configurations on the local computer.

SYNTAX
Enable-PSSessionConfiguration [[-Name] ] [-Force] [-SecurityDescriptorSDDL ] [-Confirm] [-WhatIf]
[]


DESCRIPTION
The Enable-PSSessionConfiguration cmdlet re-enables registered session configurations that have been disabled by us
ing the Disable-PSSessionConfiguration cmdlet. This is an advanced cmdlet that is designed to be used by system adm
inistrators to manage customized session configurations for their users.

Without parameters, Enable-PSSessionConfiguration re-enables the Microsoft.PowerShell configuration, which is the d
efault 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 descr
iptor 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 e
nable remoting on the computer. Instead, use the more comprehensive cmdlet, Enable-PSRemoting.


PARAMETERS
-Force []
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
Specifies the names of session configurations to enable. Enter one or more configuration names. Wildcards are p
ermitted.

You can also pipe a string that contains a configuration name or a session configuration object to Enable-PSSes
sionConfiguration.

If you omit this parameter, Enable-PSSessionConfiguration enables the Microsoft.PowerShell session configuratio
n.

Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? true

-SecurityDescriptorSDDL
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 de
scriptor.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Confirm []
Prompts you for confirmation before executing the command.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WhatIf []
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


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 En
able-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 ei
ther one.

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





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