Skip to content

Latest commit

 

History

History
120 lines (76 loc) · 3.65 KB

File metadata and controls

120 lines (76 loc) · 3.65 KB
external help file Microsoft.WSMan.Management.dll-Help.xml
Locale en-US
Module Name Microsoft.WSMan.Management
ms.date 12/12/2022
online version https://learn.microsoft.com/powershell/module/microsoft.wsman.management/get-wsmancredssp?view=powershell-7.6&WT.mc_id=ps-gethelp
schema 2.0.0
title Get-WSManCredSSP

Get-WSManCredSSP

SYNOPSIS

Gets the Credential Security Support Provider-related configuration for the client.

SYNTAX

Get-WSManCredSSP [<CommonParameters>]

DESCRIPTION

This cmdlet is only available on the Windows platform.

The Get-WSManCredSSP cmdlet gets the Credential Security Support Provider-related configuration of the client and the server. The output indicates whether Credential Security Support Provider (CredSSP) authentication is enabled or disabled. This cmdlet also displays configuration information for the AllowFreshCredentials policy of CredSSP.

When you use CredSSP authentication, the user credentials are passed to a remote computer to be authenticated. This type of authentication is designed for commands that create a remote session from another remote session. For example, if you want to run a background job on a remote computer, use this kind of authentication.

The cmdlet performs the following actions:

  • Gets the WS-Management CredSSP setting on the client (<localhost|computername>\Client\Auth\CredSSP).
  • Gets the Windows CredSSP policy setting AllowFreshCredentials.
  • Gets the WS-Management CredSSP setting on the server (<localhost|computername>\Service\Auth\CredSSP).

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: Display CredSSP configuration

Get-WSManCredSSP

This command displays CredSSP configuration information for both the client and server.

The output identifies that this computer is or is not configured for CredSSP.

If the computer is configured for CredSSP, this is the output:

The machine is configured to allow delegating fresh credentials to the following target(s): wsman/server02.accounting.fabrikam.com

If the computer is not configured for CredSSP, this is the output:

The machine is not configured to allow delegating fresh credentials.

PARAMETERS

CommonParameters

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

INPUTS

None

You can't pipe objects to this cmdlet.

OUTPUTS

System.String

This cmdlet returns a message string describing the configuration state for CredSSP.

NOTES

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

RELATED LINKS

Connect-WSMan

Disable-WSManCredSSP

Disconnect-WSMan

Enable-WSManCredSSP

Get-WSManInstance

Invoke-WSManAction

New-WSManInstance

New-WSManSessionOption

Remove-WSManInstance

Set-WSManInstance

Set-WSManQuickConfig

Test-WSMan