8.4. VBoxManage list

Oracle VM VirtualBox

8.4. VBoxManage list

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 the showvminfo command (see below).

  • runningvms lists all currently running virtual machines by their unique identifiers (UUIDs) in the same format as with vms.

  • ostypes lists all guest operating systems presently known to VirtualBox, along with the identifiers used to refer to them with the modifyvm 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 and dhcpservers, 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 and floppies 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.