powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Enable-WSManCredSSP



NAME
Enable-WSManCredSSP

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

SYNTAX
Enable-WSManCredSSP [-Role] [[-DelegateComputer] ] []


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

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

- Enables CredSSP on the client. The WS-Management setting \Client\Auth\CredSSP is set
to true.
- Sets the Windows CredSSP policy AllowFreshCredentials to WSMan/Delegate on the client.
- Note: These settings allow the client to delegate explicit credentials to a server when server authentication
is achieved.

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

- Enables CredSSP on the server. The WS-Management setting \Service\Auth\CredSSP is set
to true.
- Note: This policy setting allows the server to act as a delegate for clients.

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
-DelegateComputer
Allows the client credentials to be delegated to the server or servers that are specified by this parameter. Th
e value of this parameter should be a fully qualified domain name.

If the Role parameter specifies Client, the DelegateComputer parameter is mandatory.
If the Role parameter specifies Server, the DelegateComputer parameter is not allowed.

Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false

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

If the Role parameter specifies Client, the cmdlet performs the following:

- Enables CredSSP on the client. The WS-Management setting \Client\Auth\CredSSP is
set to true.
- Sets the Windows CredSSP policy AllowFreshCredentials to WSMan/Delegate on the client.
- Note: These settings allow the client to delegate explicit credentials to a server when server authentica
tion is achieved.

If the Role parameter specifies the Server, the cmdlet performs the following:

- Enables CredSSP on the server. The WS-Management setting \Service\Auth\CredSSP is
set to true.
- Note: This policy setting allows the server to act as a delegate for clients.

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
System.Xml.XmlElement
If CredSSP authentication is successfully enabled, this cmdlet generates an XMLElement object.


NOTES





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

C:\PS>enable-wsmancredssp -role client -delegatecomputer server02.accounting.fabrikam.com

cfg : http://schemas.microsoft.com/wbem/wsman/1/config/client/auth
lang : en-US
Basic : true
Digest : true
Kerberos : true
Negotiate : true
Certificate : true
CredSSP : true


Description
-----------
This command allows the client credentials to be delegated to the server02 computer.





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

C:\PS>enable-wsmancredssp -role client -delegatecomputer *.accounting.fabrikam.com

cfg : http://schemas.microsoft.com/wbem/wsman/1/config/client/auth
lang : en-US
Basic : true
Digest : true
Kerberos : true
Negotiate : true
Certificate : true
CredSSP : true


Description
-----------
This command allows the client credentials to be delegated to all the computers in the accounting.fabrikam.com doma
in.





-------------------------- EXAMPLE 3 --------------------------

C:\PS>enable-wsmancredssp -role client -delegatecomputer server02.accounting.fabrikam.com, server03.accounting.fabr
ikam.com, server04.accounting.fabrikam.com

cfg : http://schemas.microsoft.com/wbem/wsman/1/config/client/auth
lang : en-US
Basic : true
Digest : true
Kerberos : true
Negotiate : true
Certificate : true
CredSSP : true


Description
-----------
This command allows the client credentials to be delegated to multiple computers.





-------------------------- EXAMPLE 4 --------------------------

C:\PS>enable-wsmancredssp -role server


Description
-----------
This command allows a computer to act as a delegate for another. The Enable-WSManCredSSP cmdlet (shown in the earli
er examples) only enables CredSSP authentication on the client, and specifies the remote computers that can act on
it's behalf. In order for the remote computer to act as a delegate for the client, the CredSSP item in the Service
node of WSMan must be set to true.





-------------------------- EXAMPLE 5 --------------------------

C:\PS>connect-wsman server02
set-item wsman:\server02\service\auth\credSSP -value $true


Description
-----------
This command allows a computer to act as a delegate for another computer. The Enable-WSManCredSSP commands that are
shown in the earlier examples enable CredSSP authentication only on the client computer, and they specify the remo
te computers that can act on behalf of the client computer. For the remote computer to act as a delegate for the cl
ient computer, the CredSSP item in the Service directory of the WSMan provider must be set to true.

In this example, the first command creates a connection to the remote server02 computer.

The second command sets the credSSP value on the remote server02 computer, which allows the remote computer to act
as a delegate.






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