Disable-WSManCredSSP
Disables CredSSP authentication on a computer.
Syntax
Disable-WSManCredSSP
[-Role] <String>
[<CommonParameters>]
Description
This cmdlet is only available on the Windows platform.
The Disable-WSManCredSSP
cmdlet disables Credential Security Support Provider (CredSSP)
authentication on a client or on a server computer. When CredSSP authentication is used, the user
credentials are passed to a remote computer to be authenticated.
Use this cmdlet to disable CredSSP on the client by specifying Client in the Role parameter. This cmdlet performs the following actions:
- Disables CredSSP on the client. This cmdlet sets the WS-Management setting
<localhost|computername>\Client\Auth\CredSSP
to false. - Removes any
WSMan/*
setting from the Windows CredSSP policy AllowFreshCredentials on the client.
Use this cmdlet to disable CredSSP on the server by specifying Server in Role. This cmdlet performs the following action:
- Disables CredSSP on the server. This cmdlet sets the WS-Management setting
<localhost|computername>\Client\Auth\CredSSP
to false.
Caution
CredSSP authentication delegates the user credentials from the local computer to a remote computer. This practice increases the security risk of the remote operation. If the remote computer is compromised, when credentials are passed to it, the credentials can be used to control the network session.
Examples
Example 1: Disable CredSSP on a client
Disable-WSManCredSSP -Role Client
This command disables CredSSP on the client, which prevents delegation to servers.
Example 2: Disable CredSSP on a server
Disable-WSManCredSSP -Role Server
This command disables CredSSP on the server, which prevents delegation from clients.
Parameters
-Role
Specifies whether to disable CredSSP as a client or as a server. The acceptable values for this parameter are: Client and Server.
If you specify Client, this cmdlet performs the following actions:
- Disables CredSSP on the client. This cmdlet sets WS-Management setting
<localhost|computername>\Client\Auth\CredSSP
to false. - Removes any
WSMan/*
setting from the Windows CredSSP policy AllowFreshCredentials on the client.
If you specify Server, this cmdlet performs the following action:
- Disables CredSSP on the server. This cmdlet sets the WS-Management setting
<localhost|computername>\Client\Auth\CredSSP
to false.
Type: | String |
Accepted values: | Client, Server |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
None
You can't pipe objects to this cmdlet.
Outputs
None
This cmdlet returns no output.
Notes
- To enable CredSSP authentication, use the Enable-WSManCredSSP cmdlet.
Related Links
PowerShell