Sun Microsystems VERSION 3.1.0_BETA2 user manual VBoxManage setproperty

8VBoxManage reference

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