Enables the session configurations on the local computer. (Enable-PSSessionConfiguration)
NAMEEnable-PSSessionConfigurationSYNOPSISEnables the session configurations on the local computer.SYNTAXEnable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-SecurityDescriptorSDDL <string>] [-Confirm] [-WhatIf] [<CommonParameters>]DESCRIPTIONThe 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".INPUTSMicrosoft.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.OUTPUTSNone This cmdlet does not return any objects.NOTESTo 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.Examples
EXAMPLE 1C:\PS>Enable-PSSessionConfigurationDescription----------- This command re-enables the Microsoft.PowerShell default session configuration on the computer.EXAMPLE 2C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell, AdminShellDescription----------- This command re-enables the MaintenanceShell and AdminShell session configurations on the computer.EXAMPLE 3C:\PS>Enable-PSSessionConfiguration -name * C:\PS> Get-PSSessionConfiguration | Enable-PSSessionConfigurationDescription----------- 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 4C:\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
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
