Acronis BACKUP AND RECOVERY 10 Command Line Reference Update 3

Update 3

Acronis® Backup & Recovery ™ 10

Server for Windows

Command Line Reference

Table of contents

1 Command-line mode and scripting in Windows ......................................................................... 3

1.1 Agent for Windows command-line utility .............................................................................. 3

1.1.1 Supported commands .............................................................................................................................. 3

1.1.2 Common options ...................................................................................................................................... 8

1.1.3 Specific options ....................................................................................................................................... 12

1.1.4 trueimagecmd.exe usage examples ....................................................................................................... 23

1.2 Scripting ............................................................................................................................. 28

1.2.1 Script execution parameters................................................................................................................... 28

1.2.2 Script structure ....................................................................................................................................... 29

1.2.3 Script usage examples ............................................................................................................................ 30

1 Command-line mode and scripting in Windows

Acronis Backup & Recovery 10 supports the command-line mode and enables backup automation by
executing XML scripts.

Acronis Backup & Recovery 10 uses the Acronis True Image Echo command line utility with the
following additions:

1. Ability to use the before/after data capture commands.

2. Ability to use the VSS support option.

3. Ability to check for a license on the license server with the /ls_check command.

4. Ability to use file exclusion at disk backup.

5. Ability to export archives and backups.

The rest of the commands and options are exactly the same. For this reason, the command line
reference uses the terminology accepted in Acronis True Image Echo.

The command line logs are saved in the old (Echo) format and cannot be converted to Acronis
Backup & Recovery 10 logs.

Command line mode limitations

The command-line mode functionality is somewhat more limited than the GUI mode. You will not be
able to perform:

 recovery of a system volume
 operations that require a user interaction, such as inserting removable media (CD, DVD or tape).

The operation fails if there is no media in the drive or the inserted media is full.

These operations only can be done through the GUI.

Scripting is intended only for backup.

1.1 Agent for Windows command-line utility

An administrator might need a console interface in some situations. Acronis Backup & Recovery 10
supports this mode with trueimagecmd.exe utility. The file is located in the folder where Acronis
Backup & Recovery 10 Agent for Windows has been installed, by default it is C:\Program
Files\Acronis\BackupAndRecovery.

This utility is also available when operating under the PE-based bootable media.

1.1.1 Supported commands

trueimagecmd has the following format:

trueimagecmd /command /option1 /option2…

Commands may be accompanied with options. Some options are common for most trueimagecmd
commands, while others are specific for individual commands. Below is a list of supported commands
and compatible options.

3 Copyright © Acronis, Inc., 2000-2010

Command

Common Options

Specific Options

create

Creates an image of
specified disks and
partitions

/vault:[path]
/arc:[archive name]
/arc_id:[archive id]
/filename:[file name]
/password:[password]
/crypt:[AES128|AES192|AES256]
/asz:[number of archive]
/net_user:[username]
/net_password:[password]
/ftp_user:[username]
/ftp_password:[password]
/incremental
/differential
/compression:*0…9+
/split:[size in MB]
/oss_numbers
/progress:[on|off]
/reboot
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

/harddisk:[disk number]
/partition:[partition number]
/file_partition:[partition letter]
/raw
/exclude_names:[names]
/exclude_masks:[masks]
/exclude_system
/exclude_hidden
/before:[pre-data capture command]
/after:[post-data capture command]
/use_vss

filebackup

Backs up specified files
and folders

/vault:[path]
/arc:[archive name]
/arc_id:[archive id]
/filename:[file name]
/password:[password]
/crypt:[AES128|AES192|AES256]
/asz:[number of archive]
/net_user:[username]
/net_password:[password]
/ftp_user:[username]
/ftp_password:[password]
/incremental
/differential
/compression:*0…9+
/split:[size in MB]
/reboot
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

/include:[names]
/exclude_names:[names]
/exclude_masks:[masks]
/exclude_system
/exclude_hidden
/before:[pre-data capture command]
/after:[post-data capture command]
/use_vss

deploy

Restores disks and
partitions, except for
the MBR, from an
image

