Sun Microsystems 3.0.0 用户手册

8 VBoxManage reference

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”.

In addition, the modifyhd --compact command can be used to compact disk im-

ages, i.e. remove blocks that only contains zeroes. For this operation to be effective,
it is required to zero out free space in the guest system using a suitable software tool.
Microsoft provides the sdelete tool for Windows guests. Execute sdelete -c in
the guest to zero the free disk space before compressing the virtual disk image. Com-
paction works both for base images and for diff images created as part of a snapshot.

This command duplicates a registered virtual hard disk image to a new image file with
a new unique identifier (UUID). The new image can be transferred to another host
system or imported into VirtualBox again using the Virtual Disk Manager; see chapter

, page

and chapter

, page

The syntax is as follows:

VBoxManage clonehd

<uuid>|<filename> <outputfile>

[--format VDI|VMDK|VHD|RAW|<other>]

[--variant Standard,Fixed,Split2G,Stream,ESX]

[--type normal|writethrough|immutable]

[--remember]

where the parameters mean:

118