Invoke-RevertToSelf
SYNOPSIS
Reverts any token impersonation.
Author: Will Schroeder (@harmj0y)
License: BSD 3-Clause
Required Dependencies: PSReflect
SYNTAX
Invoke-RevertToSelf [[-TokenHandle] <IntPtr>]
DESCRIPTION
This function uses RevertToSelf() to revert any impersonated tokens. If -TokenHandle is passed (the token handle returned by Invoke-UserImpersonation), CloseHandle() is used to close the opened handle.
EXAMPLES
-------------------------- EXAMPLE 1 --------------------------
$SecPassword = ConvertTo-SecureString 'Password123!' -AsPlainText -Force
$Cred = New-Object System.Management.Automation.PSCredential('TESTLAB\dfm.a', $SecPassword) $Token = Invoke-UserImpersonation -Credential $Cred Invoke-RevertToSelf -TokenHandle $Token
PARAMETERS
-TokenHandle
An optional IntPtr TokenHandle returned by Invoke-UserImpersonation.
Type: IntPtr
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False