19 vboxmanage getextradata/setextradata, 20 vboxmanage setproperty – Sun Microsystems VIRTUALBOX 3.0.0 User Manual

Page 121

Advertising
background image

8 VBoxManage reference

8.19 VBoxManage 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

Advertising