volume

Commands: backup disk and backup vm

--volume=<volume numbers>

The parameter is used with the backup disk and backup vm commands to specify volumes to be backed up.

Volume numbers are specified as in the following format: <disk number>-<volume number>, for example:

--volume=1-1,1-2

Dynamic volumes are specified with the DYN prefix or by their GUIDs, for example:

--volume=DYN1
--volume=e6ee6edc-d1ba-11d8-813e-806e6f6e6963

Both basic and dynamic volumes can be specified by their letters, for example:

--volume=C

Mixed notation is also acceptable, for example:

--volume=1-1,E,e6ee6edc-d1ba-11d8-813e-806e6f6e6963

To view available disks, volumes and GUIDs of volumes, use the list disks command.

You can use the --disk and --volume parameters in one command, for example:

--disk=1 --volume=E

If neither the --disk parameter nor the --volume parameter is specified, the software will back up all of the machine's disks.

Commands: recover disk, recover vm, mount

--volume=<volume number>

Command with which the parameter is used

What does the parameter mean?

What if the parameter is not specified?

recover disk

recover vm

The volume whose data is to be recovered from a backup.

If the --disk parameter is specified, this disk will be recovered. Otherwise, the command will recover all of the backed up disks.

mount

The volume to be mounted from a backup. You can specify several volumes.

The command will fail.

Selecting a dynamic volume

The software considers all dynamic volumes of a backup as belonging to a separate disk. To learn the correspondence between the dynamic volumes you backed up and the numbers assigned to these volumes by the software, run the list content command without specifying the --content_path parameter.

For example, if you backed up volumes 1-2 (the second volume of the first disk), 2-1 (the first volume of the second disk) and DYN1 (the first dynamic volume), the software considers the latter as the first volume of the third disk. So, when you recover the dynamic volume, you should specify --volume=3-1.

Command: create asz

--volume={<volume numbers>|all}

In the create asz command, the parameter specifies volumes from which the free space for Acronis Secure Zone will be taken if the unallocated space on the specified disk is not enough. The free space will be taken in proportion to each volume's size. If --volume=all is specified, the free space will be taken from all volumes of the specified disk.

Without this parameter, Acronis Secure Zone will use the unallocated space only.

Command: resize asz

--volume={<volume numbers>|all}

If you use the resize asz command to increase Acronis Secure Zone, the software will behave in the same way as described earlier for the create asz command.

If you use the command to decrease Acronis Secure Zone, the parameter specifies volumes where the free space will be added. The space will be distributed to each volume equally. If --volume=all is specified, the free space will be added to all volumes of the disk where the zone is located. Without the --volume parameter, the freed space becomes unallocated.

Command: delete asz

--volume=<volume numbers>

In the delete asz command, the parameter specifies volumes where the free space will be added after the Acronis Secure Zone deletion. The space will be distributed to each volume equally. Without this parameter, the freed space becomes unallocated.