The list
command gives relevant
information about your system and information about VirtualBox's current
settings.
The following subcommands are available with
VBoxManage list
:
-
vms
lists all virtual machines currently registered with VirtualBox. By default this displays a compact list with each VM's name and UUID; if you also specify--long
or-l
, this will be a detailed list as with theshowvminfo
command (see below). -
runningvms
lists all currently running virtual machines by their unique identifiers (UUIDs) in the same format as withvms
. -
ostypes
lists all guest operating systems presently known to VirtualBox, along with the identifiers used to refer to them with themodifyvm
command. -
hostdvds
,hostfloppies
, respectively, list DVD, floppy, bridged networking and host-only networking interfaces on the host, along with the name used to access them from within VirtualBox. -
intnets
displays information about the internal networks. -
bridgedifs
,hostonlyifs
,natnets
anddhcpservers
, respectively, list bridged network interfaces, host-only network interfaces, NAT network interfaces and DHCP servers currently available on the host. Please see Chapter 6, Virtual networking for details on these. -
hostinfo
displays information about the host system, such as CPUs, memory size and operating system version. -
hostcpuids
dumps the CPUID parameters for the host CPUs. This can be used for a more fine grained analyis of the host's virtualization capabilities. -
hddbackends
lists all known virtual disk back-ends of VirtualBox. For each such format (such as VDI, VMDK or RAW), this lists the back-end's capabilities and configuration. -
hdds
,dvds
andfloppies
all give you information about virtual disk images currently in use by VirtualBox, including all their settings, the unique identifiers (UUIDs) associated with them by VirtualBox and all files associated with them. This is the command-line equivalent of the Virtual Media Manager; see Section 5.3, “The Virtual Media Manager”. -
usbhost
supplies information about USB devices attached to the host, notably information useful for constructing USB filters and whether they are currently in use by the host. -
usbfilters
lists all global USB filters registered with VirtualBox -- that is, filters for devices which are accessible to all virtual machines -- and displays the filter parameters. -
systemproperties
displays some global VirtualBox settings, such as minimum and maximum guest RAM and virtual hard disk size, folder settings and the current authentication library in use. -
extpacks
displays all VirtualBox extension packs currently installed; see Section 1.5, “Installing VirtualBox and extension packs” and Section 8.41, “VBoxManage extpack” for more information. -
groups
displays details of the VM Groups; see Section 1.9, “Using VM groups” for more information. -
webcams
displays a list of webcams attached to the running VM. The output format is a list of absolute paths or aliases that were used for attaching the webcams to the VM using the 'webcam attach' command. -
screenshotformats
displays a list of available screenshot formats.