Rename-EmpireAgent

NAME Rename-EmpireAgent



SYNOPSIS

Rename a Epire agent.





SYNTAX

Rename-EmpireAgent [-Id] <Int32> [-NoSSLCheck] -Name <String> -NewName <String> [<CommonParameters>]



Rename-EmpireAgent [-Token] <String> [-ComputerName] <String> [[-Port] <Int32>] [-NoSSLCheck] -Name <String>

-NewName <String> [<CommonParameters>]





DESCRIPTION

Rename a specified agent on a Empire server.





PARAMETERS

-Id <Int32>

Empire session Id of the session to use.



Required? true

Position? 1

Default value 0

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Token <String>

Empire API token to use to execute the action.



Required? true

Position? 1

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-ComputerName <String>

IP Address or FQDN of remote Empire server.



Required? true

Position? 2

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Port <Int32>

Port number to use in the connection to the remote Empire server.



Required? false

Position? 3

Default value 1337

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-NoSSLCheck [<SwitchParameter>]

Do not check if the TLS/SSL certificate of the Empire is valid.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-Name <String>

Name of agent to rename.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-NewName <String>

New name for the agent.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

Empire.Agent





NOTES





Licensed under BSD 3-Clause license



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



C:\\PS>Rename-EmpireAgent -Id 0 -Name L3RR1MCCV1DXZHH2 -NewName DC01



Explanation of what the example does











RELATED LINKS