powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Disable-WSManCredSSP



NAME
Disable-WSManCredSSP

SYNOPSIS
Disables Credential Security Service Provider (CredSSP) authentication on a client computer.

SYNTAX
Disable-WSManCredSSP [-Role] []


DESCRIPTION
The Disable-WSManCredSPP cmdlet disables CredSSP authentication on a client or on a server computer. When CredSSP a
uthentication is used, the user's credentials are passed to a remote computer to be authenticated. This type of aut
hentication is designed for commands that create a remote session from within another remote session. For example,
you use this type of authentication if you want to run a background job on a remote computer.

The cmdlet is used to disable CredSSP on the client by specifying Client in the Role parameter. The cmdlet then per
forms the following:

- Disables CredSSP on the client. The WS-Management setting \Client\Auth\CredSSP is set
to false.
- Removes any WSMan/* setting from the Windows CredSSP policy AllowFreshCredentials on the client.

The cmdlet is used to disable CredSSP on the server by specifying Server in the Role parameter. The cmdlet then per
forms the following:

- Disables CredSSP on the server. The WS-Management setting \Service\Auth\CredSSP is set
to false.

Caution: CredSSP authentication delegates the user's 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 credenti
als are passed to it, the credentials can be used to control the network session.

To disable CredSSP authentication, use the Disable-WSManCredSSP cmdlet.


PARAMETERS
-Role
Accepts one of two possible values: Client or Server. These values specify whether CredSSP should be disabled
as a client or as a server.

If the cmdlet is used to disable CredSSP on the client by specifying Client in the Role parameter, then the cmd
let performs the following:

- Disables CredSSP on the client. The WS-Management setting \Client\Auth\CredSSP is
set to false.
- Removes any WSMan/* setting from the Windows CredSSP policy AllowFreshCredentials on the client.

If the cmdlet is used to disable CredSSP on the server by specifying Server in the Role parameter, the cmdlet p
erforms the following:

- Disables CredSSP on the server. The WS-Management setting \Service\Auth\CredSSP is
set to false.

Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS
None
This cmdlet does not accept any input.


OUTPUTS
None
This cmdlet does not generate any output.


NOTES


To enable CredSSP authentication, use the Enable-WSManCredSSP cmdlet.


-------------------------- EXAMPLE 1 --------------------------

C:\PS>Disable-WSManCredSSP -Role Client


Description
-----------
This command disables CredSSP on the client, which prevents delegation to servers.





-------------------------- EXAMPLE 2 --------------------------

C:\PS>Disable-WSManCredSSP -Role Server


Description
-----------
This command disables CredSSP on the server, which prevents delegation from clients.






RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkId=141438
Connect-WSMan
Disconnect-WSMan
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
New-WSManSessionOption
Remove-WSManInstance
Set-WSManInstance
Set-WSManQuickConfig
Test-WSMan