Vmskipmaxvirtualdisks

The vmskipmaxvirtualdisks option specifies how backup operations process virtual machine (VM) disks that exceed the maximum disk size.

Use the vmskipmaxvirtualdisks option with the vmmaxvirtualdisks option to specify how the data mover processes large VM disks during a backup operation:
  • 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.
  • Set the vmmaxvirtualdisks option to specify the maximum size of the VM disks to include.

Supported clients

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

Options file

Linux operating systemsSet the vmskipmaxvirtualdisks 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 systemsSet the vmskipmaxvirtualdisks 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

Read syntax diagramSkip visual syntax diagram VMSKIPMAXVIRTUALDISKS NoYes

Parameters

No
Specifies that backup operations fail if a virtual machine has one or more VM disks that are larger than the maximum size. This setting is the default value.
Yes
Specifies that backup operations include VM disks that are the maximum size (or smaller) and exclude any VM disks that are larger than the maximum size.

Examples

Options file:
vmskipmaxvirtualdisks yes
Command line:
Fail a backup operation if a VM disk is larger than 2 TB:
backup vm VM1 -vmskipmaxvirtualdisks=no
Fail a backup operation if a VM disk is larger than 5 TB:
backup vm VM1 -vmskipmaxvirtualdisks=no -vmmaxvirtualdisks=5
Back up VM disks that are 8 TB or smaller and exclude VM disks that are larger than 8 TB:
backup vm VM1 -vmskipvirtualdisks=yes -vmmaxvirtualdisks=8