Configures the computer to receive remote commands.
Syntax
Enable-PSRemoting [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]
Description
The Enable-PSRemoting cmdlet configures the computer to receive Windows PowerShell remote commands that are sent by using the WS-Management technology.
You need to run this command only once on each computer that will receive commands. You do not need to run it on computers that only send commands. Because the configuration activates listeners, it is prudent to run it only where it is needed.
The Enable-PSRemoting cmdlet performs the following operations:
-- Runs the Set-WSManQuickConfig cmdlet, which performs the following tasks:
----- Starts the WinRM service.
----- Sets the startup type on the WinRM service to Automatic.
----- Creates a listener to accept requests on any IP address.
----- Enables a firewall exception for WS-Management communications.
-- Enables all registered Windows PowerShell session configurations to receive instructions from a remote computer.
----- Registers the "Microsoft.PowerShell" session configuration, if it is not already registered.
----- Registers the "Microsoft.PowerShell32" session configuration on 64-bit computers, if it is not already registered.
----- Removes the "Deny Everyone" setting from the security descriptor for all the registered session configurations.
----- Restarts the WinRM service to make the preceding changes effective.
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.
Parameters
-Force
Suppresses all user prompts. By default, you are prompted to confirm each operation.
|
Required? |
false |
|
Position? |
named |
|
Default Value |
False |
|
Accept Pipeline Input? |
false |
|
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before executing the command.
|
Required? |
false |
|
Position? |
named |
|
Default Value |
none |
|
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 |
none |
|
Accept Pipeline Input? |
false |
|
Accept Wildcard Characters? |
false |
<CommonParameters>
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.
|
Inputs |
None You cannot pipe input to this cmdlet. |
|
Outputs |
System.String Enable-PSRemoting returns strings that describe its results. |
Example 1
C:\PS>enable-psremoting This command configures the computer to receive remote commands.
Example 2
C:\PS>enable-psremoting -force This command configures the computer to receive remote commands. It uses the Force parameter to suppress the user prompts.
See Also