Sun Microsystems VIRTUALBOX VERSION 3.1.0_BETA2 - Manual (Page 130)

8 VBoxManage reference
8.21 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 135 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.5 , RDP
authentication , page 104 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 154 ).
hwvirtexenabled This selects whether or not hardware virtualization support is en-
abled by default.
8.22 VBoxManage usbfilter add/modify/remove
The usbfilter commands are used for working with USB filters in virtual machines,
or global filters which affect the whole VirtualBox setup. Global filters are applied be-
fore machine-specific filters, and may be used to prevent devices from being captured
by any virtual machine. Global filters are always applied in a particular order, and only
the first filter which fits a device is applied. So for example, if the first global filter says
to hold (make available) a particular Kingston memory stick device and the second to
ignore all Kingston devices, that memory stick will be available to any machine with
an appropriate filter, but no other Kingston device will.
When creating a USB filter using usbfilter add, you must supply three or four
mandatory parameters. The index specifies the position in the list at which the filter
should be placed. If there is already a filter at that position, then it and the following
ones will be shifted back one place. Otherwise the new filter will be added onto the
end of the list. The target parameter selects the virtual machine that the filter should
be attached to or use “global” to apply it to all virtual machines. name is a name for
the new filter and for global filters, action says whether to allow machines access
to devices that fit the filter description (“hold”) or not to give them access (“ignore”).
In addition, you should specify parameters to filter by. You can find the parameters
for devices attached to your system using VBoxManage list usbhost. Finally, you
can specify whether the filter should be active, and for local filters, whether they are
for local devices, remote (over an RDP connection) or either.
130