Edit

Share via

Disable-WSManCredSSP

Module:
Microsoft.WSMan.Management Module

Disables CredSSP authentication on a computer.

Syntax

Default (Default) 

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.

Parameter properties

Type:String
Default value:None
Accepted values:Client, Server
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

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.