Configures the local computer for remote management. (Set-WSManQuickConfig)

   

# NAME
Set-WSManQuickConfig

# SYNOPSIS
Configures the local computer for remote management.

# SYNTAX
Set-WSManQuickConfig [-UseSSL] [<CommonParameters>]

# DESCRIPTION
The Set-WSManQuickConfig cmdlet configures the computer to receive Windows PowerShell remote commands that are sent by using the Web Services for Management (WS-Management) technology.

The cmdlet performs the following:
1. Checks whether the WinRM service is running. If the WinRM service is not running, the service is started.
2. Sets the WinRM service startup type to automatic.
3. Creates a listener to accept requests on any IP address. By default, the transport is HTTP.
4. Enables a firewall exception for WinRM traffic .

To run this cmdlet in Windows Vista, Windows Server 2008, and later versions of Windows, you must start Windows PowerShell with the "Run as administrator" option.

# PARAMETERS
-UseSSL [<SwitchParameter>]
Specifies that the Secure Sockets Layer (SSL) protocol should be used to establish a connnection to the remote computer. By default, SSL is not used.

WS-Management encrypts all Windows PowerShell content transmitted over the network. The UseSSL parameter lets you specify that the additional protection of using HTTPS instead of HTTP should be used. If you specify this parameter, but SSL is not available on the port used for the connection, the command fails.

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
None
This cmdlet does not accept any input.

# OUTPUTS
None
This cmdlet does not generate any output.

# NOTES

# EXAMPLE 1

C:\PS>Set-WSManQuickConfig

# Description
-----------
This command sets the required configuration to enable remote management of the local computer. By default, this command creates a WS-Management listener on HTTP.

# EXAMPLE 2

C:\PS>Set-WSManQuickConfig -UseSSL

# Description
-----------
The command sets the required configuration to enable remote management of the local computer. The UseSSL parameter makes the command create a WS-Management listener on HTTPS.

RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=141463
Connect-WSMan
Disable-WSManCredSSP
Disconnect-WSMan
Enable-PSRemoting
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
Invoke-WSManAction
New-PSSession
New-WSManInstance
New-WSManSessionOption
Test-WSMan

C:\Windows>powershell get-help Test-WSMan -full

ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.