Sun Microsystems VERSION 3.1.0_BETA2 用户手册

8 VBoxManage reference

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:

Allows to choose a file name. Mandatory.

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

Allows to choose a file format for the output file different from the file format

of the input file.

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.

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

this image should be.

Allows to attach a comment to the image.

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.

With the modifyhd command, you can change the type of an existing image between
the normal, immutable and write-through modes; see chapter

, page

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 on|off

command determines whether the disk is automatically reset on every VM startup
(again, see chapter

, page

). The default is “on”.

126