8VBoxManage reference

8.19VBoxManage getextradata/setextradata

These commands let you attach and retrieve string data to a virtual machine or to a VirtualBox configuration (by specifying global instead of a virtual machine name). You must specify a key (as a text string) to associate the data with, which you can later use to retrieve it. For example:

VBoxManage setextradata Fedora5 installdate 2006.01.01

VBoxManage setextradata SUSE10 installdate 2006.02.02

would associate the string “2006.01.01” with the key installdate for the virtual ma- chine Fedora5, and “2006.02.02” on the machine SUSE10. You could retrieve the information as follows:

VBoxManage getextradata Fedora5 installdate

which would return

VirtualBox Command Line Management Interface Version 3.0.0

(C)2005-2008 Sun Microsystems, Inc. All rights reserved.

Value: 2006.01.01

8.20 VBoxManage setproperty

This command is used to change global settings which affect the entire VirtualBox installation. Some of these correspond to the settings in the “Global settings” dialog in the graphical user interface. The following properties are available:

hdfolder This specifies the default folder that is used to keep disk image files (.vdi,

.vmdk, .vhd).

machinefolder This specifies the default folder in which virtual machine definitions are kept; see chapter 9.1, VirtualBox configuration data, page 127 for details.

vrdpauthlibrary This specifies which library to use when “external” VRDP authenti- cation has been selected for a particular virtual machine; see chapter 7.4.4, RDP authentication, page 97 for details.

websrvauthlibrary This specifies which library the web service uses to authenticate users. For details about the VirtualBox web service, please refer to the separate VirtualBox SDK reference (see chapter 10, VirtualBox programming interfaces, page 143).

hwvirtexenabled This selects whether or not hardware virtualization support is en- abled by default.

121

Page 121
Image 121
Sun Microsystems 3.0.0 user manual VBoxManage getextradata/setextradata, VBoxManage setproperty