/vault:[path]
/arc:[archive name]
/arc_id:[archive id]
/filename:[file name]
/password:[password]
/asz:[number of archive]
/index:N
/net_user:[username]
/net_password:[password]
/ftp_user:[username]

/file_partition:[partition letter]
/harddisk:[disk number]
/partition:[partition number]
/target_harddisk:[disk number]
/target_partition:[partition number]
/start:[start sector]
/size:[partition size in sectors]
/fat16_32
/type:[active|primary|logical]
/preserve_mbr

4 Copyright © Acronis, Inc., 2000-2010

/ftp_password:[password]
/oss_numbers
/reboot
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

When using the Acronis Universal Restore
option:

/ur_path:[path]
/ur_username:[user]
/ur_password:[pwd]
/ur_driver:[inf-filename]

deploy_mbr

Restores the MBR from
a disk or partition
image

/vault:[path]
/arc:[archive name]
/arc_id:[archive id]
/filename:[file name]
/password:[password]
/asz:[number of archive]
/index:N
/net_user:[username]
/net_password:[password]
/ftp_user:[username]
/ftp_password:[password]
/reboot
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

/harddisk:[disk number]
/target_harddisk:[disk number]

filerestore

Restores files and
folders from a file
archive

/vault:[path]
/arc:[archive name]
/arc_id:[archive id]
/filename:[file name]
/password:[password]
/asz:[number of archive]
/index:N
/net_user:[username]
/net_password:[password]
/ftp_user:[username]
/ftp_password:[password]
/reboot
/later
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

/target_folder:[target folder]
/overwrite:[older|never|always]
/restore_security:[on|off]
/original_date:[on|off]
/include:[names]

verify

Verifies the archive
data integrity

/vault:[path]
/arc:[archive name]
/arc_id:[archive id]
/filename:[file name]
/password:[password]
/asz:[number of archive]
/net_user:[username]
/net_password:[password]
/ftp_user:[username]
/ftp_password:[password]
/reboot
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]

folder_name:[path]
no_subdir

5 Copyright © Acronis, Inc., 2000-2010

/silent

pit_info

Displays the numbered
list of backups,
contained in the
specified archive

/filename:[file name]
/password:[password]
/asz:[number of archive]
/net_user:[username]
/net_password:[password]
/ftp_user:[username]
/ftp_password:[password]

consolidate

Creates a consistent
copy of the archive
which will contain only
the specified backups

/include_pits:[pits numbers]
/filename:[file name]
/password:[password]
/ftp_user:[username]
/ftp_password:[password]
/reboot
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

/target_filename:[file name]
/net_src_user:[username]
/net_src_password:[password]
/net_user:[username]
/net_password:[password]

export

Creates a copy of an
archive or a
self-sufficient part copy
of an archive in the
location you specify

/vault:[path]
/arc:[archive name]
/arc_id:[archive id]
/include_pits:[pits numbers]
/password:[password]
/ftp_user:[username]
/ftp_password:[password]
/progress:[on|off]
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

/net_src_user:[username]
/net_src_password:[password]
/ftp_src_user:[username]
/ftp_src_password:[password]
/target_vault:[target path]
/target_arc:[target archive name]
/net_user:[username]
/net_password:[password]

convert

Converts an image to
virtual disk format for
using with a virtual
machine

/filename:[file name]
/password:[password]
/asz:[number of archive]
/index:N
/net_user:[username]
/net_password:[password]
/ftp_user:[username]
/ftp_password:[password]
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

/target_filename:[file name]
/harddisk:[disk number]
/vm_type:[vmware|esx|microsoft|parallels]
/ur
/ur_path:[path]

list

Lists available drives
and partitions. When
used with the filename
option, it lists the
image contents.

When used with the
vault option, it lists
archives located in the
specified location.

/password:[password]
/index:N
/asz:[number of archive]
/net_user:[username]
/net_password:[password]
/ftp_user:[username]
/ftp_password:[password]

/filename:[file name]
/vault:[path]
/arc:[archive name]
/arc_id:[archive id]

6 Copyright © Acronis, Inc., 2000-2010

