Enable-SmbDelegation

  • Article

Enable-SmbDelegation

Enables a constrained delegation authorization for an SMB client and server.

Syntax

Parameter Set: Default
Enable-SmbDelegation [-SmbClient] <String> [-SmbServer] <String> [ <CommonParameters>]

Detailed Description

The Enable-SmbDelegation cmdlet enables a constrained delegation authorization for a server message block (SMB) client and server. Delegation allows a user who remotes into an SMB client to perform operations on a remote SMB server.

Parameters

-SmbClient<String>

Specifies the name of the SMB client. The cmdlet enables constrained delegation authorizations for the SMB client that you specify.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SmbServer<String>

Specifies the name of the SMB server. The cmdlet enables constrained delegation authorizations for the SMB server that you specify.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Notes

  • This cmdlet relies on Active Directory Windows PowerShell cmdlets to perform its actions. Before you use this cmdlet, you must install the Active Directory cmdlets. To install the Active Directory cmdlets, run the following command:
    Install-WindowsFeature RSAT-AD-PowerShell
    For more information, type Get-Help Install-WindowsFeature.

    This cmdlet works only with resource-based delegation, and the Active Directory forest must be at the Windows Server 2012 functional level. To check the functional level of the Active Directory forest, use the Get-ADForest cmdlet.

Examples

Example 1: Enable a constrained delegation authorization for SMB clients and servers

This command adds a new constrained delegation authorization so that a user remotely connected to the SMB client named HVSVR01 can configure resources on the SMB server named FileServer01.

PS C:\> Enable-SmbDelegation –SmbServer "FileServer01" –SmbClient "HVSVR01"

Disable-SmbDelegation

Get-ADForest

Get-SmbDelegation

Install-WindowsFeature