Before using any command line parameters please ensure that you have sufficient command line experience and you know exactly what you are doing.

In DOS, OS/2, and Microsoft Windows, a batch file is a text file containing a series of commands intended to be executed by the command interpreter. Similar to job control language and other systems on mainframe and minicomputer systems, batch files were added to ease the work required for certain regular tasks by allowing the user to set up a batch script to automate many commands.

When a batch file is run, the shell program (usually COMMAND.COM or cmd.exe) reads the file and executes its commands, normally line-by-line. Batch files are useful for running a sequence of executables automatically and are often used to automate repetitive or tedious processes. DOS batch files have the filename extension .bat.

The general format of commands:

DTAgent.exe -[Command [options]]

The content in the square brackets is an optional part of the command, you may use it but don't have to. The square brackets are not a part of the command. Command keywords must be preceded by a hyphen and multiple parameters must be separated by commas.

Commands

  • -add

Adds a single virtual device, returns the quantity of virtual devices or -1 in case of error.

Syntax: -add <type>

<type>: "dt", "ide" or "scsi"

Example: DTAgent.exe -add ide

  • -add_hdd

Adds a virtual HDD device.

Syntax: -add_hdd <letter>, <path>; <letter> — a letter that specifies the device. This parameter is optional. The first free letter will be chosen if this parameter is not specified. <path> — a path to the file. Example: DTAgent.exe -add_hdd K, "f:\test.vhd"

  • set_count

Adds or removes virtual devices (desired number of devices is passed as <n>), returns 0 in case of successful operation result or -1 in case of error.

Syntax: -set_count <type>,<n>

<type>: "dt", "ide" or "scsi"
<n>: number of virtual devices to be emulated

Example: DTAgent.exe -set_count ide, 1

Note that you can set only 2 IDE devices in Windows 8 because of the system limitations. However, using -add command, you can create up to 4 IDE devices.

  • -mount

Mounts an image file to a virtual drive:

Syntax: -mount <type>,<n>,<path>

<type>: "dt", "ide" or "scsi" <n>: device number. Device numeration starts from zero, so valid numbers are: "0", "1", "2", "3"... (depending on number of installed devices) <path>: path to image file

Example: DTAgent.exe -mount scsi, 0,"C:\My Images\name_of_image.ape"

If <type> is not specified, it will be automatically set to "dt".

  • -unmount

Unmounts an image from a virtual drive.

Syntax: -unmount <type>,<n>

<type>: "dt", "ide" or "scsi" <n>: device number

Example: DTAgent.exe -unmount scsi, 0

  • -unmount_all

Unmounts all currently mounted images, returns 0 in case of successful operation or -1 in case of error.

Syntax: -unmount_all

Example: DTAgent.exe -unmount_all

  • -remove

Decrements the quantity of devices, returns number of virtual devices or -1 in case of error.

Syntax: -remove <type>,<n>

<type>: "dt", "ide" or "scsi" <n>: device number

Example: DTAgent.exe -remove scsi, 0

  • -remove_hdd

Unmounts and removes a HDD virtual device.

Syntax: -remove <letter>

Example: DTAgent.exe -remove_hdd K

  • -get_letter

Gets a letter assigned to a virtual device. Returns a letter number (0-A,1-B,2-C etc.) in case of success or -1 if any error occurred.

Syntax: -get_letter <type>,<n>

<type>: "dt", "ide" or "scsi" <n>: device number

Example: DTAgent.exe -get_letter scsi, 1

  • -get_count

Gets number of virtual devices, returns the quantity of drives or -1 in case of error.

Syntax: -get_count <type>

<type>: "dt", "ide" or "scsi", if omitted would return total quantity of virtual drives

Example: DTAgent.exe -get_count scsi

  • -help

Displays brief help on command line parameters.

Syntax: -help

Example: DTAgent.exe -help