VBoxManage est la commande VirtualBox qui vous permet d’administrer et gérer vos VM.
Avec cet utilitaire vous pouvez tout faire, créer, arrêter, configurer et modifier une machine virtuelle.
VBoxManage prend en charge toutes les fonctionnalités auxquelles l’interface utilisateur graphique vous donne accès, mais il prend en charge bien plus que cela.
Il expose toutes les fonctionnalités du moteur de virtualisation, même celles qui ne sont pas accessibles à partir de l’interface graphique.
En clair donc, cet outil en ligne de commandes vous donne le contrôle totale de VirtualBox.
Dans cet article, nous allons voir les principales utilisations de VBoxManage afin de gérer une VM.
Table des matières
VboxManage : comment ça marche
VboxManage fonctionne selon deux principes :
- une sous-commande comme list or createvm or startvm. Le tableau plus bas dans l’article donne la liste
- le nom de la machine virtuelle sur laquelle on travaille
Le nom de la VM se récupère à différents endroits comme dans la liste des VM, dans la configuration ou les propriétés de celle-ci.
Ce qui donne donc l’exemple suivant :
"C:\Program Files\Oracle\VirtualBox\vboxmanage.exe" startvm Windows-10- la sous commande est startvm afin de démarrer la VM
- Le nom de la VM est Windows-10
Liste des commandes VboxManage
Oracle fournit une documentation complète des sous-commandes VboxManage disponible depuis ce lien.
Voici la liste des sous-commandes.
| Sous-commande VboxManage | Description |
| list | Lister les VM créées |
| showvminfo | Donner les propriétés de la VM |
| registervm/unregistervm | Importer une définition de machine virtuelle dans un fichier XML dans Oracle VM VirtualBox |
| createvm | Créér une VM |
| modifyvm | Modifier la configuration de la VM |
| movevm | Déplacer une machine virtuelle vers un nouvel emplacement sur l’hôte. |
| import | Importer une machine virtuelle |
| export | Exporter une machine virtuelle |
| startvm | Démarrer une VM |
| controlvm | Permettre de changer l’état d’une machine virtuelle en cours d’exécution |
| discardstate | Rejetter l’état enregistré d’une machine virtuelle qui n’est pas en cours d’exécution. Cela entraînera le redémarrage du système d’exploitation de la VM la prochaine fois que vous le démarrerez. Cela équivaut à retirer le câble d’alimentation d’une machine physique et doit être évité si possible |
| adoptstate | Si vous disposez d’un fichier d’état enregistré (.sav) distinct de la configuration de la machine virtuelle, vous pouvez utiliser cette commande pour adopter le fichier. Cela changera la machine virtuelle en état enregistré et lorsque vous la démarrerez, Oracle VM VirtualBox tentera de la restaurer à partir du fichier d’état enregistré que vous avez indiqué. Cette commande ne doit être utilisée que dans des configurations spéciales |
| closemedium | Supprimer un disque dur, un DVD ou une image de disquette d’un registre de supports Oracle VM VirtualBox |
| storageattach | Attacher, modifier et supprimer un support de stockage connecté à un contrôleur de stockage qui a été précédemment ajouté avec la commande storagectl |
| storagectl | Attacher, modifier et supprimer un contrôleur de stockage. Après cela, le support virtuel peut être attaché au contrôleur avec la commande storageattach |
| bandwidthctl | Créer, supprimer, modifier et afficher les groupes de bande passante de la machine virtuelle donnée |
| showmediuminfo | Afficher des informations sur un support, notamment sa taille, sa taille sur disque, son type et les machines virtuelles qui l’utilisent. |
| createmedium | Créer un nouveau support |
| modifymedium | Modifier les caractéristiques d’une image disque après sa création |
| clonemedium | Duplique un disque virtuel, un DVD ou un support de disquette sur un nouveau support, généralement un fichier image, avec un nouvel identifiant unique (UUID). La nouvelle image peut être transférée vers un autre système hôte ou réimportée dans Oracle VM VirtualBox à l’aide de Virtual Media Manager |
| mediumproperty | Cette commande définit, obtient ou supprime une propriété moyenne |
| encryptmedium | Créer un support ou une image crypté DEK |
| checkmediumpwd | Vérifier le mot de passe de cryptage actuel sur un support ou une image crypté DEK |
| convertfromraw | Convertir une image disque brute en un fichier d’image disque (VDI) Oracle VM VirtualBox |
| getextradata/setextradata | Attacher et de récupérer des données de chaîne pour une machine virtuelle ou pour une configuration Oracle VM VirtualBox, en spécifiant global au lieu d’un nom de machine virtuelle |
| setproperty | Modifier les paramètres globaux qui affectent l’ensemble de l’installation d’Oracle VM VirtualBox. Certains d’entre eux correspondent aux paramètres de la boîte de dialogue Paramètres globaux de l’interface utilisateur graphique |
| usbfilter add/modify/remove | Modifier les filtres USB dans des machines virtuelles ou des filtres globaux qui affectent l’ensemble de la configuration d’Oracle VM VirtualBox |
| guestproperty | Obtenir ou de définir les propriétés d’une machine virtuelle en cours d’exécution |
| guestcontrol | Les commandes guestcontrol permettent le contrôle de l’invité depuis l’hôte |
| metrics | Prendre en charge la surveillance de l’utilisation des ressources système. Les ressources sont représentées par diverses métriques associées au système hôte ou à une machine virtuelle particulière |
| natnetwork | Configurer les réseaux NAT |
| hostonlyif | Modifier la configuration IP d’une interface réseau d’hôte uniquement |
| usbdevsource | Ajouter et de supprimer des périphériques USB globalement |
| unattended | Installation du système d’exploitation invité sans assistance |
| snapshot | Gérer les instantanés de la machine virtuelle Oracle VM VirtualBox |
| clonevm | Créer un clone d’une machine virtuelle Oracle VM VirtualBox existante |
| sharedfolder | Ajouter et supprimer des dossiers partagés |
| extpack | Gestion des packages d’extension |
| dhcpserver | Gestion du serveur DHCP |
| debugvm | Introspection et débogage invité |
| cloudprofile | Gérez les profils cloud |
| cloud | Gérer les entités cloud |
Comme vous pouvez le voir, c’est très complet car on peut tout faire en ligne de commandes sur VirtualBox.
Il serait don compliqué d’énumérer tous les cas.
Toutefois voici quelques exemples de ce que l’on peut faire avec VboxManage.
Gérer une VM VirtualBox en ligne de commandes
Créer une VM en ligne de commandes
Il est tout à fait possible d’ajouter une nouvelle VM et installer un OS en ligne de commandes.
L’article suivant vous guide avec toutes les commandes et syntaxes à utiliser.
Exécuter une VM avec VBoxManage
Enfin toutes les commandes pour exécuter, arrêter, suspendre une machine virtuelle :
Afficher les propriétés d’une VM
On peut aussi lister les VM installées, pour cela on utilise la commande VBoxManage de cette manière :
"C:\Program Files\Oracle\VirtualBox\vboxmanage.exe" list vms
Mais la sous-commande list propose beaucoup d’options.
On peut par exemple lister les disques dur, obtenir des informations sur les réseaux VirtualBox
La liste complète est disponible dans le manuel VirtualBox.
Par exemple list hdds donnent la liste des disques virtuels.
"C:\Program Files\Oracle\VirtualBox\vboxmanage.exe" list hdds
"C:\Program Files\Oracle\VirtualBox\vboxmanage.exe" showvminfo "Windows-10"
Créer, restaurer et supprimer un instantané
On peut aussi très facilement gérer les snapshots en ligne de commandes.
La sous-commande showvminfo donne la liste des instantanées à la fin avec leurs identifiants (UUID)
"C:\Program Files\Oracle\VirtualBox\vboxmanage.exe" showvminfo "Windows-10"Pour les gérer, on utilise la sous-commande snapshot :
- edit vous permet de changer le nom ou la description d’un instantané spécifié.
- list : liste les instantanés
- restore pour restaurer un instantané
- restorecurrent : restaure l’instantané actuel
- take prend un instantané de l’état actuel de la machine virtuelle.
- delete pour supprimer un snapshot
Ainsi on peut aussi lister les instantannés avec snaphost list :
"C:\Program Files\Oracle\VirtualBox\vboxmanage.exe" snapshot "Windows-10" list
Puis il est possible de créer un snapshot avec la commande take.
Il faut spécifié le nom du snapshot.
L’option –live indique de ne pas arrêter la VM.
"C:\Program Files\Oracle\VirtualBox\vboxmanage.exe" snapshot "Windows-10" take "Super instant" --live
Ensuite pour revenir à un instantané :
vboxmanage snapshot <nom de la VM> restore <UUID du snapshot>Et puis pour restaurer un intantané de la VM Windows-10 et l’instannée avec l’UUID 2bc2ece2-f08d-4b0d-a1b1-6651742eb2d4 :
vboxmanage snapshot "Windows-10" restore 2bc2ece2-f08d-4b0d-a1b1-6651742eb2d4
Enfin pour supprimer un snapshot en ligne de commandes :
vboxmanage snapshot <nom de la VM> delete <UUID du snapshot>Cloner la VM
Enfin on peut aussi cloner la VM.
Cela consiste à dupliquer celle-ci par exemple pour effectuer des textes.
Pour cela, on utilise la commande clonevm.
VBoxManage clonevm Windows-10 --name="Windows-10-001" --register --mode=all --options=keepallmacs --options=keepdisknames --options=keephwuuidsLe paramètre –options permet de garder les adresses MAC, utilsiateurs et UUID.