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 VDI|VMDK|VHD] (default: VDI)
[--variant Standard,Fixed,Split2G,Stream,ESX]
[--type normal|writethrough] (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
