< Back
Stop-EmpireAgent
Post
NAME Stop-EmpireAgent
SYNOPSIS
Kills a specified Empire agent.
SYNTAX
Stop-EmpireAgent [-Id] <Int32> [-NoSSLCheck] [-Name <String>] [<CommonParameters>]
Stop-EmpireAgent [-Token] <String> [-ComputerName] <String> [[-Port] <Int32>] [-NoSSLCheck] [-Name <String>]
[<CommonParameters>]
DESCRIPTION
Kills a specified Empire agent.
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 stop.
Required? false
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
NOTES
Licensed under BSD 3-Clause license
-------------------------- EXAMPLE 1 --------------------------
C:\\PS>Stop-EmpireAgent -Id 0 -Name DC01
Kills the agent named DC01
RELATED LINKS
SYNOPSIS
Kills a specified Empire agent.
SYNTAX
Stop-EmpireAgent [-Id] <Int32> [-NoSSLCheck] [-Name <String>] [<CommonParameters>]
Stop-EmpireAgent [-Token] <String> [-ComputerName] <String> [[-Port] <Int32>] [-NoSSLCheck] [-Name <String>]
[<CommonParameters>]
DESCRIPTION
Kills a specified Empire agent.
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 stop.
Required? false
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
NOTES
Licensed under BSD 3-Clause license
-------------------------- EXAMPLE 1 --------------------------
C:\\PS>Stop-EmpireAgent -Id 0 -Name DC01
Kills the agent named DC01
RELATED LINKS