Acronis® Backup & Recovery ™ 10 Workstation Update 3 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 1.1.2 1.1.3 1.1.4 1.2 Supported commands .............................................................................................................................. 3 Common options .....................................................
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.
Command Common Options Specific Options create /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] /pa
/ftp_password:[password] /oss_numbers /reboot /log:[file name] /log_net_user:[remote user] /log_net_password:[password] /silent deploy_mbr When using the Acronis Universal Restore option: /ur_path:[path] /ur_username:[user] /ur_password:[pwd] /ur_driver:[inf-filename] /vault:[path] /arc:[archive name] Restores the MBR from /arc_id:[archive id] a disk or partition /filename:[file name] image /password:[password] /asz:[number of archive] /index:N /net_user:[username] /net_password:[password] /ftp_user:[user
/silent pit_info /filename:[file name] /password:[password] Displays the numbered /asz:[number of archive] list of backups, /net_user:[username] contained in the /net_password:[password] specified archive /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:[re
When the arc, or the arc_id option is added, it lists all backups contained in the archive.
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] /reboot /later /silent /harddisk:[disk number] /target_harddisk:[disk number] asrm_activate Activates the Acronis Startup Recovery Manager asrm_deactivate Deactivates the Acronis Startup Recovery Manager clone Clones a hard disk help Shows usage ls_check Checks if there are licenses for the local machi
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.
The "0" value means the last backup in the archive, for example: /include_pits:0 If not specified the whole archive is selected. net_user:[username] Specify a user name for network drive access. net_password:[password] Specify a password for network drive access. ftp_user:[username] Specify a user name for access to an FTP server. ftp_password:[password] Specify a password for access to an FTP server. 1.1.2.2 Backup options incremental Set the backup type to incremental.
If the /crypt option is not specified, the password-protected archive will be not encrypted. split:[size in MB] Split the backup into parts of the specified size, if the archive location is other than ASZ. 1.1.2.3 General options oss_numbers Declares that numbers of partitions in the /partition option are adjusted for the MBR partition table rather than just as ascending numbers. This means that primary partitions have numbers 1-1, 1-2, 1-3, 1-4; logical partitions numbers start with 1-5.
log:[file name] Create a log file of the current operation with the specified file name. log_net_user:[remote user] If the log file is created on a network share, include the user name for logon to the share. log_net_password:[password] If the log file is created on a network share, include the password for logon to the share. silent Suppresses the command's output. progress:[on | off] Shows/hides the progress information (percent completed). It is shown by default. 1.1.3 Specific options 1.1.3.
/partition:1-1,"D" file_partition:[partition letter] Specifies the partition where the image file will be stored (by letter or number). This option is used with filename:[file_name]. In that case the file name must be specified without a drive letter or root folder. For example: /file_partition:D /filename:”\1.tib” Dynamic volumes are specified with the prefix DYN, e.g.: /file_partition:DYN1 /filename:”\1.
use_vss Notifies the VSS-aware applications that the backup is about to start. This ensures the consistent state of all data used by the applications, in particular, completion of all database transactions, at the moment of taking the data snapshot. The data consistency, in turn, ensures that the application will be recovered in the correct state and become operational immediately after recovery. 1.1.3.2 filebackup include:[names] Files and folders to be included in the backup (comma separated).
moment of taking the data snapshot. The data consistency, in turn, ensures that the application will be recovered in the correct state and become operational immediately after recovery. 1.1.3.3 deploy file_partition:[partition letter] Specifies the partition where the image file will be stored (by letter or number). This option is used with filename:[file_name]. In that case the file name must be specified without a drive letter or root folder. For example: /file_partition:D /filename:”\1.
size:[partition size in sectors] Sets the new partition size (in sectors). fat16_32 Enables the file system conversion from FAT16 to FAT32 if the partition size after recovery is likely to exceed 2 GB. Without this option, the recovered partition will inherit the file system from the image. type:[active | primary | logical] Sets the restored partition active, primary or logical, if possible (for example, there cannot be more than four primary partitions on the disk).
("Computer_name\User_name"). If the resource is located on an FTP-server the computer name is not required. When the target and local computer are members of different domains, the username must contain the name of the domain the target computer is the member of (e.g. "Domain_name\User_name"). ur_password:[pwd] Specifies using Acronis Universal Restore and a password associated with the ur_username option value.
include:[names] Specifies the files and folders to restore from the file backup (comma separated). For example: /include:D:\MyFolder1,D:\MyFolder2\file_1.exe If not specified, all contents of the file backup are restored. 1.1.3.6 verify folder_name:[path] Specifies a path to the local folder that contains archives to verify. For example: /folder_name:D:\MyFolder By default, all archives stored in the folder and its subfolders will be verified.
net_password:[password] Specifies the password for logon to the network share to save the resulting archive. 1.1.3.8 export net_src_user:[username] Specifies the user name for logon to the network share to access the source archive. net_src_password:[password] Specifies the password for logon to the network share to access the source archive. ftp_src_user:[username] Specifies the user name for logon to the FTP/SFTP server to access the source archive.
1.1.3.9 convert target_filename:[file name] Specifies the path to and name of the virtual disk file to be created. The file extension corresponds to the type of virtual machine to which the virtual disk will be added: VMware virtual machine - .vmdk MS virtual machine and Citrix XenServer - .vhd Parallels virtual machine - .hdd. harddisk:[disk number] Specifies the hard disks to convert by numbers. For each disk, a separate virtual disk will be created.
If the deploy /partition command cannot find a partition in the image by its physical number, use the partition: /target_partition: keys. For the above example, to restore partition 2-5 to its original place use: /partition:2-2 /target_partition:2-5 If the vault option is specified the filename option is ignored. vault:[path] Specifies a path to the location whose archives you want to list.
letter:X Assigns letters to the mounted drives. This option is used with the partition option only. 1.1.3.12 unplug letter:X Specifies the virtual drive to be disconnected by letter. letter:all Disconnects all virtual drives. 1.1.3.13 asz_create harddisk:X Specifies the hard disk number where the Acronis Secure Zone will be created. partition:[partition number] Specifies partitions from which free space will be taken for Acronis Secure Zone.
target_harddisk:[disk number] Specifies the target hard disk number where the source hard disk will be cloned. 1.1.4 1.1.4.1 trueimagecmd.exe usage examples Image disks and partitions The following command will create an image named 1.tib of partitions 2-1 and 1-3: trueimagecmd /create /filename:"C:\Test\1.tib" /partition:2-1,1-3 The image will be saved to the C:\Test\ folder.
trueimagecmd /deploy /filename:"C:\Test\1.tib" /partition:2-1 /target_partition:1-1 The following command will restore partition 2-1, stored in image 1.tib, to hard disk 3: trueimagecmd /deploy /filename:"C:\Test\1.tib" /partition:2-1 /target_harddisk:3 /start:63 /size:64000 /type:logical A new logical partition will be created on disk 3 starting from sector 63. The partition will occupy about 64000 sectors—the exact size will depend on disk geometry and the type of the file system.
C:\Program Files\Acronis\BackupAndRecovery>trueimagecmd /pit_info /filename:\\srv\elenel\kons.tib Pit number: 1 type: image; kind: base; date: 6/27/2009 11:39:10 AM Pit number: 2 type: image; kind: incremental; date: 6/27/2009 11:43:13 AM Pit number: 3 type: image; kind: incremental; date: 6/27/2009 11:44:04 AM Pit number: 4 type: image; kind: incremental; date: 6/27/2009 11:48:22 AM Pit number: 5 type: image; kind: incremental; date: 6/27/2009 11:50:32 AM Operation has succeeded.
The following command will list contents of the specified image: trueimagecmd /list /filename:"C:\My Folder\Backup.tib" The following command will list all archives and their UUID's in the specified location: trueimagecmd /list /vault:D:Backups The following command will list all backups of the specified archive: trueimagecmd /list /vault:D:Backups /arc:"Archive 1" 1.1.4.
1.1.4.11 Acronis Secure Zone: managing backups by file names The following command will list the Acronis Secure Zone size, free space and contents using generated filenames: trueimagecmd /asz_files /password:aszpw Assume that the contents of Acronis Secure Zone are as follows: C:\Program Files\Acronis\BackupAndRecovery>trueimagecmd /asz_files /password: aaa ASZ size: 5.387 GB ASZ free space: 4.363 GB FILE name: AAA2.
C:\Program Files\Acronis\BackupAndRecovery>trueimagecmd /asz_files /password: aaa ASZ size: 5.387 GB ASZ free space: 4.363 GB FILE name: AAA2.TIB; size: 56414317 byte type: image, base; creation time: 2/16/2009 3:43:34 PM type: image, incremental; creation time: 4/25/2009 11:44:47 AM FILE name: FAAA.TIB; size: 3125550 byte type: file, base; creation time: 8/22/2009 12:28:40 PM FILE name: FAAB2.
/nowait – an optional script execution argument. Enables to terminate TrueImageTerminal before backup is finished. Example: TrueImageTerminal /execute:C:\MyBackup.tis /nowait By pressing Ctrl+C you can forcibly turn off backup progress output and switch TrueImageTerminal to a background operation. You can terminate the backup operation executed by TrueImageTerminal by pressing Ctrl+B. 1.2.2 Script structure Scripts are written in the XML language and you can use the following tags: Source (p.
adds a description to an image file. The comment must be a single string (though its length is not limited.) Split splits a large image file into a number of smaller files of the specified size, which can be provided in bytes, kilobytes, megabytes, etc. Password adds password protection to an image file. 1.2.3 Script usage examples The following example illustrates the usage of a script to back up two partitions (logical drives), C and F. mybackup2.tib is specified as an incremental image file.
