VirtualBox : VBoxManage, commandes de base

VBoxManage est l’outil en ligne de commande de VirtualBox. Il s’exécute avec l’utilisateur propriétaire des machines, sans sudo.

Aide

VBoxManage --version
VBoxManage                       # liste des sous-commandes
VBoxManage modifyvm              # aide d'une sous-commande
man VBoxManage

Lister

VBoxManage list vms              # machines enregistrées : « "srv1" {uuid} »
VBoxManage list runningvms       # machines en cours d'exécution
VBoxManage list ostypes          # identifiants de systèmes (Ubuntu_64, Debian_64…)
VBoxManage list hdds             # disques enregistrés
VBoxManage list dvds             # images ISO enregistrées
VBoxManage list bridgedifs       # interfaces réseau de l'hôte (réseau par pont)
VBoxManage list hostonlyifs      # interfaces hôte uniquement
VBoxManage list extpacks
VBoxManage list systemproperties # paramètres globaux

Une machine se désigne par son nom (entre guillemets s’il contient des espaces) ou par son UUID.

Afficher une machine

VBoxManage showvminfo srv1                       # tout
VBoxManage showvminfo srv1 --machinereadable     # clé=valeur, pour les scripts
VBoxManage showvminfo srv1 --machinereadable | grep -E '^(VMState|memory|cpus)='
VBoxManage showvminfo srv1 --details

VMState vaut running, poweroff, saved, paused ou aborted.

États et sorties exploitables

VBoxManage list vms | cut -d'"' -f2                          # noms seulement
VBoxManage showvminfo srv1 --machinereadable | grep '^VMState=' | cut -d'"' -f2

Script qui teste si une machine tourne :

if VBoxManage list runningvms | grep -q '"srv1"'; then
    echo "srv1 tourne"
fi

Informations sur l’hôte

VBoxManage list cpu-profiles | head
VBoxManage list hostinfo
VBoxManage list hostcpuids | head

Supprimer

VBoxManage unregistervm srv1                # retire la machine du registre (fichiers conservés)
VBoxManage unregistervm srv1 --delete       # supprime aussi ses fichiers

Dossiers et fichiers d’une machine

VBoxManage showvminfo srv1 --machinereadable | grep -E '^(CfgFile|"SATA-0-0")='

Un dossier de machine contient srv1.vbox (configuration), les disques (.vdi), Logs/ et Snapshots/.

Journaux

VBoxManage showvminfo srv1 --log 0 | head
tail -n 50 "/srv/vms/srv1/Logs/VBox.log"

VBox.log détaille le démarrage et la plupart des erreurs de machine.

Dépannage

Symptôme	Piste
`Could not find a registered machine named 'srv1'`	Nom incorrect ou autre utilisateur : `VBoxManage list vms` avec le bon compte
`VBoxManage: error: The VM session was closed before any attempt to power it on`	Lire `Logs/VBox.log`
Liste vide alors que des machines existent	Exécuté avec un autre utilisateur (chaque utilisateur a son registre)
`error: Cannot register the hard disk … already exists`	Disque déjà enregistré : `VBoxManage list hdds`

Ubuntu 24.04 et 26.04 : différences à connaître

Les sous-commandes de cette page existent sur VirtualBox 7.x ; la sortie peut légèrement varier d’une version mineure à l’autre.

Pour aller plus loin

Manuel VBoxManage
Suite : Créer une machine virtuelle