VBoxManage est l'outil en ligne de commande de VirtualBox qui permet de contrôler tous les aspects de vos machines virtuelles. Cette fiche interactive présente les commandes essentielles pour créer et gérer vos VMs.
📑 Sommaire
📦 Création de la machine
VBoxManage createvm --name "MaVM" --ostype "Debian_64" --register
Cette commande crée une VM Debian 64 bits et l'enregistre dans VirtualBox.
Options importantes :
--name: Nom de la machine virtuelle--ostype: Type de système d'exploitation (utilisezVBoxManage list ostypespour voir les options)--register: Enregistre la VM dans VirtualBox
🧠 CPU et mémoire
VBoxManage modifyvm "MaVM" --memory 4096 --cpus 2
Alloue 4 Go de RAM et 2 cœurs CPU à la machine virtuelle.
Paramètres additionnels :
VBoxManage modifyvm "MaVM" --vram 128 # Mémoire vidéo (128 Mo)
VBoxManage modifyvm "MaVM" --pae on # Extension d'adresse physique
VBoxManage modifyvm "MaVM" --nestedpaging on # Pagination imbriquée
💾 Disques et contrôleurs
VBoxManage storagectl "MaVM" --name "SATA_Controller" --add sata --controller IntelAhci
VBoxManage createmedium disk --filename "MaVM.vdi" --size 20000
VBoxManage storageattach "MaVM" --storagectl "SATA_Controller" --port 0 --device 0 --type hdd --medium "MaVM.vdi"
Ces commandes créent et attachent un disque virtuel de 20 Go à la machine virtuelle.
Explication des étapes :
- Création d'un contrôleur SATA
- Création d'un disque virtuel de 20 Go (taille en Mo)
- Attachement du disque au contrôleur SATA
Pour attacher une image ISO (CD/DVD) :
VBoxManage storageattach "MaVM" --storagectl "SATA_Controller" --port 1 --device 0 --type dvddrive --medium /chemin/vers/image.iso
🌐 Réseau
VBoxManage modifyvm "MaVM" --nic1 nat --nic2 bridged --bridgeadapter2 eth0
Configuration avec deux interfaces réseau :
- NIC 1 : Mode NAT (accès Internet, port forwarding)
- NIC 2 : Mode Bridged (connexion directe au réseau physique)
Autres modes réseau disponibles :
VBoxManage modifyvm "MaVM" --nic3 intnet --intnet3 "reseau_interne" # Réseau interne
VBoxManage modifyvm "MaVM" --nic4 hostonly --hostonlyadapter4 "vboxnet0" # Réseau hôte uniquement
Configuration de redirection de port (port forwarding) :
VBoxManage modifyvm "MaVM" --natpf1 "ssh,tcp,,2222,,22"
Cela redirige le port 2222 de l'hôte vers le port 22 de la VM.
👤 GuestControl – exécuter une commande dans la VM
VBoxManage guestcontrol "MaVM" run --exe "/bin/ls" \
--username user1 --passwordfile pw.txt --wait-stdout -- -l /usr
Exécute ls -l /usr dans la VM en tant que user1.
Paramètres importants :
--exe: Chemin complet vers l'exécutable dans la VM--username/--password: Identifiants utilisateur--wait-stdout: Attendre et afficher la sortie standard- Arguments après
--: passés à la commande exécutée
📂 Transfert de fichiers (host ↔ guest)
VBoxManage guestcontrol "MaVM" copyto ./localfile.txt /home/user/file.txt \
--username user1 --password password --verbose
Transfère un fichier du système hôte vers la VM invitée.
Pour copier depuis la VM vers l'hôte :
VBoxManage guestcontrol "MaVM" copyfrom /home/user/file.txt ./localfile.txt \
--username user1 --password password --verbose
🛠️ Opérations avancées
VBoxManage guestcontrol "MaVM" mkdir /home/user/mon_dossier \
--username user1 --password password --parents --verbose
VBoxManage guestcontrol "MaVM" fsinfo /home/user \
--username user1 --password password --human-readable
Ces commandes permettent de :
- Créer un répertoire dans la VM avec création des répertoires parents si nécessaire
- Récupérer des informations sur le système de fichiers de la VM
Autres opérations disponibles :
VBoxManage guestcontrol "MaVM" rmdir /home/user/mon_dossier # Supprimer un dossier
VBoxManage guestcontrol "MaVM" rm /home/user/file.txt # Supprimer un fichier
VBoxManage guestcontrol "MaVM" stat /home/user/file.txt # Informations sur un fichier
⚙️ Gestion des sessions
VBoxManage guestcontrol "MaVM" list all --verbose
VBoxManage guestcontrol "MaVM" closesession --all --verbose
Ces commandes permettent de :
- Lister toutes les sessions actives dans la VM
- Fermer toutes les sessions actives
Pour fermer une session spécifique, utilisez son ID :
VBoxManage guestcontrol "MaVM" closesession --session-id 1
🔄 Mise à jour des Guest Additions
VBoxManage guestcontrol "MaVM" updatega \
--source="VBoxGuestAdditions.iso" --wait-start --verbose
Mise à jour des Additions Invitées via une image ISO.
Les Guest Additions offrent des fonctionnalités supplémentaires :
- Intégration du pointeur de la souris
- Dossiers partagés entre l'hôte et l'invité
- Meilleure intégration avec le bureau
- Prise en charge de la résolution d'écran dynamique