Vmmaxvirtualdisks

The vmmaxvirtualdisks option specifies the maximum size of Hyper-V virtual machine disks (VHDX) to include in a backup operation.

Use the vmmaxvirtualdisks option with the vmskipmaxvirtualdisks option to specify how the data mover processes large virtual machine (VM) disks during a backup operation:

Set the vmmaxvirtualdisks option to specify the maximum size of the VM disks to include.
Set the vmskipmaxvirtualdisks option to back up the VM disks that do not exceed the maximum size (and exclude any VM disks that exceed the size), or fail the operation.

Supported clients

Windows operating systems This option is valid for supported Windows clients that operate as data movers that back up Hyper-V virtual machines.

Options file

Linux operating systems Set the vmmaxvirtualdisks option in the client system options file (dsm.sys). You can also specify this option as a command-line parameter on the backup vm command.

Windows operating systems Set the vmmaxvirtualdisks option in the client options file (dsm.opt). You can also specify this option as a command-line parameter on the backup vm command.

Syntax

Parameters

size: Specifies the maximum size, in terabytes (TB), of the VM disks to include in a backup operation. The range is an integer 2 - 8; the default is 2. The maximum is 8 TB (equivalent to 8192 GB).; To ensure that the VM disk size that is included in backup operations is always the maximum size, specify 999. Use this value as the most effective method to ensure that the maximum value is always set. This value prevents the need to continuously modify the option files.; When you also specify the vmskipmaxvirtualdisks yes option, VM disks that are the specified maximum size or smaller are backed up and VM disks that are larger than the specified maximum size are excluded.; When you also specify the vmskipmaxvirtualdisks no option, backup operations fail if a VM disk is larger than the specified maximum size.

Examples

Options file:

vmmaxvirtualdisks 3

Command line:

Back up VM disks that are 5 TB or smaller and exclude VM disks that are larger than 5 TB:

backup vm VM1 -vmmaxvirtualdisks=5 -vmskipmaxvirtualdisks=yes

Back up VM disks that are 3 TB or smaller and fail the backup operation if a VM disk is larger than 3 TB:

backup vm VM1 -vmmaxvirtualdisks=3 -vmskipmaxvirtualdisks=no

Back up VM disks that are 8 TB or smaller and exclude VM disks that are larger than 8 TB:

backup vm VM1 -vmmaxvirtualdisks=8 -vmskipmaxvirtualdisks=yes

Or:

backup vm VM1 -vmmaxvirtualdisks=999 -vmskipmaxvirtualdisks=yes