8 VBoxManage 8.24 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 machine Fe- dora5, 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 4.0.4 (C) 2005-2011 Oracle Corporation All rights reserved. Value: 2006.01.01 8.25 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: machinefolder This specifies the default folder in which virtual machine definitions are kept see chapter 10.1, Where VirtualBox stores its files, page 153 for details. vrdeauthlibrary This specifies which library to use when “external” authentication has been selected for a particular virtual machine see chapter 7.1.5, RDP authentication, page 94 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 refer- ence (see chapter 11, VirtualBox programming interfaces, page 163). vrdelibrary This specifies which library implements the VirtualBox Remote Desktop Extension. hwvirtexenabled This selects whether or not hardware virtualization support is enabled by default. 8.26 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 before 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 ap- plied. 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 125