Sun Microsystems VERSION 3.1.0_BETA2 user manual VBoxManage modifyhd

	8 VBoxManage reference
VBoxManage createhd	--filename <filename>
	--size <megabytes>
	[--format VDIVMDKVHD] (default: VDI)
	[--variant Standard,Fixed,Split2G,Stream,ESX]
	[--type normalwritethrough] (default: normal)
	[--comment <comment>]
	[--remember]

where the parameters mean:

filename Allows to choose a file name. Mandatory.

size Allows to define the image capacity, in 1 MiB units. Mandatory.

format Allows to choose a file format for the output file different from the file format of the input file.

variant Allows to choose a file format variant for the output file. It is a comma- separated list of variant flags. Not all combinations are supported, and specifying inconsistent flags will result in an error message.

type Only honored if –remember is also specified. Defines what kind of hard disk type this image should be.

comment Allows to attach a comment to the image.

remember Keep the destination image registered after it was successfully written.

Note: For compatibility with earlier versions of VirtualBox, the “createvdi” command is also supported and mapped internally to the “createhd” com- mand.

8.16 VBoxManage modifyhd

With the modifyhd command, you can change the type of an existing image between the normal, immutable and write-through modes; see chapter 5.4, Special image write modes, page 81 for details.

Note: For compatibility with earlier versions of VirtualBox, the “modifyvdi” command is also supported and mapped internally to the “modifyhd” com- mand.

For immutable (differencing) hard disks only, the modifyhd autoreset onoff command determines whether the disk is automatically reset on every VM startup (again, see chapter 5.4, Special image write modes, page 81). The default is “on”.

126