Configures the local computer for remote management.


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


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.



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.





Default Value


Accept Pipeline Input?


Accept Wildcard Characters?



This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs and Outputs

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet returns.



This cmdlet does not accept any input.



This cmdlet does not generate any output.

Example 1


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

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.

See Also