8 VBoxManage reference
The take operation takes a snapshot of the current state of the virtual machine. You must supply a name for the snapshot and can optionally supply a description. The new snapshot is inserted into the snapshots tree as a child of the current snapshot and then becomes the new current snapshot.
The delete operation deletes a snapshot (specified by name or by UUID). This can take a while to finish since the differencing images associated with the snapshot might need to be merged with their child differencing images.
The restore operation will restore the given snapshot (specified by name or by UUID) by resetting the virtual machine’s settings and current state to that of the snap- shot. The previous current state of the machine will be lost. After this, the given snapshot becomes the new “current” snapshot so that subsequent snapshots are in- serted under the snapshot from which was restored.
With the edit operation, you can change the name or description of an existing snapshot.
With the showvminfo operation, you can view the virtual machine settings that were stored with an existing snapshot.
8.12 VBoxManage openmedium / closemedium
These commands register or unregister hard disk, DVD or floppy images in VirtualBox. This is the
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 storagectl / storageattach
These commands allow to attach new storage controllers to the VM, modify or remove the existing ones and also allows the user to change the hard disk, DVD or floppy images attached to them. The list of the storage controllers attached to the VM can be found by the command:
VBoxManage showvminfo <vmname>
See also chapter 8.2, VBoxManage showvminfo, page 112.
123