When the arc, or the
arc_id option is added,

it lists all backups
contained in the
archive.

explore

Connects an image as a
virtual drive

/vault:[path]
/arc:[archive name]
/arc_id:[archive id]
/filename:[file name]*
/password:[password]
/asz:[number of archive]
/index:N
/net_user:[username]
/net_password:[password]
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

*for a split image, the name of the
last created file

/partition:[partition number]
/letter:X

unplug

Disconnects the image
connected as a virtual
drive

/letter:X
/letter:all

asz_create

Creates the Acronis
Secure Zone on the
selected drive

/password:[password]
/oss_numbers
/reboot
/later
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

/harddisk:X
/partition:[partition number]
/size:[ASZ size in sectors|unallocated]

asz_content

Displays the Acronis
Secure Zone size, free
space and contents

/password:[password]

asz_files

Displays the Acronis
Secure Zone size, free
space and contents
using the generated file
names

/password:[password]

asz_delete_files

Deletes the most
recent backup in the
archive located in the
Acronis Secure Zone

/filename:[file name]
/password:[password]
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

7 Copyright © Acronis, Inc., 2000-2010

asz_delete

Deletes the Acronis
Secure Zone

/password:[password]
/oss_numbers
/reboot
/later
/log:[file name]
/log_net_user:[remote user]
/log_net_password:[password]
/silent

/partition:[partition number]

asrm_activate

Activates the Acronis
Startup Recovery
Manager

asrm_deactivate

Deactivates the Acronis
Startup Recovery
Manager

clone

Clones a hard disk

/reboot
/later
/silent

/harddisk:[disk number]
/target_harddisk:[disk number]

help

Shows usage

ls_check

Checks if there are
licenses for the local
machine on the license
server

1.1.2 Common options

1.1.2.1 Access to archives

vault:[path]

Specifies a path to the location that contains the archive. Used in combination with the arc, or the
arc_id option.

The following locations are supported:

 Local folders, e.g.: /vault:C:\Test, or /vault:"C:\Test 1"
 Network folders, e.g.: /vault:\\ServerA\Share\
 Managed vaults (for advanced product editions only), e.g.:

/vault:bsp://StorageNode/VaultName

 FTP and SFTP, e.g.: /vault:ftp://ServerA/Folder1
 CD, DVD – with the path specified as a local path, e.g.: /vault:F:\
 Acronis Secure Zone, e.g.: /vault:atis:///asz
 Tapes, e.g.: /vault:atis:///tape?0

8 Copyright © Acronis, Inc., 2000-2010

 Unmanaged vaults are specified by their path. For example, if a vault is located in a folder,

specify the path to that folder.

If the vault option is specified the filename option is ignored.

arc:[archive name]

The name of the archive. If not specified, the arc_id option is used. If both the arc and arc_id options
are specified, the arc_id option is used.

arc_id:[archive id]

Specifies the Universally Unique Identifier (UUID) of the archive, e.g.:

/arc_id:183DE307-BC97-45CE-9AF7-60945A568BE8

If not specified, the arc option is used. If both options are specified, the arc_id option is used.

filename:[file name]

a) Backup file name, if the archive location is other than ASZ.
b) Archive name, when restoring or deleting files from ASZ. Can be obtained with asz_files.

If the vault option is specified the filename option is ignored.

password:[password]

a) Password for the archive, if the archive location is other than ASZ.
b) Password for the ASZ, if archive location is ASZ.

asz:[number of archive]

Addresses to the ASZ and selects the archive (a full backup with or without increments).

To get the archive number, use asz_content.

index:N

N = Number of the backup in an archive:

 1 = basic full backup
 2 = 1st increment… and so on
 0 (default) = latest increment

Selects a backup in a sequence of incremental backups inside the archive.

To get a backup index from the ASZ, use asz_content.

include_pits:[pits numbers]

Specifies the backups (pits) to be included in the archive copy. To get the numbers of pits, use
pit_info. Separate multiple values with a comma, for example:

/include_pits:2,4,5

9 Copyright © Acronis, Inc., 2000-2010