Edit

Share via

Disable-WSManCredSSP

  • Reference
Module:
Microsoft.WSMan.Management

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.