{{tag>virtualbox vm machine virtuelle}}

====== Notes Virtualbox ======

Notes sur la gestion/administration des machines virtuelles avec VirtualBox. L'ensemble des fonctions d'administration des VMs peuvent être exécutées en ligne de commande via **vboxmanage**.

===== Lister =====

Obtenir le nom des machines virtuelles existantes:

<code bash>
$ vboxmanage list vms
</code>

L'argument **list** peut être suivi de nombreuses options notamment:

^ **runningvms** | machines virtuelles en cours d'execution  |
^ **hostinfo**   | informations système sur la machine hote |
^ **hdds**       | les fichiers disques déclarés sous virtualbox utilisables par les vms |

  
===== Exécuter une vm =====

Poure lancer l'exécution d'une machine virtuelle depuis la ligne de commande:
<code bash>
$ vboxmanage startvm "arch-linux"
</code>

===== Partages entre systèmes hôte/invité =====

Pour partager des dossiers entre l'hôte et l'invité, installer les **Additions invités**.
Menu **Périphériques -> Additions invités**.\\
Puis, dans le menu **Périphériques -> répertoires partagés...** déclarer un nouveau partage.

Ou via vboxmanage:

<code bash>
$ vboxmanage sharedfolder add "nom VM" --name "sharename" --hostpath "C:\test"
</code>

A noter les options:
^ **%%--%%readonly** | Pour que les fichiers de l’hôte soient en lecture seule (au lieu de rw par défaut) |
^ **%%--%%transient**| Montage temporaire, peut être déclaré alors que la VM est en cours de fonctionnement |
==== Montage du partage ====

Si le système invité est de type GNU/linux monter le partage précédemment déclaré via **mount**:

<code bash>
sudo mount -t vboxsf partage /home/user/mount-point
</code>

<note>
Si lors de la tentative de montage le message d'erreur ''mount: unknown filesystem type 'vboxsf' '' apparaît, vérifier l'[[app:virtualbox:cd-additions-invite-introuvable|installation des additions invités]].
</note>

Si le système invité est de type Windows utiliser la commande **net use**:
<code>
> net use X: \\vboxsrv\partage
</code>


==== Arrêter une VM ====

La meilleure option reste l'arret via le système invité. Si celui-ci ne répond pas ou est injoignable via la connexion **VRDE** l'argument **controlvm** permet d'arreter les VMs:

<code bash>
$ vboxmanage controlvm winxp acpipowerbutton
</code>

Cette commande permet d'envoyer au système invité l'information que le bouton d'allumage a été enfoncé par l'utilisateur cependant le système invité doit gérer l'**ACPI** pour y réagir. Quelques options également disponibles:

^ **savestate**  | Enregistre l'état de la machine sur disque dur. Lors du redémarrage l'état précédent est restauré (équivaut à l'hibernation). |
^ **poweroff**   | Arret brutal de la VM, équivaut a une coupure de l'alimentation électrique. |

===== Références =====

  * GLM HS n°72
  * http://www.virtualbox.org/manual/ch07.html