Sun Microsystems 3.0.0 user manual VBoxManage showhdinfo, VBoxManage createhd

8 VBoxManage reference

Note: For compatibility with earlier versions of VirtualBox, the “registerim- age” and “unregisterimage” commands are also supported and mapped inter- nally to the “openmedium” and “closemedium” commands, respectively.

Note however that when you unregister a hard disk image using VBoxManage, it will not be deleted from the host computer’s hard drive.

8.13 VBoxManage showhdinfo

This command shows information about a virtual hard disk image, notably its size, its size on disk, its type and the VM it is in use by.

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

8.14 VBoxManage createhd

This command creates a new virtual hard disk image. The syntax is as follows:

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.

117