Skip to main content


This Script is part of the Common Scripts Pack.#

Adds a remote system (such as a desktop under investigation) to an investigation. This allows you to install an agent on the system.

Script Data#

Script Typejavascript


Argument NameDescription
nameThe unique name that will be used in the investigation. (default)
usernameThe user name in the remote system.
hostThe host IP address or network identifiable name. (mandatory)
workgroupThe workgroup or domain of the user.
passwordThe users password used to log in to the remote system. By default you will be prompted to enter the password once you hit enter. However, the password can be typed in the command line. If the password is entered in the command line, it will be shown.
credentialSetThe credentials to be chosen to apply to the system (instead of username & password).
dmbPortThe non-standard SMB port to be chosen.
sshPortThe non-standard SSH port to be chosen. The default is 22.
osThe OS of the remote system. Can be, "windows", "linux", or "OSX")
archSelect "amd64" for 64bit systems or "i386" for 32bit systems.
engineNameThe engine to be used if required.


There are no outputs for this script.