This command creates a new medium. The syntax is as follows:
VBoxManage createmedium [disk|dvd|floppy] --filename <filename>
[--size <megabytes>|--sizebyte <bytes>]
[--diffparent <uuid>|<filename>
[--format VDI|VMDK|VHD] (default: VDI)
[--variant Standard,Fixed,Split2G,Stream,ESX]
where the parameters mean:
-
--filename <filename> -
Specifies a file name <filename> as an absolute path on the host file system. Mandatory.
-
--size <megabytes> -
<megabytes> Specifies the image capacity, in 1 MB units. Optional.
-
--diffparent <uuid>|<filename> -
Specifies the differencing image parent, either as a UUID or by the absolute pathname of the file on the host file system. Useful for sharing a base box disk image among several VMs.
-
--format VDI|VMDK|VHD -
Specifies the file format for the output file. Available options are VDI, VMDK, VHD. Default is VDI. Optional.
-
--variant Standard,Fixed,Split2G,Stream,ESX -
Specifies any required file format variant(s) for the output file. It is a comma-separated list of variant flags. Not all combinations are supported, and specifying mutually incompatible flags results in an error message. Optional.
Note
For compatibility with earlier versions of VirtualBox, the "createvdi" and "createhd" commands are also supported and mapped internally to the "createmedium" command.