<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
<chapter id="vboxmanage">
<title>VBoxManage</title>
<sect1>
<title>Introduction</title>
<para>Comme brièvement indiqué au <xref linkend="frontends" />, VBoxManage
est l'interface en ligne de commande de VirtualBox. Avec elle, vous pouvez
contrôler complètement VirtualBox depuis la ligne de commandes
de votre système d'exploitation hôte.
VBoxManage supporte toutes les fonctionnalités auxquelles vous donne accès
l'interface graphique, mais il supporte bien plus que ça. Il ouvre vraiment
toutes les fonctions du moteur de virtualisation, même celles auxquelles on
ne peut pas (encore) accéder en mode graphique.</para>
<para>Vous devrez utiliser la ligne de commande si vous voulez</para>
<para><itemizedlist>
<listitem>
<para>utiliser une autre interface que celle graphique (par exemple,
VBoxSDL ou le serveur VBoxHeadless) ;</para>
</listitem>
<listitem>
<para>contrôler certains paramètres de configuration plus avancés et
expérimentaux d'une VM.</para>
</listitem>
</itemizedlist></para>
<para>Il faut avoir en tête deux choses en utilisant
<computeroutput>VBoxManage</computeroutput> : D'abord,
<computeroutput>VBoxManage</computeroutput> doit toujours être utilisé
avec des "sous-commandes" spécifiques telles que "list" ou "createvm" ou
"startvm". Toutes les sous-commandes supportées par
<computeroutput>VBoxManage</computeroutput> sont décrites en détail à la
<xref linkend="vboxmanage" />.</para>
<para>Ensuite, la plupart de ces sous-commandes exigent que vous spécifiez
une machine virtuelle en particulier après la sous-commande. Il y a deux façons
de faire cela :</para>
<itemizedlist>
<listitem>
<para>Vous pouvez spécifier le nom de la VM comme il s'affiche dans
l'interface graphique de VirtualBox. Remarquez que si ce nom contient des
espaces, vous devez l'entourer de guillemets (comme cela est toujours
le cas avec les arguments d'une ligne de commande contenant des espaces).</para>
<para>Par exemple :<screen>VBoxManage startvm "Windows XP"</screen></para>
</listitem>
<listitem>
<para>Vous pouvez spécifier l'UUID, qui est l'identifiant interne unique
utilisé par VirtualBox pour parler de la machine virtuelle. En supposant que
la VM précitée nommée "Windows XP" porte l'UUID affiché ci-dessous,
la commande suivante a le même effet que celle précédente :<screen>VBoxManage startvm 670e746d-abea-4ba6-ad02-2a3b043810a5</screen></para>
</listitem>
</itemizedlist>
<para>Vous pouvez taper <computeroutput>VBoxManage list vms</computeroutput>
pour voir toutes les VMs enregistrées ; listées avec leurs paramètres,
y compris leurs noms respectifs et leurs UUIDs.</para>
<para>Des exemples classiques de la façon de contrôler VirtualBox depuis la
ligne de commande apparaissent ci-dessous :</para>
<itemizedlist>
<listitem>
<para>Pour créer une nouvelle machine virtuelle en ligne de commandes
et l'enregistrer immédiatement avec VirtualBox, utilisez
<computeroutput>VBoxManage createvm</computeroutput> avec l'option
<computeroutput>--register</computeroutput>,<footnote>
<para>Pour des détails, voir <xref
linkend="vboxmanage-createvm" />.</para>
</footnote> comme ceci :</para>
<screen>$ VBoxManage createvm --name "SUSE 10.2" --register
VirtualBox Command Line Management Interface Version $VBOX_VERSION_MAJOR.$VBOX_VERSION_MINOR.$VBOX_VERSION_BUILD
(C) 2005-$VBOX_C_YEAR $VBOX_VENDOR
All rights reserved.
Virtual machine 'SUSE 10.2' is created.
UUID: c89fc351-8ec6-4f02-a048-57f4d25288e5
<para>Comme vous pouvez le voir dans la sortie ci-dessus, une nouvelle
machine virtuelle a été créée avec le nouvel UUID et un nouveau fichier
XML de paramètres.</para>
</listitem>
<listitem>
<para>Pour afficher la configuration d'une VM en particulier, utilisez
<computeroutput>VBoxManage showvminfo</computeroutput> ; voir <xref
linkend="vboxmanage-showvminfo" /> pour des détails et un exemple.</para>
</listitem>
<listitem>
<para>Pour modifier les paramètres pendant qu'une VM est éteinte, utilisez
<computeroutput>VBoxManage modifyvm</computeroutput>, comme ceci :
<screen>VBoxManage modifyvm "Windows XP" --memory 512</screen></para>
<para>Pour des détails,voir <xref linkend="vboxmanage-modifyvm" />.</para>
</listitem>
<listitem>
<para>Pour modifier la configuration du stockage (par exemple pour ajouter un
contrôleur de stockage et ensuite un disque virtuel), utilisez <computeroutput>VBoxManage
storagectl</computeroutput> et <computeroutput>VBoxManage
storageattach</computeroutput> ; voir <xref
linkend="vboxmanage-storagectl" /> et <xref
linkend="vboxmanage-storageattach" /> pour les détails.</para>
</listitem>
<listitem>
<para>Pour contrôler le comportement de la VM, utilisez :<itemizedlist>
<listitem>
<para>Pour démarrer une VM éteinte, utilisez
<computeroutput>VBoxManage startvm</computeroutput> ; voir <xref
linkend="vboxmanage-startvm" /> pour les détails.</para>
</listitem>
<listitem>
<para>Pour mettre en pause ou sauvegarder une VM en fonction, ou
pour modifier certains de ses paramètres, utilisez
<computeroutput>VBoxManage
controlvm</computeroutput> ; voir <xref
linkend="vboxmanage-controlvm" /> pour les détails.</para>
</listitem>
</itemizedlist></para>
</listitem>
</itemizedlist>
</sect1>
<sect1>
<title>Aperçu des commandes</title>
<para>Quand vous lancez VBoxManage sans paramètres ou si vous entrez une ligne de
commande invalide, le diagramme de syntaxe ci-dessous s'affichera. Remarquez
que la sortie sera légèrement différente selon la plateforme hôte ;
en cas de doute, vérifiez la sortie de <computeroutput>VBoxManage</computeroutput>
pour voir les commandes disponibles sur votre hôte en particulier.</para>
<screen>$VBOX_MANAGE_OUTPUT</screen>
<para>À chaque fois que vous appelez VBoxManage, une seule commande peut être
exécutée. Toutefois, une commande peut supporter plusieurs sous-commandes
que vous pouvez appeler en une seule fois. Les sections suivantes fournissent
des informations de référence détaillées sur les différentes commandes.</para>
</sect1>
<sect1 id="vboxmanage-general">
<title>Options générales</title>
<para>
<itemizedlist>
<listitem>
<para><computeroutput>--version</computeroutput> : affiche la
version de cet outil et quitte.</para>
</listitem>
<listitem>
<para><computeroutput>--nologo</computeroutput> : supprime l'affichage
des informations de logo (utile pour les scripts)</para>
</listitem>
<listitem>
<para><computeroutput>--settingspw</computeroutput> : spécifie
un mot de passe pour les paramètres</para>
</listitem>
<listitem>
<para><computeroutput>--settingspwfile</computeroutput> : spécifie
un fichier contenant le mot de passe des paramètres</para>
</listitem>
</itemizedlist>
Le mot de passe des paramètres est utilisé pour certains paramètres ayant
besoin d'être stockés et chiffrés pour des raisons de sécurité. Pour le moment,
le seul paramètre chiffré est l'initiateur secret iSCSI (voir
<xref linkend="vboxmanage-storageattach" /> pour les détails). Tant
qu'aucun mot de passe des paramètres n'a été spécifié, ces informations
sont stockées en <emphasis role="bold">texte brut</emphasis>. Après avoir
utilisé l'option <computeroutput>--settingspw|--settingspwfile</computeroutput>
une fois, il faut toujours l'utiliser, sans quoi le paramètre chiffré ne peut pas
être chiffré.
</para>
</sect1>
<sect1 id="vboxmanage-list">
<title>VBoxManage list</title>
<para>La commande <computeroutput>list</computeroutput> donne des
informations pertinentes sur votre système et sur les paramètres actuels de
VirtualBox.</para>
<para>Les sous-commandes suivantes sont disponibles avec
<computeroutput>VBoxManage list</computeroutput> : <itemizedlist>
<listitem>
<para><computeroutput>vms</computeroutput> liste toutes les machines
virtuelles actuellement enregistrées avec VirtualBox. Par défaut, elle
affiche une liste compacte avec le nom et l'UUID de chaque VM ;
si vous spécifiez en plus <computeroutput>--long</computeroutput> ou
<computeroutput>-l</computeroutput>, cela affichera une liste détaillée
comme avec la commande<computeroutput>showvminfo</computeroutput> (voir
ci-dessous).</para>
</listitem>
<listitem>
<para><computeroutput>runningvms</computeroutput> liste toutes les
machines virtuelles actuellement en fonction avec leurs identifiants
uniques (UUIDs) sous la même forme qu'avec
<computeroutput>vms</computeroutput>.</para>
</listitem>
<listitem>
<para><computeroutput>ostypes</computeroutput> liste les systèmes
d'exploitation invités connus aujourd'hui de VirtualBox, ainsi que
les identifiants utilisés pour s'y référer avec la commande
<computeroutput>modifyvm</computeroutput>.</para>
</listitem>
<listitem>
<para><computeroutput>hostdvds</computeroutput>,
<computeroutput>hostfloppies</computeroutput>, listent respectivement
les lecteurs DVD, amovibles, les interfaces réseaux bridgées et
host-only sur l'hôte, ainsi que le nom utilisé pour y accéder depuis
VirtualBox.</para>
</listitem>
<listitem>
<para><computeroutput>bridgedifs</computeroutput>,
<computeroutput>hostonlyifs</computeroutput> aet
<computeroutput>dhcpservers</computeroutput>, listent respectivement
les interfaces réseaux bridgées, host-only et les serveurs DHCP disponibles
sur l'hôte. Merci de voir <xref
linkend="networkingdetails" /> pour les détails à leur sujet.</para>
</listitem>
<listitem>
<para><computeroutput>hostinfo</computeroutput> affiche des informations
sur le système hôte telles que les processeurs, la taille de la mémoire
et la version du système d'exploitation.</para>
</listitem>
<listitem>
<para><computeroutput>hostcpuids</computeroutput> affiche les paramètres
CPUID aux processeurs de l'hôte. Cela peut servir à une analyse plus
fine des possibilités de virtualisation de l'hôte.</para>
</listitem>
<listitem>
<para><computeroutput>hddbackends</computeroutput> liste les backends (fondations)
de disque virtuel connus de VirtualBox. Pour chaque format (tels que
VDI, VMDK ou RAW), ceci liste les possibilités de la fondation et sa
configuration.</para>
</listitem>
<listitem>
<para><computeroutput>hdds</computeroutput>,
<computeroutput>dvds</computeroutput> et
<computeroutput>floppies</computeroutput> vous donnent des informations
sur les images de disque virtuel actuellement utilisées par VirtualBox,
y compris leurs paramètres, leurs identifiants uniques (UUIDs)
associés par VirtualBox et tous leurs fichiers associés. C'est l'équivalent
ligne de commandes du gestionnaire de médias virtuels ; voir <xref
linkend="vdis" />.</para>
</listitem>
<listitem>
<para><computeroutput>usbhost</computeroutput> donne des informations
sur les périphériques USB attachés à l'hôte, en particulier des
informations utiles pour construire des filtres USB et s'ils sont actuellement
utilisés par l'hôte.</para>
</listitem>
<listitem>
<para><computeroutput>usbfilters</computeroutput> liste les filtres USB
globaux enregistrés avec VirtualBox -- c'est-à-dire les filtres des
périphériques accessibles à toutes les machines virtuelles -- et
il affiche les paramètres du filtre.</para>
</listitem>
<listitem>
<para><computeroutput>systemproperties</computeroutput> affiche des
paramètres globaux de VirtualBox, tels que la RAM minimum et maximum
de l'invité et la taille du disque dur virtuel, les paramètres du
dossier et la bibliothèque d'authentification actuellement utilisée.</para>
</listitem>
<listitem>
<para><computeroutput>extpacks</computeroutput> affiche les packs
d'extension de VirtualBox actuellement installés ; voir <xref
linkend="intro-installing" /> et <xref
linkend="vboxmanage-extpack" /> pour plus d'informations.</para>
</listitem>
</itemizedlist></para>
</sect1>
<sect1 id="vboxmanage-showvminfo">
<title>VBoxManage showvminfo</title>
<para>La commande <computeroutput>showvminfo</computeroutput> affiche
des informations sur une machine en particulier. Ce sont les mêmes
informations qu'afficherait <computeroutput>VBoxManage list vms --long</computeroutput>
pour toutes les machines virtuelles.</para>
<para>Vous aurez des informations ressemblant à ce qui suit :</para>
<para><screen>$ VBoxManage showvminfo "Windows XP"
VirtualBox Command Line Management Interface Version $VBOX_VERSION_MAJOR.$VBOX_VERSION_MINOR.$VBOX_VERSION_BUILD
(C) 2005-$VBOX_C_YEAR $VBOX_VENDOR
All rights reserved.
Name: Windows XP
UUID: 1bf3464d-57c6-4d49-92a9-a5cc3816b7e7
Memory size: 512MB
VRAM size: 12MB
Number of CPUs: 2
Synthetic Cpu: off
Boot menu mode: message and menu
Boot Device (1): DVD
Boot Device (2): HardDisk
Boot Device (3): Not Assigned
Boot Device (4): Not Assigned
ACPI: on
IOAPIC: on
PAE: on
Time offset: 0 ms
Hardw. virt.ext: on
Nested Paging: on
VT-x VPID: off
State: powered off (since 2009-10-20T14:52:19.000000000)
Monitor count: 1
3D Acceleration: off
2D Video Acceleration: off
Teleporter Enabled: off
Teleporter Port: 0
Teleporter Address:
Teleporter Password:
Storage Controller (0): IDE Controller
Storage Controller Type (0): PIIX4
Storage Controller (1): Floppy Controller 1
Storage Controller Type (1): I82078
NIC 1: disabled
NIC 2: disabled
NIC 3: disabled
NIC 4: disabled
NIC 5: disabled
NIC 6: disabled
NIC 7: disabled
NIC 8: disabled
UART 1: disabled
UART 2: disabled
Audio: disabled (Driver: Unknown)
Clipboard Mode: Bidirectional
VRDE: disabled
USB: disabled
USB Device Filters:
<none>
Shared folders:
<none>
Statistics update: disabled</screen></para>
</sect1>
<sect1 id="vboxmanage-registervm">
<title>VBoxManage registervm / unregistervm</title>
<para>La commande <computeroutput>registervm</computeroutput> vous permet
d'importer la définition d'une machine virtuelle dans VirtualBox via
un fichier XML. La machine ne doit pas entrer en conflit avec une autre déjà
enregistrée dans VirtualBox et elle ne peut pas avoir de disques durs ou
amovibles attachés. Il est recommandé de mettre le fichier de définition
dans le répertoire des machines avant de l'enregistrer.<note>
<para>Lors de la création d'une nouvelle machine virtuelle avec
<computeroutput>VBoxManage createvm</computeroutput> (voir ci-dessous),
vous pouvez spécifier directement l'option
<computeroutput>--register</computeroutput> pour éviter de devoir
l'enregistrer séparément.</para>
</note></para>
<para>La commande <computeroutput>unregistervm</computeroutput> désenregistre
une machine virtuelle. Si vous spécifiez également
<computeroutput>--delete</computeroutput>, les fichiers suivants seront
eux aussi automatiquement effacés :<orderedlist>
<listitem>
<para>tous les fichiers images de disque dur, y compris les fichiers de
différenciation, utilisés par la machine et non partagés avec d'autres
machines ;</para>
</listitem>
<listitem>
<para>les fichiers de l'état sauvegardé créés par la machine si ils existent
(un si la machine était en état "sauvegardé" et un pour chaque
instantané en ligne) ;</para>
</listitem>
<listitem>
<para>le fichier XML de la machine et ses sauvegardes ;</para>
</listitem>
<listitem>
<para>les fichiers journaux de la machine s'il y en a ;</para>
</listitem>
<listitem>
<para>le répertoire de la machine s'il est vide après l'effacement de
tout ce qui précède.</para>
</listitem>
</orderedlist></para>
</sect1>
<sect1 id="vboxmanage-createvm">
<title>VBoxManage createvm</title>
<para>Cette commande crée un nouveau fichier de définition de machine virtuelle
XML.</para>
<para>Le paramètre <computeroutput>--name <name></computeroutput> est
requis et doit spécifier le nom de la machine. Ce nom étant utilisé par
défaut pour nommer le fichier des paramètres (avec l'extension
<computeroutput>.xml</computeroutput>) et le dossier machine (un sous-dossier
respecter les exigences de votre système d'exploitation hôte en matière de
spécifications d'un nom de fichier. Si vous renommez plus tard la VM, le
nom du fichier et du dossier seront modifiés automatiquement.</para>
<para>Néanmoins, si vous utilisez l'option <computeroutput>--basefolder
<path></computeroutput>, le dossier de la machine sera appelé
<computeroutput><path></computeroutput>. Dans ce cas, les noms du
fichier et du dossier ne seront pas modifiés si la machine virtuelle est
renommée.</para>
<para>Par défaut, cette commande ne fait que créer le fichier XML,
sans enregistrer automatiquement la VM avec votre installation de
VirtualBox. Pour enregistrer instantanément la VM, utilisez l'option
<computeroutput>--register</computeroutput>, ou lancez
<computeroutput>VBoxManage registervm</computeroutput> séparément a posteriori.</para>
</sect1>
<sect1 id="vboxmanage-modifyvm">
<title>VBoxManage modifyvm</title>
<para>Cette commande modifie les propriétés d'une machine virtuelle enregistrée
et non en fonction. La plupart des propriétés disponibles avec cette commande
correspondent aux paramètres de la VM affichés dans l'interface graphique de
VirtualBox dans la boîte de dialogue "Paramètres" de chaque VM ;
celles-ci ont été décrites en
<xref linkend="BasicConcepts" />. Néanmoins, certains des paramètres les plus
avancés ne sont disponibles que via l'interface
<computeroutput>VBoxManage</computeroutput>.</para>
<para>Ces commandes exigent que la machine soit éteinte (ni
en fonction ni en état "sauvegardé"). Certains paramètres de la machine
peuvent être aussi modifiés pendant qu'une machine est en fonction ;
ces paramètres auront alors une sous-commande correspondante avec la sous-commande
<computeroutput>VBoxManage controlvm</computeroutput> (voir <xref linkend="vboxmanage-controlvm" />).</para>
<sect2>
<title>Paramètres généraux</title>
<para>Les paramètres généraux suivants sont disponibles via
<computeroutput>VBoxManage modifyvm</computeroutput> :<itemizedlist>
<listitem>
<para><computeroutput>--name <nom></computeroutput> : Ceci
modifie le nom de la VM et renomme éventuellement les fichiers internes
virtuels, comme décrit avec <computeroutput>VBoxManage
createvm</computeroutput> ci-dessus.</para>
</listitem>
<listitem>
<para><computeroutput>--ostype <ostype></computeroutput> :
Ceci spécifie le système d'exploitation supposé fonctionner dans la
VM. Pour en apprendre davantage sur les différents identifiants
utilisables, utilisez <computeroutput>VBoxManage list
ostypes</computeroutput>.</para>
</listitem>
<listitem>
<para><computeroutput>--memory
<taillemémoire></computeroutput> : Ceci définit la quantité
de RAM, en Mo, que devrait s'affecter à elle-même la machine virtuelle
sur l'hôte. Voir les remarques au <xref linkend="gui-createvm" /> pour
plus d'informations.</para>
</listitem>
<listitem>
<para><computeroutput>--vram <taillevram></computeroutput> :
Ceci définit la quantité de RAM de la carte graphique. Voir
<xref linkend="settings-display" /> pour des détails.</para>
</listitem>
<listitem>
<para><computeroutput>--acpi on|off</computeroutput> ;
<computeroutput>--ioapic on|off</computeroutput> : Ces deux éléments
déterminent si la VM devrait supporter respectivement l'ACPI et
l'APIC I/O ; voir <xref linkend="settings-motherboard" /> pour
des détails.</para>
</listitem>
<listitem>
<para><computeroutput>--hardwareuuid
<uuid></computeroutput> : L'UUID présentée à l'invité via
et invité. Par défaut, c'est le même que l'uuid de la VM. Utile quand
vous clonez une VM. La téléportation en tient compte automatiquement.</para>
</listitem>
<listitem>
<para><computeroutput>--cpus <nombreprocesseur></computeroutput> :
Ceci définit le nombre de processeurs virtuels de la machine virtuelle
(voir <xref linkend="settings-processor" />). Si le branchement
à chaud des processaurs est activé (voir ci-dessous), ceci définit
le nombre <emphasis>maximum</emphasis> de processeurs virtuels
qu'on peut brancher dans les machines virtuelles.</para>
</listitem>
<listitem>
<para><computeroutput>--rtcuseutc on|off</computeroutput> : Cette
option fait tourner l'horloge en temps réel (RTC) en temps UTC (voir
<xref linkend="settings-motherboard" />).</para>
</listitem>
<listitem>
<para><computeroutput>--cpuhotplug on|off</computeroutput> : Ceci
active le branchement à chaud du processeur. Quand vous l'activez,
les processeurs virtuels peuvent être ajoutés et supprimés d'une
machine virtuelle pendant qu'elle est en fonction. Voir
<xref linkend="cpuhotplug" /> pour plus d'informations.</para>
</listitem>
<listitem>
<para><computeroutput>--plugcpu|unplugcpu
<id></computeroutput> : Si vous avez activé le branchement
des processeurs à chaud (voir ci-dessus), ceci ajoute un processeur
virtuel aux machines virtuelles (ou en supprime un). <computeroutput><id></computeroutput>
spécifie l'index du processeur virtuel à ajouter ou supprimer et doit
être un numéro entre 0 et le nombre maximum de processeurs configurés
avec l'option <computeroutput>--cpus</computeroutput>. Le processeur
0 ne peut jamais être supprimé.</para>
</listitem>
<listitem>
<para><computeroutput>--cpuexecutioncap
<1-100></computeroutput> : Ce paramètre contrôle le nombre
de temps processeur utilisable par un processeur. La valeur 50 implique
qu'un seul processeur virtuel peut utiliser jusqu'à 50% d'un seul
processeur de l'hôte.</para>
</listitem>
<listitem>
<para><computeroutput>--pae on|off</computeroutput> : Ceci active/désactive
la PAE (voir <xref
linkend="settings-processor" />).</para>
</listitem>
<listitem>
<para><computeroutput>--longmode on|off</computeroutput> : Ceci
active/désactive le mode long (voir <xref
linkend="settings-processor" />).</para>
</listitem>
<listitem>
<para><computeroutput>--synthcpu on|off</computeroutput> : Ce
paramètre détermine si VirtualBox présente ou non un processeur
synthétique à l'invité pour permettre une migration en direct entre
les systèmes hôtes qui diffèrent de manière significative.</para>
</listitem>
<listitem>
<para><computeroutput>--hpet on|off</computeroutput> : Ceci active/désactive
un High Precision Event Timer (HPET) qui peut remplacer les timers
du système primitif. C'est désactivé par défaut. Remarquez que Windows
ne supporte un HPET qu'à partir de Vista.</para>
</listitem>
<listitem>
<para><computeroutput>--hwvirtex on|off</computeroutput> : Ceci
active ou désactive l'utilisation des extensions du matériel de
virtualisation (Intel VT-x ou AMD-V) dans le processeur de votre système
hôte ; voir <xref linkend="hwvirt" />.</para>
</listitem>
<listitem>
<para><computeroutput>--triplefaultreset on|off</computeroutput> : ce
paramètre permet de relancer l'invité au lieu de récupérer une Guru Meditation.
Certains invités échouent par une triple erreur lors de la réinitialisation
du processeur, donc on peut parfois souhaiter ce comportement. Cela
ne fonctionne que sur les invités non SMP.</para>
</listitem>
<listitem>
<para><computeroutput>--nestedpaging on|off</computeroutput> : Si
la virtualisation matérielle est activée, ce paramètre supplémentaire
active ou désactive l'utilisation de la fonction de pagination nested
du processeur de votre système hôte ; voir <xref
linkend="hwvirt" />.</para>
</listitem>
<listitem>
<para><computeroutput>--largepages on|off</computeroutput> : Si
la virtualisation matérielle <emphasis>et</emphasis> la pagination
nested sont activées, pour Intel VT-x seulement, vous pouvez obtenir un
gain de performances jusqu'à 5% en activant ce paramètre. Il fait
utiliser à l'hyperviseur les grandes pages pour réduire l'utilisation du
TLB et l'overhead.</para>
</listitem>
<listitem>
<para><computeroutput>--vtxvpid on|off</computeroutput> : Si
la virtualisation matérielle est activée, pour Intel VT-x seulement,
ce paramètre supplémentaire active ou désactive l'utilisation de la
fonction TLB taggçe (VPID) du processeur de votre système hôte ;
voir <xref linkend="hwvirt" />.</para>
</listitem>
<listitem>
<para><computeroutput>--vtxux on|off</computeroutput> : Si vous avez
activé la virtualisation matérielle, seulement pour VT-x d'Intel, ce
paramètre active ou désactive l'utilisation de la fonction mode invité
sans restriction pour faire tourner votre invité.</para>
</listitem>
<listitem>
<para><computeroutput>--accelerate3d on|off</computeroutput> :
Ceci active, si vous avez installé les suppléments invité, la disponibilité
de l'accélération 3D ; voir <xref
linkend="guestadd-3d" />.</para>
</listitem>
<listitem>
<para>Vous pouvez influencer le logo du BIOS affiché quand une machine
virtuelle démarre avec un certain nombre de paramètres. Par défaut,
un logo VirtualBox est affiché.</para>
<para>Avec <computeroutput>--bioslogofadein
on|off</computeroutput> et <computeroutput>--bioslogofadeout
on|off</computeroutput>, vous pouvez déterminer si le logo apparaît
et disparaît éstompé, respectivement.</para>
<para>Avec <computeroutput>--bioslogodisplaytime
<msec></computeroutput> vous pouvez définir la durée d'affichage
du logo en millisecondes.</para>
<para>Avec <computeroutput>--bioslogoimagepath
<cheminimage></computeroutput> vous pouvez, si vous le souhaitez,
remplacer l'image affichée par votre propre logo. L'image doit être
un fichier BMP décompressé 256 couleurs avec des informations sur
la zone des couleurs (au format Windows 3.0). La taille de l'image
ne doit pas excéder 640 x 480.</para>
</listitem>
<listitem>
<para><computeroutput>--biosbootmenu
disabled|menuonly|messageandmenu</computeroutput> : Ceci
spécifie si le BIOS permet à l'utilisateur de sélectionner un périphérique
de démarrage temporaire. <computeroutput>menuonly</computeroutput>
supprime le message, mais l'utilisateur peut encore appuyer sur F12
pour sélectionner un périphérique de démarrage temporaire.</para>
</listitem>
<listitem>
<para><computeroutput>--nicbootprio<1-N>
<priorité></computeroutput> : Ceci spécifie l'ordre dans
lequel les NICs sont essayés pour démarrer par le réseau (en utilisant
PXE). La priorité est un entier entre 0 à 4. La priorité 1 est la
plus élevée, la priorité 4 est la plus faible. La priorité 0, qui
est celle par défaut sauf autrement spécifié, est la plus faible.
</para>
<para>Remarquez que cette option n'a d'effet que quand le démarrage
Intel PXE ROM est utilisé.
</para>
</listitem>
<listitem>
<para><computeroutput>--boot<1-4>
none|floppy|dvd|disk|net</computeroutput> : Ceci spécifie l'ordre
d'amorçage pour la machine virtuelle. Il y a quatre "slots", auxquels
essaiera d'accéder la VM de 1 à 4, et pour chacun d'eux, vous pouvez
définir un périphérique sur lequel la VM devrait essayer de démarrer.</para>
</listitem>
<listitem>
<para><computeroutput>--snapshotfolder
default|<path></computeroutput> : Ceci vous permet de
spécifier le dossier dans lequel seront stockés les instantanés d'une
machine virtuelle.</para>
</listitem>
<listitem>
<para><computeroutput>--firmware efi|bios</computeroutput> :
Spécifie le firmware utilisé pour démarrer une
machine virtuelle en particulier : EFI ou BIOS. N'utilisez EFI
que si vous comprenez bien ce que vous faites.</para>
</listitem>
<listitem>
<para><computeroutput>--guestmemoryballoon
<taille></computeroutput> définit la taille par défaut de la
mémoire du ballon de l'invité c'est-à-dire la mémoire affectée
par les suppléments invité de VirtualBox à partir du système d'exploitation
invité et rendue à l'hyperviseur pour être réutilisée par d'autres
machines virtuelles. <taille> doit être spécifiée en mégaoctets.
La taille par défaut est de 0 mégaoctets. Pour les
détails, voir <xref linkend="guestadd-balloon" />.</para>
</listitem>
<listitem>
<para><computeroutput>--lptmode<1-N>
<Périphérique></computeroutput>
Spécifie le nom du périphérique du port parallèle utilisé par la
fonction Pert parallèle. Utilisez ceci <emphasis>avant</emphasis>
<computeroutput>--lpt</computeroutput>. Cette fonction est spécifique
au système d'exploitation.</para>
</listitem>
<listitem>
<para><computeroutput>--lpt<1-N>
<base E/S> <IRQ></computeroutput> Spécifie l'adresse
E/S du port parallèle et le numéro IRQ utilisés par la fonction
Port parallèle. Utilisez ceci <emphasis>après</emphasis>
<computeroutput>--lptmod</computeroutput>. L'adresse de base
E/S et le numéro IRQ sont les valeurs vues par l'invité, c'est-à-dire
les valeurs disponibles dans le gestionnaire de périphériques de
l'invité.</para>
</listitem>
<listitem>
<para><computeroutput>--defaultfrontend
default|<nom></computeroutput> : Ceci vous permet de
spécifier l'interface par défaut qui sera utilisée au démarrage de
cette VM  voir
<xref linkend="vboxmanage-startvm" /> pour des détails.</para>
</listitem>
</itemizedlist></para>
</sect2>
<sect2>
<title>Paramètres réseaux</title>
<para>Les paramètres réseaux suivants sont disponibles avec
<computeroutput>VBoxManage modifyvm</computeroutput>. Avec tous ces paramètres,
le numéro décimal suivant directement le nom de l'option ("1-N" dans la
in liste ci-dessous) spécifie l'adaptateur réseau virtuel dont vous
modifiez les paramètres.<itemizedlist>
<listitem>
<para><computeroutput>--nic<1-N>
none|null|nat|bridged|intnet|hostonly|generic
</computeroutput> : Avec cela, vous pouvez définir, pour chacune
des cartes réseaux virtuelles de la VM, le type de réseau qui devrait
être disponible. Ils peuvent ne pas être présents
(<computeroutput>none</computeroutput>), non connectés à l'hôte
(<computeroutput>null</computeroutput>), utiliser le network
address translation (<computeroutput>nat</computeroutput>),
le réseau bridgé (<computeroutput>bridged</computeroutput>) ou
communiquer avec d'autres machines virtuelles en utilisant le réseau
interne (<computeroutput>intnet</computeroutput>), le réseau
host-only (<computeroutput>hostonly</computeroutput>), ou accéder
à des sous-modes rarement utilisés (<computeroutput>generic</computeroutput>).
Ces options correspondent aux modes décrits en détail au <xref
linkend="networkingmodes" />.</para>
</listitem>
<listitem>
<para><computeroutput>--nictype<1-N>
Am79C970A|Am79C973|82540EM|82543GC|82545EM|virtio</computeroutput> :
Cela vous permet, pour chacune des cartes réseaux virtuelles de la VM, de
spécifier le matériel réseau que VirtualBox présente à l'invité ;
voir <xref linkend="nichardware" />.</para>
</listitem>
<listitem>
<para><computeroutput>--cableconnected<1-N>
on|off</computeroutput> : Cela vous permet de déconnecter
temporairement une interface réseau virtuelle comme si vous débranchiez un
câble réseau d'une vraie carte réseau. Cela pourrait être utile pour
reparamétrer certains composants logiciels dans la VM.</para>
</listitem>
<listitem>
<para>Avec l'option "nictrace", vous pouvez éventuellement tracer
le trafic réseau en l'envoyant vers un fichier pour faire du débogage.</para>
<para>Avec <computeroutput>--nictrace<1-N>
on|off</computeroutput>, vous pouvez activer un traçage réseau pour
des cartes réseaux en particulier.</para>
<para>Si vous l'activez, vous devez spécifier avec
<computeroutput>--nictracefile<1-N>
<nomfichier></computeroutput> le fichier où devrait être
journalisée la trace.</para>
</listitem>
<listitem>
<para><computeroutput>--bridgeadapter<1-N>
none|<nompériphérique></computeroutput> : Si le réseau
bridgé est activé pour une carte réseau virtuelle (voir l'option
<computeroutput>--nic</computeroutput> ci-dessus ; sinon ce
paramètre n'a aucun effet),, utilisez cette option pour spécifier
l'interface de l'hôte qu'utilisera l'interface réseau virtuelle
donnée. Pour des détails, merci de voir <xref linkend="network_bridged" />.</para>
</listitem>
<listitem>
<para><computeroutput>--hostonlyadapter<1-N>
none|<nompériphérique></computeroutput> : Si le réseau
host-only a été activé pour une carte réseau virtuelle (voir l'option
--nic ci-dessus ; sinon ce paramètre n'a aucun effet), employez
cette option pour spécifier quelle interface réseau host-only utilisera
l'interface réseau virtuelle donnée. Pour des détails, merci de voir <xref
linkend="network_hostonly" />.</para>
</listitem>
<listitem>
<para><computeroutput>--intnet<1-N>
network</computeroutput> : Si le réseau interne a été activé
pour une carte réseau virtuelle (voir l'option
<computeroutput>--nic</computeroutput> ci-dessus ; sinon ce
paramètre n'a aucun effet), utilisez cette option pour spécifier le
nom du réseau interne (voir <xref
linkend="network_internal" />).</para>
</listitem>
<listitem>
<para><computeroutput>--macaddress<1-N>
auto|<mac></computeroutput> : Avec cette option,
vous pouvez définir l'adresse MAC de la carte réseau virtuelle.
Normalement, chaque carte réseau virtuel se voit affecter une adresse
aléatoire par VirtualBox Lors de la création de la VM.</para>
</listitem>
<listitem>
<para><computeroutput>--nicgenericdrv<1-N>
<pilote fondation></computeroutput> : Si le réseau
générique a été activé pour une carte réseau virtuelle (voir l'option
<computeroutput>--nic</computeroutput> ci-dessus ; sinon ce paramètre
n'a aucun effet), ce mode vous permet d'accéder à des sous-modes
réseaux rarement utilisés, tels que le réseau VDE ou le tunnel UDP.
</para>
</listitem>
<listitem>
<para><computeroutput>--nicproperty<1-N>
<nomparam>="paramvaleur"</computeroutput> :
Cette option, associée avec "nicgenericdrv", vous permet de
passer des paramètres aux backends (fondations) réseaux rarement utilisées.</para><para>
Ces paramètres sont des fondations spécifiques au moteur et sont
différents entre les pilotes du tunnel UDP et ceux de la fondation
VDE. Par exemple,merci de voir <xref linkend="network_udp_tunnel" />.
</para>
</listitem>
</itemizedlist></para>
<sect3>
<title>Paramètres du réseau NAT.</title>
<para>Les paramètres de réseau NAT suivants sont disponibles via
<computeroutput>VBoxManage modifyvm</computeroutput>. Avec tous ces
paramètres, le numéro décimal suivant le nom de l'option ("1-N"
dans la liste ci-dessous) spécifie l'adaptateur réseau virtuel que
devrait modifier ces paramètres.<itemizedlist>
<listitem>
<para><computeroutput>--natpf<1-N>
[<nom>],tcp|udp,[<hostip>],<porthôte>,[<ipinvité>],
<portinvité></computeroutput> : Cette option définit
une règle de redirection de port NAT (merci de voir <xref linkend="natforward" />
pour des détails).</para>
</listitem>
<listitem>
<para><computeroutput>--natpf<1-N> delete
<nom></computeroutput> : Cette option supprime une règle
de redirection de port NAT (merci de voir <xref linkend="natforward" />
pour les détails).</para>
</listitem>
<listitem>
<para><computeroutput>--nattftpprefix<1-N>
<préfixe></computeroutput> : Cette option définit un
préfixe pour le serveur TFTP intégré, à savoir là où se trouve le
fichier de démarrage (merci de voir <xref linkend="nat-tftp" /> et <xref
linkend="nat-adv-tftp" /> pour les détails).</para>
</listitem>
<listitem>
<para><computeroutput>--nattftpfile<1-N>
<fichierdémarrage></computeroutput> : Cette option
définit le fichier de démarrage TFT (merci de voir <xref linkend="nat-adv-tftp" />
pour des détails).</para>
</listitem>
<listitem>
<para><computeroutput>--nattftpserver<1-N>
<serveurtftp></computeroutput> : Cette option définit
l'adresse du serveur TFTP sur lequel démarrer (voir <xref
linkend="nat-adv-tftp" /> pour les détails).</para>
</listitem>
<listitem>
<para><computeroutput>--natdnspassdomain<1-N>
on|off</computeroutput> : Cette option spécifie si le serveur
DHCP passe le nom de domaine pour la résolution du nom du réseau.</para>
</listitem>
<listitem>
<para><computeroutput>--natdnsproxy<1-N>
on|off</computeroutput> : Cette option fait que le proxy du
moteur NAT envoie toutes les requêtes DNS de l'invité au serveur DNS
de l'hôte (merci de voir <xref linkend="nat-adv-dns" /> pour des
détails).</para>
</listitem>
<listitem>
<para><computeroutput>--natdnshostresolver<1-N>
on|off</computeroutput> : Cette option fait que le
moteur NAT utilise le mécanismes de résolveur de l'hôte pour gérer les
requêtes DNS (merci de voir <xref linkend="nat-adv-dns" /> pour les détails).</para>
</listitem>
<listitem>
<para><computeroutput>--natsettings<1-N>
[<mtu>],[<socksnd>],[<sockrcv>],[<tcpsnd>],
[<tcprcv>]</computeroutput> : Cette option contrôle
plusieurs paramètres NAT (merci de voir <xref linkend="nat-adv-settings" />
pour les détails).</para>
</listitem>
<listitem>
<para><computeroutput>--nataliasmode<1-N>
default|[log],[proxyonly],[sameports]</computeroutput> : Cette
option définit le comportement du cœur du moteur NAT :
log - active la journalisation, proxyonly - switch les modes d'alias
pour rendre NAT transparent, sameports renforce le moteur NAT pour
envoyer des paquets via le même port qu'ils arrivent, default -
désactive tous les modes mentionnés ci-dessus. (merci de voir <xref
linkend="nat-adv-alias" /> pour des détails).</para>
</listitem>
</itemizedlist></para>
</sect3>
</sect2>
<sect2 id="vboxmanage-modifyvm-other">
<title>Paramètres divers</title>
<para>Les autres paramètres matériels suivants (tels que ceux du port série,
du son, du presse-papiers, du glisser/déplacer, de l'écran et de l'USB)
sont disponibles avec
<computeroutput>VBoxManage modifyvm</computeroutput> :<itemizedlist>
<listitem>
<para><computeroutput>--uart<1-N> off|<I/O base>
<IRQ></computeroutput> : Avec cette option, vous pouvez
configurer les ports série virtuels de la VM (voir <xref
linkend="serialports" /> pour une introduction.</para>
</listitem>
<listitem>
<para><computeroutput>--uartmode<1-N>
<arg></computeroutput> : Ce paramètre contrôle la façon
dont VirtualBox se connecte à un port série virtuel donné (on la
configurait jadis avec l'option
<computeroutput>--uartX</computeroutput>, voir ci-dessus) sur l'hôte
sur lequel fonctionne la machine virtuelle. Comme décrit en détail
au <xref linkend="serialports" />, pour chaque port, vous pouvez
spécifier <computeroutput><arg></computeroutput> comme une des
options suivantes :<itemizedlist>
<listitem>
<para><computeroutput>disconnected</computeroutput> : Même
si le port série apparaît dans l'invité, il ne sert à rien --
comme un vrai port COM sans câble.</para>
</listitem>
<listitem>
<para><computeroutput>server
<pipename></computeroutput> : Sur un hôte Windows,
ceci dit à VirtualBox de créer un tuyau nommé sur l'hôte,
appelé <computeroutput><pipename></computeroutput> et de
connecter le port série virtuel dessus. Remarquez que Windows
exige que le nom d'un tuyau nommé commence par
<computeroutput>\\.\pipe\</computeroutput>.</para>
<para>Sur un hôte Linux, plutôt qu'un tuyau nommé, une
socket de domaine local est utilisée.</para>
</listitem>
<listitem>
<para><computeroutput>client
<pipename></computeroutput> : Ceci agit comme
<computeroutput>server ...</computeroutput>, sauf que le tuyau
(ou la socket de domaine local) n'est pas créée par VirtualBox,
mais est supposée déjà exister.</para>
</listitem>
<listitem>
<para><computeroutput><devicename></computeroutput> :
Si, au lieu de celui ci-dessus, le nom du périphérique du port
série matériel de l'hôte est spécifié, le port série virtuel est
connecté à ce port matériel. Sur un hôte Windows, le nom du
périphérique sera un port COM tel que
<computeroutput>COM1</computeroutput> ; sur un hôte Linux,
le nom du périphérique ressemblera à
de "brancher" un vrai port série à une machine virtuelle.</para>
</listitem>
</itemizedlist></para>
</listitem>
<listitem>
<para><computeroutput>--audio none|null|oss</computeroutput> :
Avec cette option, vous pouvez définir si la VM supporte le son.</para>
</listitem>
<listitem>
<para><computeroutput>--clipboard
disabled|hosttoguest|guesttohost|bidirectional</computeroutput> :
Avec ce paramètre, vous pouvez sélectionner si le presse-papier du
système d'exploitation invité ou de l'hôte doit être partagé avec
l'hôte ou l'invité et comment ; voir
<xref linkend="generalsettings" />. Cela exige que les suppléments
invité soient installés dans la machine virtuelle.</para>
</listitem>
<listitem>
<para><computeroutput>--draganddrop
disabled|hosttoguest|guesttohost|bidirectional</computeroutput> :
Avec ce paramètre, vous pouvez sélectionner le mode actuel de
glisser/déplacer à utiliser entre l'hôte et la machine virtuelle ;
voir <xref linkend="guestadd-dnd" />. Cela exige que les suppléments
invité soient installés dans la machine virtuelle.</para>
</listitem>
<listitem>
<para><computeroutput>--monitorcount
<nombre></computeroutput> : Cela active le support multi-moniteurs ;
voir <xref linkend="settings-display" />.</para>
</listitem>
<listitem>
<para><computeroutput>--usb on|off</computeroutput> : Cette
option active ou désactive le contrôleur virtuel USB de la VM ; voir
<xref linkend="settings-usb" /> pour les détails.</para>
</listitem>
<listitem>
<para><computeroutput>--usbehci on|off</computeroutput> : Cette
option active ou désactive le contrôleur USB 2.0 virtuel de la VM ;
voir <xref linkend="settings-usb" /> pour des détails.</para>
</listitem>
</itemizedlist></para>
</sect2>
<sect2 id="vboxmanage-modifyvm-vrde">
<title>Paramètres de la machine distante</title>
<para>Les paramètres suivants concernant le comportement de la machine
distante sont disponibles avec <computeroutput>VBoxManage
modifyvm</computeroutput> :<itemizedlist>
<listitem>
<para><computeroutput>--vrde on|off</computeroutput> : Avec
l'interface graphique de VirtualBox, ceci active ou désactive le serveur
VirtualBox remote desktop extension (VRDE). Remarquez que si vous
utilisez <computeroutput>VBoxHeadless</computeroutput> (voir
<xref linkend="vboxheadless" />), VRDE est activé par défaut.</para>
</listitem>
<listitem>
<para><computeroutput>--vrdeport
default|<ports></computeroutput> : Un port ou une plage
de ports que le serveur VRDE peut sonder ; "default" ou "0"
signifient le port 3389, le port RDP standard. Vous pouvez spécifier
une liste de ports ou de plages de ports séparée par des virgules.
Utilisez un tiret entre deux numéros de ports pour spécifier une plage.
Le serveur VRDE sondera <emphasis role="bold">un</emphasis> des
ports disponibles dans la liste spécifiée. Une seule machine peut utiliser
un port donné en même temps. Par exemple, l'option <computeroutput> --vrdeport
5000,5010-5012</computeroutput> dira au serveur de sonder un des ports
suivants : 5000, 5010, 5011 ou 5012.</para>
</listitem>
<listitem>
<para><computeroutput>--vrdeaddress <adresse IP
></computeroutput> : L'adresse IP de l'interface réseau de
l'hôte que sondera le serveur VRDE. Si vous la spécifiez, le serveur
n'acceptra les connexions que sur l'interface de l'hôte spécifiée.</para>
<para>On peut utiliser ce paramètre pour indiquer si le serveur
VRDP devrait accepter des connexions IPv4, IPv6 ou les deux :
<itemizedlist>
<listitem>
<para>IPv4 seulement : <computeroutput>--vrdeaddress "0.0.0.0"
</computeroutput></para>
</listitem>
<listitem>
<para>IPv6 seulement : <computeroutput>--vrdeaddress "::"
</computeroutput></para>
</listitem>
<listitem>
<para>IPv6 et IPv4 (par défaut) : <computeroutput>--vrdeaddress ""
</computeroutput></para>
</listitem>
</itemizedlist></para>
</listitem>
<listitem>
<para><computeroutput>--vrdeauthtype
null|external|guest</computeroutput> : Cela vous permet de choisir
s'il faut une autorisation et sous quelle forme ; voir <xref
linkend="vbox-auth" /> pour des détails.</para>
</listitem>
<listitem>
<para><computeroutput>--vrdemulticon on|off</computeroutput> : Ceci
active la multiconnexions au même serveur VRDE si le serveur supporte
cette fonction ; voir <xref lang=""
linkend="vrde-multiconnection" />.</para>
</listitem>
<listitem>
<para><computeroutput>--vrdereusecon on|off</computeroutput> : Ceci
spécifie le comportement du serveur VRDE quand plusieurs connexions
sont désactivées. Quand on active cette option, le serveur autorisera
un nouveau client à se connecter et il fermera la connexion existante.
Quand cette option est désactivée (c'est le réglage par défaut), une
nouvelle connexion ne sera pas acceptée si un client est déjà connecté
au serveur.</para>
</listitem>
<listitem>
<para><computeroutput>--vrdevideochannel on|off</computeroutput> :
Ceci active la redirection graphique, si elle est supportée par le
serveur VRDE ; voir <xref lang="" linkend="vrde-videochannel" />.</para>
</listitem>
<listitem>
<para><computeroutput>--vrdevideochannelquality
<pourcent></computeroutput> : Définit la qualité de l'image
dans la redirection graphique ; voir <xref lang=""
linkend="vrde-videochannel" />.</para>
</listitem>
</itemizedlist></para>
</sect2>
<sect2 id="vboxmanage-modifyvm-teleport">
<title>Paramètres de téléportation</title>
<para>Avec les commandes suivantes pour <computeroutput>VBoxManage
modifyvm</computeroutput>, vous pouvez configurer une machine pour qu'elle
soit une cible de téléportation. Voir <xref linkend="teleporting" /> pour
une introduction détaillée.<itemizedlist>
<listitem>
<para><computeroutput>--teleporter on|off</computeroutput> : Avec
ce paramètre, vous activez ou désactivez l'attente par une machine
d'une requête de téléportation venant du réseau lorsqu'elle est
démarrée. Si elle est activée, quand on démarre la machine, cela ne
démarre pas la machine virtuelle comme cela est normalement le cas,
mais cela attend qu'une requête de téléportation arrive à l'adresse
listée avec les deux options suivantes.</para>
</listitem>
<listitem>
<para><computeroutput>--teleporterport
<port></computeroutput>, <computeroutput>--teleporteraddress
<adresse></computeroutput> : il faut les utiliser avec
--teleporter et elle dit à une machine virtuelle le port et l'adresse
sur lesquelles elle doit écouter les demandes de téléportation d'une
autre machine virtuelle. <computeroutput><port></computeroutput>
<computeroutput><adresse></computeroutput> peut être n'importe
à sonder. Par défaut, c'est "0.0.0.0", ce qui signifie toutes les
adresses.</para>
</listitem>
<listitem>
<para><computeroutput>--teleporterpassword
<mot_de_passe></computeroutput> : si vous donnez cet
argument facultatif, la requête de téléportation ne réussira que si
la machine source spécifie le même mot de passe que celui donné avec
cette commande.</para>
</listitem>
<listitem>
<para><computeroutput>--teleporterfichier_mot_de_passe
<mot_de_passe></computeroutput> : si vous donnez cet
argument facultatif, la requête de téléportation ne réussira que si
la machine source spécifie le même mot de passe que celui spécifié
dans le fichier donné avec cette commande. Utilisez
<computeroutput>stdin</computeroutput> pour lire le mot de passe à
partir de l'entrée standard.</para>
</listitem>
<listitem>
<para><computeroutput>--cpuid <leaf> <eax> <ebx>
<ecx> <edx></computeroutput> : Les utilisateurs
avancés peuvent utiliser cette commande avant une opération de
téléportation pour restreindre les possibilités du processeur virtuel
présenté par VirtualBox au système d'exploitation invité. Il faut
l'exécuter à la fois sur la machine source et cible
impliquées dans la téléportation et cela modifiera ce que l'invité
verra quand il exécutera l'instruction machine
<computeroutput>CPUID</computeroutput>. Cela peut aider des applications
présupposant à tord la présence de
certaines capacités du processeur. La signification des paramètres
dépend du matériel ; merci de vous reporter aux manuels des
processeurs AMD ou Intel.</para>
</listitem>
</itemizedlist></para>
</sect2>
</sect1>
<sect1 id="vboxmanage-clonevm">
<title>VBoxManage clonevm</title>
<para>Cette commande crée une copie complète ou liée d'une
machine virtuelle existante.</para>
<para>La sous-commande <computeroutput>clonevm</computeroutput> prend
au moins en argument le nom de la machine virtuelle à cloner. Vous pouvez
utiliser les paramètres supplémentaires suivants pour configurer davantage
la procédure de clonage de la VM :</para>
<itemizedlist>
<listitem>
<para><computeroutput>--snapshot <uuid>|<nom></computeroutput> :
Sélectionne un instantané spécifique auquel se rapporte le processus
de clonage. Par défaut, c'est à l'état courant qu'il se réfère.</para>
</listitem>
<listitem>
<para><computeroutput>--mode machine|machineandchildren|all</computeroutput> :
Sélectionne le mode de clonage. Si
<computeroutput>machine</computeroutput> est sélectionnée (comme par
défaut), l'état actuel de la VM sans instantané est cloné. En mode
<computeroutput>machineandchildren</computeroutput>, l'instantané
fourni par <computeroutput>--snapshot</computeroutput> et tous les
instantanés fils sont clonés. Si vous
sélectionnez le mode <computeroutput>all</computeroutput>, tous les
instantanés de l'état actuel seront clonés.
</para>
</listitem>
<listitem>
<para><computeroutput>--options link|keepallmacs|keepnatmacs|keepdisknames</computeroutput> :
Permet de peaufiner encore davantage l'opération de clonage.
La première dit de créer un clone lié, ce qui n'est possible que pour
le clonage d'une machine à partir d'un instantané. Les deux options
suivantes permettent de définir la façon dont les adresses MAC de chaque
carte réseau virtuel seront gérées. Elles peuvent être soit réinitialisées
(comme par défaut), soit inchangées
(<computeroutput>keepallmacs</computeroutput>), soit inchangées
quand le type de réseau est NAT
(<computeroutput>keepnatmacs</computeroutput>). Si vous ajoutez
<computeroutput>keepdisknames</computeroutput>, toutes les nouvelles
images de disque dur s'appellent comme celles d'origine, sinon elles
sont renommées.</para>
</listitem>
<listitem>
<para><computeroutput>--name <name></computeroutput> :
Sélectionne un nouveau nom pour la nouvelle machine virtuelle. Par défaut,
il s'agit de "Nom d'origine Clone".</para>
</listitem>
<listitem>
<para><computeroutput>--basefolder <basefolder></computeroutput> :
Sélectionne le dossier où devrait être sauvegardée la configuration.</para>
</listitem>
<listitem>
<para><computeroutput>--uuid <uuid></computeroutput> :
Sélectionne l'UUID de la nouvelle VM. Cette id doit être unique dans
l'instance de VirtualBox où ce clone doit être enregistré. Par défaut,
un nouvel UUID est créé.</para>
</listitem>
<listitem>
<para><computeroutput>--register</computeroutput> :
Enregistre automatiquement le nouveau clone dans l'installation de
VirtualBox. Si vous voulez enregistrer la nouvelle VM plus tard à la
main, voir <xref linkend="vboxmanage-registervm" /> pour les
instructions pour faire cela.</para>
</listitem>
</itemizedlist>
</sect1>
<sect1 id="vboxmanage-import">
<title>VBoxManage import</title>
<para>Cette commande importe un applicatif virtuel au format OVF en copiant
les images de disque virtuelles et en créant les machines virtuelles dans
VirtualBox. Voir
<xref linkend="ovf" /> pour une présentation des applicatifs.</para>
<para>La commande <computeroutput>import</computeroutput> prend comme
argument au moins le chemin d'un fichier OVF en entrée et elle attend que les
images de disque, s'il en faut, soient dans le même répertoire que le fichier
OVF. Beaucoup d'autres options en ligne de commande sont supportées pour
contrôler en détails ce qui est importé et pour modifier les paramètres
d'importation, mais les détails dépendent du contenu du fichier OVF.</para>
<para>Il est donc recommandé de lancer d'abord la sous-commande import avec
l'option <computeroutput>--dry-run</computeroutput> ou
<computeroutput>-n</computeroutput>. Cela affichera alors à l'écran le contenu
d'un applicatif et la façon de l'importer dans VirtualBox, ainsi que
les options facultatives en ligne de commandes pour influencer le comportement
de l'importation.</para>
<para>Par exemple, voilà l'écran qui s'afficherait pour un applicatif modèle
contenant un invité Windows XP :<screen>VBoxManage import WindowsXp.ovf --dry-run
Interpreting WindowsXp.ovf...
OK.
Virtual system 0:
0: Suggested OS type: "WindowsXP"
(change with "--vsys 0 --ostype <type>"; use "list ostypes" to list all)
1: Suggested VM name "Windows XP Professional_1"
(change with "--vsys 0 --nomvm <name>")
3: Number of CPUs: 1
(change with "--vsys 0 --cpus <n>")
4: Guest memory: 956 MB (change with "--vsys 0 --memory <MB>")
5: Sound card (appliance expects "ensoniq1371", can change on import)
(disable with "--vsys 0 --unit 5 --ignore")
6: USB controller
(disable with "--vsys 0 --unit 6 --ignore")
7: Network adapter: orig bridged, config 2, extra type=bridged
8: Floppy
(disable with "--vsys 0 --unit 8 --ignore")
9: SCSI controller, type BusLogic
(change with "--vsys 0 --unit 9 --scsitype {BusLogic|LsiLogic}";
disable with "--vsys 0 --unit 9 --ignore")
10: IDE controller, type PIIX4
(disable with "--vsys 0 --unit 10 --ignore")
11: Hard disk image: source image=WindowsXp.vmdk,
(change controller with "--vsys 0 --unit 11 --controller <id>";
disable with "--vsys 0 --unit 11 --ignore")</screen></para>
<para>Comme vous pouvez le voir, les éléments de configuration individuelle
sont numérotés et en fonction de leur type de support, les options en ligne
de commande. La sous-commande import peut être redirigée pour ignorer
de nombreux éléments tels que ceux avec des options
<computeroutput>--vsys X --unit Y --ignore</computeroutput>, où
X est le numéro du système virtuel (zéro sauf s'il y a plusieurs
descriptions de système virtuel dans l'applicatif) et Y le numéro de l'élément,
tel qu'affiché à l'écran.</para>
<para>Dans l'exemple ci-dessus, Item #1 spécifie le nom de la
machine cible dans VirtualBox. Items #9 et #10 spécifient respectivement les
contrôleurs de disque. Item #11 décrit une image de disque dur ; dans ce
cas, l'option supplémentaire <computeroutput>--controller</computeroutput>
indique l'élément auquel devrait être connectée l'image de disque, avec le
fichier OVF d'origine par défaut.</para>
<para>Vous pouvez associer plusieurs éléments pour un même système virtuel
derrière une même option <computeroutput>--vsys</computeroutput>. Par exemple,
pour importer une machine comme décrit dans l'OVF mais sans la carte son
ni le contrôleur USB, mais avec l'image de disque connectée au contrôleur IDE
au lieu du contrôleur SCSI, utilisez ceci :<screen>VBoxManage import WindowsXp.ovf
--vsys 0 --unit 5 --ignore --unit 6 --ignore --unit 11 --controller 10</screen></para>
</sect1>
<sect1 id="vboxmanage-export">
<title>VBoxManage export</title>
<para>Cette commande exporte une ou plusieurs machines virtuelles à partir
de VirtualBox vers un applicatif virtuel au format OVF, ce qui inclut la
copie de leurs images de disque virtuel en VMDK compressé. Voir <xref linkend="ovf" />
pour une présentation des applicatifs.</para>
<para>La commande <computeroutput>export</computeroutput> est simple à
utiliser : affichez la machine (ou les machines) que vous voulez
exporter dans un même fichier OVF et spécifiez le fichier OVF cible après
l'option facultative <computeroutput>--output</computeroutput> ou
<computeroutput>-o</computeroutput>. Remarquez que le répertoire du fichier
cible OVF recevra également les images de disques exportés au format VNDK
compressé (quel que soit le format d'origine) et vous devriez leur laisser
assez d'espace disque.</para>
<para>Derrière une simple exportation d'une machine virtuelle donnée, vous
pouvez ajouter diverses informations produit dans le fichier applicatif.
Utilisez <computeroutput>--product</computeroutput>,
<computeroutput>--producturl</computeroutput>,
<computeroutput>--vendor</computeroutput>,
<computeroutput>--vendorurl</computeroutput> et
<computeroutput>--version</computeroutput> pokr spécifier les
informations supplémentaires. Pour des raisons légales, vous pouvez ajouter
un texte de licence ou le contenu d'un fichier de licence en utilisant
respectivement les options <computeroutput>--eula</computeroutput> et
<computeroutput>--eulafile</computeroutput>. Comme avec l'importation
OVF, vous devez utiliser l'option <computeroutput>--vsys X</computeroutput>
pour adresser les options précitées à la bonne
machine virtuelle.</para>
<para>Pour les produits de virtualisation non pleinement compatibles avec
le standard OVF 1.0, vous pouvez activer un mode OVF 0.9 basique avec
l'option <computeroutput>--legacy09</computeroutput>.</para>
<para>Pour spécifier des options contrôlant le contenu exact du fichier
d'applicatif, vous pouvez utiliser <computeroutput>--option</computeroutput>
pour demander la création d'un fichier manifeste (on vous y encourage, cela
permet la détection d'applicatifs corrompus lors de l'importation), l'export
d'images de DVD supplémentaires, et l'inclusion des adresses MAC. Vous pouvez
spécifier une liste d'options comme <computeroutput>--option manifest,nomacs</computeroutput>. Pour des détails,
consultez la sortie de l'aide de
<computeroutput>--option manifest,nomacs</computeroutput>. For details, + check the help output of <computeroutput>VBoxManage export</computeroutput>.</para>
</sect1>
<sect1 id="vboxmanage-startvm">
<title>VBoxManage startvm</title>
<para>Cette commande démarre une machine virtuelle qui est en état "Éteinte"
ou "Sauvegardée".</para>
<para>Le paramètre facultatif <computeroutput>--type</computeroutput>
détermine si la machine sera démarrée dans une fenêtre ou si la sortie devrait passer par
<computeroutput>VBoxHeadless</computeroutput>, en activant ou pas VRDE ;
voir <xref linkend="vboxheadless" /> pour plus d'informations. La liste
des types peut changer et il n'est pas garanti que tous les types soient
acceptés par la variante d'un produit.</para>
<para>La valeur par défaut, globale ou individuelle à une VM, du type
d'interface d'une VM sera utilisée si vous ne spécifiez pas explicitement
le type. Si aucune n'est définie, c'est la variante GUI qui sera démarrée.</para>
<para>Les valeurs suivantes sont autorisées :</para>
<glosslist>
<glossentry>
<glossterm><computeroutput>gui</computeroutput></glossterm>
<glossdef>
<para>Démarre une VM en affichant une fenêtre graphique. C'est le cas
par défaut.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>headless</computeroutput></glossterm>
<glossdef>
<para>Démarre une VM sans fenêtre pour un affichage distant.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>sdl</computeroutput></glossterm>
<glossdef>
<para>Démarre une VM avec une GUI minimale et limitée dans ses
fonctionnalités.</para>
</glossdef>
</glossentry>
</glosslist>
<note>
<para>Si vous rencontrez des problèmes en démarrant des machines virtuelles
avec certaines interfaces et s'il n'y a pas d'informations d'erreur
convaincantes, essayez de démarrer les machines virtuelles en lançant
directement leur interface respective, car cela peut donner des informations
supplémentaires sur l'erreur.</para>
</note>
</sect1>
<sect1 id="vboxmanage-controlvm">
<title>VBoxManage controlvm</title>
<para>La sous-commande <computeroutput>controlvm</computeroutput> vous permet
de modifier l'état d'une machine virtuelle en fonction. Vous pouvez spécifier
ce qui suit :</para>
<para><itemizedlist>
<listitem>
<para><computeroutput>VBoxManage controlvm <vm>
pause</computeroutput> met temporairement une machine virtuelle en
attente, sans vraiment changer son état. La fenêtre de la VM sera grisée
pour indiquer que la VM est actuellement en pause. (Cela revient à
sélectionner l'élément "Pause" dans le menu "Machine" de l'interface
graphique.)</para>
</listitem>
<listitem>
<para>Utilisez <computeroutput>VBoxManage controlvm <vm>
resume</computeroutput> pour inverser une commande
<computeroutput>pause</computeroutput> précédente. (Cela revient à
sélectionner l'élément "Reprendre" du menu "Machine" de l'interface
graphique.)</para>
</listitem>
<listitem>
<para><computeroutput>VBoxManage controlvm <vm>
reset</computeroutput> a le même effet sur une machine virtuelle que
l'appui sur le bouton "Reset" d'un vrai ordinateur : un redémarrage
à froid de la machine virtuelle, ce qui redémarrera le système d'exploitation
invité immédiatement. L'état de la VM n'est pas sauvegardé et des
données peuvent être perdues. (Cela revient à sélectionner l'élément
"Réinitialiser" du menu "Machine" de l'interface graphique.)</para>
</listitem>
<listitem>
<para><computeroutput>VBoxManage controlvm <vm>
poweroff</computeroutput> a le même effet sur une machine virtuelle que
de débrancher le câble d'alimentation d'un vrai ordinateur. Là encore,
l'état de la VM n'est pas sauvegardé et il se peut que des données soient
perdues. (Cela revient à sélectionner l'élément "Couper" de l'interface
graphique ou à appuyer sur le bouton Fermer de la fenêtre puis
sélectionner "Couper la machine" dans la boîte de dialogue.)</para>
<para>Après cela, l'état de la VM sera "éteint". À partir de là, vous
pouvez la relancer ; voir <xref
linkend="vboxmanage-startvm" />.</para>
</listitem>
<listitem>
<para><computeroutput>VBoxManage controlvm <vm>
savestate</computeroutput> sauvegardera l'état actuel de la VM sur le
disque et arrêtera la VM. (Cela revient à sélectionner l'élément
"Fermer" du menu "Machine" de l'interface graphique ou à appuyer sur
le bouton fermer de la fenêtre et sélectionner "Sauvegarder l'état de
la machine" dans la boîte de dialogue.)</para>
<para>Après cela, l'état de la machine sera "Sauvegardé". À partir de
là, vous pouvez la relancer ; voir
<xref linkend="vboxmanage-startvm" />.</para>
</listitem>
<listitem>
<para><computeroutput>VBoxManage controlvm <vm> teleport
--hostname <nom> --port <port> [--passwordfile
<fichier> | --password <mot_de_passe>]</computeroutput>
passe la machine en source de téléportation et engage une téléportation
sur la cible donnée. Voir <xref linkend="teleporting" /> pour une
présentation. Si vous spécifiez le mot de passe facultatif, il doit
correspondre à celui donné avec la commande
<computeroutput>modifyvm</computeroutput> pour la
machine cible ; voir <xref linkend="vboxmanage-modifyvm-teleport" />
pour des détails.</para>
</listitem>
</itemizedlist></para>
<para>Quelques options supplémentaires sont disponibles avec
<computeroutput>controlvm</computeroutput>, ne modifiant pas directement
l'état de la VM en fonction :</para>
<itemizedlist>
<listitem>
<para>L'opération <computeroutput>setlinkstate<1-N></computeroutput>
connecte ou déconnecte les câbles réseaux virtuels à leurs interfaces
réseaux.</para>
</listitem>
<listitem>
<para><computeroutput>nic<1-N>
null|nat|bridged|intnet|hostonly|generic</computeroutput> : Avec
ceci, vous pouvez définir, pour chaque carte réseau virtuelle de la VM,
le type de réseau qui devrait être disponible. Elles peuvent ne pas être
connectées à l'hôte
(<computeroutput>null</computeroutput>), utiliser network address
translation (<computeroutput>nat</computeroutput>), le résaeau bridgé
(<computeroutput>bridged</computeroutput>) ou communiquer avec d'autres
machines virtuelles en utilisant le réseau interne
(<computeroutput>intnet</computeroutput>) ou host-only
(<computeroutput>hostonly</computeroutput>) ou accéder à des sous-modes
rarement utilisés
(<computeroutput>generic</computeroutput>). Ces options correspondent
aux modes décrits en détails au <xref
linkend="networkingmodes" />.</para>
</listitem>
<listitem>
<para>L'opération <computeroutput>guestmemoryballoon</computeroutput>
change la taille du ballon mémoire de l'invité, c'est-à-dire la mémoire
du système d'exploitation invité affectée par les suppléments invité de VirtualBox
et rendue à l'hyperviseur pour être réutilisée par d'autres
machines virtuelles. Elle se spécifie en mégaoctets. Pour des détails,
voir <xref linkend="guestadd-balloon" />.</para>
</listitem>
<listitem>
<para><computeroutput>usbattach</computeroutput> et
<computeroutput>usbdettach</computeroutput> rendent les pçriphériques
USB de l'hôte, à la volée, visibles pour la machine virtuelle sans besoin de
créer des filtres préalablement. Les périphériques USB peuvent être désignés
par leur UUID (identifiant unique) ou leur adresse sur le système hôte.</para>
<para>Vous pouvez utiliser <computeroutput>VBoxManage list
usbhost</computeroutput> pour trouver ces informations.</para>
</listitem>
<listitem>
<para><computeroutput>clipboard
disabled|hosttoguest|guesttohost|bidirectional</computeroutput> :
Avec ce paramètre, vous pouvez sélectionner si le presse-papiers du
système d'exploitation de l'hôte ou de l'invité doit être partagé avec
l'hôte et l'invfté et comment ; voir <xref linkend="generalsettings" />. Ceci
exige que les suppléments invité soient installés dans la machine
virtuelle.</para>
</listitem>
<listitem>
<para><computeroutput>draganddrop
disabled|hosttoguest|guesttohost|bidirectional</computeroutput> :
Avec ce paramètre, vous pouvez sélectionner le mode glisser/déplacer
actuel qui sera utilisé entre l'hôte et la machine virtuelle ;
voir <xref linkend="guestadd-dnd" />. Cela exige que les suppléments
invité soient installés dans la machine
virtuelle.</para>
</listitem>
<listitem>
<para><computeroutput>vrde on|off</computeroutput> vous permet d'activer
ou de désactiver le serveur VRDP s'il est installé.</para>
</listitem>
<listitem>
<para><computeroutput>vrdeport default|<ports></computeroutput>
modifie le port ou la plage de ports que peut sonder le serveur
VRDP ; "default" ou "0" signifient le port 3389, celui standard
pour RDP. Pour des détails, voir la description de l'option
<computeroutput>--vrdeport</computeroutput> au <xref
linkend="vboxmanage-modifyvm-other" />.</para>
</listitem>
<listitem>
<para><computeroutput>setvideomodehint</computeroutput> demande
que le système invité passe dans un mode graphique particulier. Cela exige
l'installation des suppléments invité et ne fonctionnera pas pour tous
les systèmes invités.</para>
</listitem>
<listitem>
<para><computeroutput>screenshotpng</computeroutput> prend une impression
écran de l'affichage invité et la sauvegarde au format PNG.</para>
</listitem>
<listitem>
<para>L'opération <computeroutput>setcredentials</computeroutput> est
utilisé pour les identifications distantes dans les invités Windows.
Pour des détails, merci de vous reporter au
<xref linkend="autologon" />.</para>
</listitem>
<listitem>
<para><computeroutput>--plugcpu|unplugcpu
<id></computeroutput> : Si vous avez activé le montage à chaud de
processeurs, ceci ajoutera un processeur virtuel aux machines virtuelles
(ou en supprimera un).
<computeroutput><id></computeroutput> spécifie l'index du processeur
virtuel à ajouter ou à supprimer et il doit être un numéro de 0
au numéro maximum du nombre de processeurs configuré.</para>
</listitem>
<listitem>
<para><computeroutput>cpuexecutioncap
<1-100></computeroutput> : Cette opération contrôle la
quantité de temps processeur que peut utiliser un processeur virtuel.
Une valeur de 50 implique qu'un seul processeur virtuel peut utiliser
jusqu'à 50% d'un seul processeur de l'hôte.</para>
</listitem>
</itemizedlist>
</sect1>
<sect1>
<title>VBoxManage discardstate</title>
<para>Cette commande désactive l'état sauvegardé d'une machine virtuelle
qui n'est pas en fonction, ce qui fera redémarrer son système d'exploitation
la prochaine fois que vous démarrerez. Cela revient à débrancher le câble
d'alimentation d'une machine physique et vous devriez l'éviter si possible.</para>
</sect1>
<sect1>
<title>VBoxManage adoptstate</title>
<para>Si vous avez un fichier d'état sauvegardé
(<computeroutput>.sav</computeroutput>), c'est-à-dire séparé de la configuration
de la VM, vous pouvez "adopter" le fichier. Cela passera la VM en état
sauvegardé et quand vous la démarrerez, VirtualBox essaiera de la restaurer
à partir du fichier d'état sauvegardé que vous avez indiqué. Cette commande
ne devrait être utilisée que dans des configurations spéciales.</para>
</sect1>
<sect1>
<title>VBoxManage snapshot</title>
<para>Cette commande est utilisée pour contrôler les instantanés en ligne de
commande. Un instantané consiste en une copie complète des paramètres de la
machine virtuelle, copiés à un moment où l'instantané a été pris, et éventuellement
un fichier d'état sauvegardé de la machine virtuelle si l'instantané a été
pris alors que la machine était en fonction. Après qu'un instantané ait été pris,
VirtualBox crée un disque dur de différenciation pour chaque disque dur normal
associé à la machine pour que, quand on restaure un instantané, les disques durs
virtuels de la machine virtuelle puissent être rapidement réinitialisés en
disqualifiant simplement les fichiers de différenciation.</para>
<para>L'opération <computeroutput>take</computeroutput> prend un instantané de
l'état actuel de la machne viruelle. Vous devez fournir un nom pour l'instantané
et vous pouvez éventuellement entrer une description. Le nouvel instantané est
inséré à l'arborescence des instantanés comme un fichier de l'instantané
actuel et il devient le nouvel instantané actuel. Le paramètre
<computeroutput>--description</computeroutput> permet de décrire
l'instantané. Si vous spécifiez <computeroutput>--live</computeroutput>,
la VM ne s'arrêtera pas pendant la création de l'instantané.</para>
<para>L'opération <computeroutput>delete</computeroutput> efface un
instantané (spécifié par son nom ou son UUID). Cela peut être long à se
terminer car les images de différenciation associées à l'instantané pourraient
devoir être synchronisées avec leurs images de différenciation filles.</para>
<para>L'opération <computeroutput>restore</computeroutput> restaurera l'instantané
donné (spécifié par son nom ou son UUID) en réinitialisant les paramètres
de la machine virtuelle et l'état actuel à ceux de l'instantané. L'état
actuel précédent de la machine sera perdu. Après cela, l'instantané donné
devient le nouvel instantané "actuel" pour que les instantanés consécutifs
s'insèrent sous l'instantané à partir duquel on a restauré.</para>
<para>L'opération <computeroutput>restorecurrent</computeroutput> est un
raccourci pour restaurer l'instantané actuel (donc l'instantané d'où provient
l'état actuel). Cette sous-commande revient à utiliser la sous-commande
"restore" avec le nom ou l'UUID de l'instantané actuel, sauf qu'elle évite
l'étape supplémentaire de déterminer ce nom ou cet UUID.</para>
<para>Avec l'opération <computeroutput>edit</computeroutput>, vous pouvez
modifier le nom ou la description d'un instantané existant.</para>
<para>Avec l'opération <computeroutput>showvminfo</computeroutput>, vous
pouvez voir les paramètres de la machine virtuelle stockées dans un instantané
existant.</para>
</sect1>
<sect1 id="vboxmanage-closemedium">
<title>VBoxManage closemedium</title>
<para>Cette commande supprime un fichier image de disque dur, de DVD ou
disquette, d'un registre de médias VirtualBox.<footnote>
<para>Avant VirtualBox 4.0, il fallait appeler VBoxManage
openmedium avant de pouvoir attacher un média à une machine virtuelle ;
cet appel "enregistrait" le média avec le registre des médias global de
VirtualBox. Avec VirtualBox 4.0, ce n'est plus nécessaire ; les
médias sont ajoutés aux registres des médias automatiquement. L'appel
"closemedium" a cependant été conservé pour permettre de supprimer
explicitement un média du registre.</para>
</footnote></para>
<para>Éventuellement, vous pouvez demander que l'image seit effacée. Vous aurez
les retours circonstanciés selon lesquels la suppression a échoué, mais l'image
ne sera pas enregistrée.</para>
</sect1>
<sect1 id="vboxmanage-storageattach">
<title>VBoxManage storageattach</title>
à un contrôleur de stockage précédemment ajouté avec la commande
<computeroutput>storagectl</computeroutput> (voir la section précédente).
La syntaxe est ainsi :</para>
<screen>VBoxManage storageattach <uuid|nomvm>
--storagectl <name>
[--port <number>]
[--device <number>]
[--type dvddrive|hdd|fdd]
[--medium none|emptydrive|
<uuid>|<filename>|host:<drive>|iscsi]
[--mtype normal|writethrough|immutable|shareable]
[--comment <text>]
[--setuuid <uuid>]
[--setparentuuid <uuid>]
[--passthrough on|off]
[--tempeject on|off]
[--nonrotational on|off]
[--discard on|off]
[--bandwidthgroup name|none]
[--forceunmount]
[--server <name>|<ip>]
[--target <target>]
[--tport <port>]
[--lun <lun>]
[--encodedlun <lun>]
[--username <username>]
[--password <password>]
[--initiator <initiator>]
[--intnet]</screen>
<para>Un certain nombre de paramètres sont requis classiquement ; ceux
à la fin de la liste ne sont requis que pour les cibles iSCSI (voir ci-dessous).</para>
<para>Les paramètres classiques sont :<glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>Le nom ou l'UUID de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>storagectl</computeroutput></glossterm>
<glossdef>
<para>Nom du contrôleur de stockage. Obligatoire. Vous pouvez obtenir
la liste des contrôleurs de stockage actuellement attachés à une VM
avec <computeroutput>VBoxManage showvminfo</computeroutput> ; voir
<xref linkend="vboxmanage-showvminfo" />.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>port</glossterm>
<glossdef>
<para>Le numéro du port du contrôleur de stockage qui doit être
modifié. Obligatoire, sauf si le contrôleur de stockage n'a qu'un
seul port.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>device</glossterm>
<glossdef>
<para>Le numéro du périphérique du port à modifier. Obligatoire,
sauf si le contrôleur de stockage n'a qu'un périphérique par port.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>type</glossterm>
<glossdef>
<para>Définit le type de lecteur auquel doit être
attaché/détaché/modifié un média. On ne peut se passer de cet
argument que si le type de média peut être déterminé par le média
donné avec l'argument <computeroutput>--medium</computeroutput> argument ou
à partir de précédents rattachements de médias</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>medium</glossterm>
<glossdef>
<para>Spécifie ce qu'il faut attacher. Les valeurs suivantes sont
supportées :<itemizedlist>
<listitem>
<para>"none" : Tout périphérique existant serait supprimé du
slot donné.</para>
</listitem>
<listitem>
<para>"emptydrive" : Pour un lecteur amovible ou de DVD
virtuel, cela fait se comporter le périphérique comme un lecteur
amovible dans lequel on n'a inséré aucun média.</para>
</listitem>
<listitem>
<para>"additions" : Seulement pour un lecteur DVD virtuel,
ceci connecte l'image des <emphasis>Suppléments invité de
VirtualBox</emphasis> au slot de périphérique donné.</para>
</listitem>
<listitem>
<para>Si vous spécifiez un UUID, il doit s'agir de l'UUID d'un
média de stockage déjà connu de VirtualBox (par exemple parce qu'il
a été attaché à une autre machine virtuelle). Voir
<xref linkend="vboxmanage-list" /> pour la façon de lister
les médias connus. Ce média est alors attaché au slot du
périphérique donné.</para>
</listitem>
<listitem>
<para>Si vous spécifiez un nom de fichier, il doit s'agir du
chemin complet vers une image de disque existante (ISO, RAW, VDI, VMDK
ou autre), qui est donc attaché au slot du périphérique donné.</para>
</listitem>
<listitem>
<para>"host:<lecteur>": Pour un lecteur amovible ou de DVD
virtuel seulement, ceci connecte le slot du périphérique donné
au lecteur amovible ou de DVD spécifié sur l'ordinateur hôte.</para>
</listitem>
<listitem>
<para>"iscsi" : Pour les disques durs virtuels seulement,
cela permet de spécifier une cible iSCSI. Dans ce cas, vous
devez donner davantage de paramètres ; voir ci-dessous.</para>
</listitem>
</itemizedlist></para>
<para>Certaines modifications ci-dessus, en particulier concernant
pendant que la VM est en fonction. Les autres (changement de périphérique
ou dans les slots des disques durs) exigent que la VM soit éteinte.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>mtype</glossterm>
<glossdef>
<para>Définit la façon dont ce média se comporte vis-à-vis des
instantanés et des opérations d'écriture. Voir <xref linkend="hdimagewrites" />
pour des détails.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>comment</glossterm>
<glossdef>
<para>Une description que vous souhaitez stocker avec ce média (facultative ;
par exemple pour une cible iSCSI, "Gros serveur de stockage de l'étage
inférieur"). C'est purement descriptif et facultatif pour que le
média fonctionne correctement.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>setuuid, setparentuuid</glossterm>
<glossdef>
<para>Modifie l'UUID ou l'UUID parent d'un média avant de l'attacher
à une VM. C'est une option pour experts. Une utilisation impropre
peut rendre le média inutilisable ou donner des configurations de VM
cassées si une autre VM se réfère déjà au même média. La variante
la plus fréquemment utilisée est <code>--setuuid ""</code>, qui
affecte un nouvel UUID (aléatoire) à une image. Cela sert à résoudre
des erreurs d'UUID dupliqués si on a dupliqué une image par les
outils de copie de fichiers.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>passthrough</glossterm>
<glossdef>
<para>Seulement pour un lecteur DVD virtuel, vous pouvez activer
le support de gravure sur DVD (actuellement expérimental ; voir
<xref linkend="storage-cds" />).</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>tempeject</glossterm>
<glossdef>
<para>Seulement pour un lecteur DVD virtuel, vous pouvez configurer
le comportement de l'éjection du média déclenchée par l'invité.
Si vous l'activez, l'éjection n'a qu'un effet temporaire. Si vous
éteignez puis redémarrez la VM, le média configuré au départ sera
toujours dans le lecteur.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>nonrotational</glossterm>
<glossdef>
<para>Ce paramètre permet d'activer le drapeau non-rotational pour
les disques durs virtuels. Certains invités (comme Windows 7+) gèrent
de tels disques comme des SSDs et ne fragmentent pas de tels médias.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>bandwidthgroup</glossterm>
<glossdef>
<para>Définit le groupe de bande passante à utiliser pour le
périphérique donné ; voir <xref linkend="storage-bandwidth-limit" />.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>forceunmount</glossterm>
<glossdef>
<para>Seulement pour un lecteur DVD ou amovible virtuel, cela démonte
même si celui précédent est verrouillé en lecture par l'invité.
De nouveau, voir <xref linkend="storage-cds" /> pour des détails.</para>
</glossdef>
</glossentry>
</glosslist></para>
<para>Quand on utilise "iscsi" avec le paramètre
<computeroutput>--medium</computeroutput> pour le support iSCSI --
voir <xref linkend="storage-iscsi" /> --, vous pouvez ou devez utiliser
des paramètres supplémentaires :<glosslist>
<glossentry>
<glossterm>server</glossterm>
<glossdef>
<para>Le nom de l'hôte ou l'adresse IP de la cible iSCSI ;
requis.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>target</glossterm>
<glossdef>
<para>La chaîne du nom de la cible. Il est déterminé par la cible iSCSI
et il est utilisé pour identifier la ressource de stockage ;
requis.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>tport</glossterm>
<glossdef>
</glossdef>
</glossentry>
<glossentry>
<glossterm>lun</glossterm>
<glossdef>
<para>Numéro d'unité logique de la ressource cible (facultatif).
Souvent, cette valeur vaut zéro.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>username, password</glossterm>
<glossdef>
<para>Nom d'utilisateur et mot de passe (initiator secret) pour
l'authentification sur la cible si nécessaire (facultatif).<note>
<para>Le nom d'utilisateur et le mot de passe sont stockés sans
chiffrement (donc en clair) dans le fichier XML de configuration
de la VM si vous ne fournissez aucun paramètre de mot de passe.
Quand vous spécifiez pour la première fois un paramètre de mot de passe,
le mot de passe est stocké et chiffré.</para>
</note></para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>intnet</glossterm>
<glossdef>
<para>Si spécifié, connecte à la cible iSCSI via le réseau
interne. Cela nécessite une configuration supplémentaire décrite au
<xref linkend="iscsi-intnet" />.</para>
</glossdef>
</glossentry>
</glosslist></para>
</sect1>
<sect1 id="vboxmanage-storagectl">
<title>VBoxManage storagectl</title>
Après elle, on peut attacher des médias virtuels au contrôleur avec la
commande <computeroutput>storageattach</computeroutput> (voir la prochaine
section).</para>
<para>La syntaxe est comme suit :</para>
<screen>VBoxManage storagectl <uuid|nomvm>
--name <nom>
[--controller <LsiLogic|LSILogicSAS|BusLogic|
IntelAhci|PIIX3|PIIX4|ICH6|I82078>]
[--sataportcount <1-30>]
[--hostiocache on|off]
[--bootable on|off]
[--remove]</screen>
<para>où les paramètres signifient :<glosslist>
<glossentry>
<glossterm>uuid|nomvm</glossterm>
<glossdef>
<para>Nom ou UUID de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>nom</glossterm>
<glossdef>
<para>Nom du contrôleur de stockage. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>add</glossterm>
<glossdef>
<para>Définit le type de bus système auquel doit être connecté le
contrôleur de stockage.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>controller</glossterm>
<glossdef>
<para>Permet de choisir le type de chipset à émuler pour le
contrôleur de stockage donné.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>sataportcount</glossterm>
<glossdef>
<para>Ceci détermine le nombre de ports que le contrôleur SATA
devrait supporter.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>hostiocache</glossterm>
<glossdef>
<para>Configure l'utilisation du cache E/S de l'hôte pour toutes les
images de disque attachées à ce contrôleur de stockage. Pour des détails,
merci de voir <xref
linkend="iocaching" />.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>bootable</glossterm>
<glossdef>
<para>Sélectionne si ce contrôleur est amorçable.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>remove</glossterm>
<glossdef>
<para>Supprime le contrôleur de stockage de la config de la VM.</para>
</glossdef>
</glossentry>
</glosslist></para>
</sect1>
<sect1>
<title>VBoxManage bandwidthctl</title>
passante de la machine virtuelle donnée :<screen>VBoxManage bandwidthctl <uuid|nomvm>
add <nom> --type disk|network --limit <megabytes per second>[k|m|g|K|M|G] |
set <nom> --limit <megabytes per second>[k|m|g|K|M|G] |
remove <nom> |
list [--machinereadable]</screen></para>
<para>Les sous-commandes suivantes sont disponibles :<itemizedlist>
<listitem>
<para><computeroutput>add</computeroutput>, crée un nouveau groupe de
bande passante d'un type donné.</para>
</listitem>
<listitem>
<para><computeroutput>set</computeroutput>, modifie la limite d'un groupe
de bande passante existante.</para>
</listitem>
<listitem>
<para><computeroutput>remove</computeroutput>, détruit un groupe de
bande passante.</para>
</listitem>
<listitem>
<para><computeroutput>list</computeroutput>, affiche tous les groupes
de bande passante définis pour la VM donnée.</para>
</listitem>
</itemizedlist>
</para>
<para>Les paramètres signifient :<glosslist>
<glossentry>
<glossterm>uuid|nomvm</glossterm>
<glossdef>
<para>Le nom ou l'UUID de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>nom</glossterm>
<glossdef>
<para>Nom du groupe de bande passante. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>type</glossterm>
<glossdef>
<para>Type de groupe de bande passante. Obligatoire. Deux types sont
supportés : <computeroutput>disk</computeroutput> et
<computeroutput>network</computeroutput>. Voir
<xref linkend="storage-bandwidth-limit" /> ou
<xref linkend="network_bandwidth_limit" /> pour une description d'un
type particulier.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>limit</glossterm>
<glossdef>
<para>Spécifie la limite du groupe donné. On peut le modifier pendant
que la VM est en fonction. L'unité par défaut est en mégaoctet par
seconde. Vous pouvez modifier l'unité en spécifiant un des
suffixes suivants : <computeroutput>k</computeroutput> pour
kilobits/s, <computeroutput>m</computeroutput> pour mégabits/s,
<computeroutput>g</computeroutput> pour gigabits/s,
<computeroutput>K</computeroutput> pour kilo octets/s,
<computeroutput>M</computeroutput> pour méga octets/s,
<computeroutput>G</computeroutput> pour giga octets/s.</para>
</glossdef>
</glossentry>
</glosslist>
<note>
<para>Les limites de bande passante du réseau ne s'appliquent qu'au
trafic émis par les machines virtuelles. Le trafic reçu par les VMs est
illimité.</para>
</note>
<note>
<para>Pour supprimer un groupe de bande passante, il ne doit être référencé
sur aucun disque ou adaptateur d'une VM en fonction.</para>
</note>
</para>
</sect1>
<sect1>
<title>VBoxManage showhdinfo</title>
<para>Cette commande affiche des informations sur une image de disque
virtuelle, en particulier sa taille sur le disque, son type et les machines
virtuelles qui l'utilisent.<note>
<para>Pour être compatible avec des versions plus anciennes de VirtualBox
la commande "showvdiinfo" est également supportée et associée en
interne à la commande "showhdinfo".</para>
</note></para>
<para>L'image de disque doit être spécifiée soit par son UUID (si le média
est enregistré), soit par le nom du fichier. Les images enregistrées peuvent
être listées par
<computeroutput>VBoxManage list hdds</computeroutput> (voir <xref linkend="vboxmanage-list" />
pour plus d'informations). Un nom de fichier doit être spécifié en tant
que chemin valide, soit absolu soit relatif en partant du répertoire
actuel.</para>
</sect1>
<sect1 id="vboxmanage-createvdi">
<title>VBoxManage createhd</title>
<para>Cette commande crée une nouvelle de disque dur virtuel. La
syntaxe est comme suit :</para>
<screen>VBoxManage createhd --filename <nomfichier>
--size <mégaoctets>
[--format VDI|VMDK|VHD] (par défaut : VDI)
[--variant Standard,Fixed,Split2G,Stream,ESX]</screen>
<para>où les paramètres signifient :<glosslist>
<glossentry>
<glossterm><computeroutput>nomfichier</computeroutput></glossterm>
<glossdef>
<para>Permet de choisir un nom de fichier. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>mégaoctets</computeroutput></glossterm>
<glossdef>
<para>Permet de définir la capacité de l'image, en MiO.
Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>format</computeroutput></glossterm>
<glossdef>
<para>Permet de choisir un format de fichier pour le fichier
de sortie, différent du format du fichier d'entrée.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>variant</computeroutput></glossterm>
<glossdef>
<para>Permet de choisir une variante du format de fichier pour le
fichier de sortie. C'est une liste de drapeaux séparée par des virgules.
Toutes les combinaisons ne sont pas supportées, spécifier des
drapeaux incohérents donne un message d'erreur.</para>
</glossdef>
</glossentry>
</glosslist> <note>
<para>Pour être compatible avec d'anciennes versions de VirtualBox, la
commande "createvdi" est également supportée et associée en interne avec
la commande "createhd".</para>
</note></para>
</sect1>
<sect1 id="vboxmanage-modifyvdi">
<title>VBoxManage modifyhd</title>
<para>Avec la commande <computeroutput>modifyhd</computeroutput>, vous pouvez
modifier les caractéristiques d'une image de disque après l'avoir
créé :<screen>VBoxManage modifyhd <uuid>|<nomfichier>
[--type normal|writethrough|immutable|shareable|
readonly|multiattach]
[--autoreset on|off]
[--compact]
[--resize <megabytes>|--resizebyte <octets>]</screen><note>
<para>Malgré le "hd" du nom de la sous-commande, la commande fonctionne
avec toutes les images de disque et pas seulement les disques durs. Pour
être compatible avec les anciennes versions de VirtualBox, la commande
"modifyvdi" est également supportée et a été associée en interne à la
commande"modifyhd".</para>
</note></para>
<para>L'image de disque doit être spécifiée soit par son UUID (si le média
est enregistré), soit par le nom du fichier. Les images enregistrées peuvent
être listées par
<computeroutput>VBoxManage list hdds</computeroutput> (voir <xref linkend="vboxmanage-list" />
pour plus d'informations). Un nom de fichier doit être spécifié en tant
que chemin valide, soit absolu soit relatif en partant du répertoire
actuel.</para>
<para>Les options suivantes sont disponibles :<itemizedlist>
<listitem>
<para>Avec l'argument <computeroutput>--type</computeroutput>, vous
pouvez modifier le type d'une image existante entre le mode normal,
immuable, write-through et autres modes ; voir <xref
linkend="hdimagewrites" /> pour des détails.</para>
</listitem>
<listitem>
<para>Pour les disques durs immuables seulement (de différenciation),
l'option <computeroutput>--autoreset on|off</computeroutput> détermine
si le disque est automatiquement réinitialisé à chaque démarrage de
la VM (de nouveau, voir <xref linkend="hdimagewrites" />). Par défaut,
c'est actif.</para>
</listitem>
<listitem>
<para>L'option <computeroutput>--compact</computeroutput>,
peut être utilisée pour compresser des images de disque (à savoir
supprimer des blocs qui ne contiennent que des zéros). Cela réallègera
une image à taille dynamique ; cela réduira la taille
<emphasis>physique</emphasis> de l'image sans changer la taille logique
du disque virtuel. La compression fonctionne aussi bien pour les images
de base que celles de différenciation créées dans un instantané.</para>
<para>Pour que l'opération soit efficace, il faut d'abord libérer de
l'espace dans le système invité en y mettant des zéros via le logiciel
adapté. Pour les invités Windows, vous pouvez utiliser l'outil
<computeroutput>sdelete</computeroutput> de Microsoft.
Exécutez <computeroutput>sdelete -z</computeroutput> dans l'invité pour
mettre des zéros dans l'espace libre avant de compresser l'image de
disque virtuel. Pour Linux, utilisez l'outil
Pour les invités Mac OS X, utilisez la fonction <emphasis>Supprimer l'espace libre</emphasis> de
<emphasis>l'outil de disque</emphasis> intégré. Utilisez
<emphasis>Zero Out Data</emphasis>.</para>
<para>Remarquez que la compression n'est actuellement disponible que
pour les images VDI. Vous pouvez obtenir la même chose en mettant des
zéros sur les blocs libres et clonant le disque vers un autre format
dynamique. Vous pouvez utiliser ce contournement jusqu'à ce que la
compression soit supportée pour les autres formats de disque que VDI.</para>
</listitem>
<listitem>
<para>L'option <computeroutput>--resize x</computeroutput> (où x est
le nouvel espace total désiré en <emphasis role="bold">mégaoctets</emphasis>)
vous permet de modifier la capacité d'une image existante ; ceci
ajuste la taille <emphasis>logique</emphasis> d'un disque virtuel sans
beaucoup changer la taille physique.<footnote>
<para>Le redimensionnement d'images a été ajouté à VirtualBox 4.0.</para>
</footnote> Cela ne fonctionne actuellement que pour les formats
VDI et VHD et pour les variantes, à taille dynamique, et vous ne
pouvez l'utiliser que pour augmenter (ou réviser) la capacité.
Par exemple, si vous avez créé au départ un disque de 10G à présent
plein, vous pouvez utiliser la commande <computeroutput>--resize 15360</computeroutput>
pour passer la capacité à 15G (15,360Mo) sans devoir créer une nouvelle
image et y copier toutes les données à partir d'un e machine virtuelle.
Cependant, remarquez que cela ne change que la capacité du lecteur ;
vous devrez ensuite, en général, utiliser un outil de gestion des
partitions dans l'invité pour ajuster la partition principale et
remplir le lecteur.</para><para>L'option <computeroutput>--resizebyte x</computeroutput>
fait presque la même chose mais x est exprimé en octets au lieu de
mégaoctets.</para>
</listitem>
</itemizedlist></para>
</sect1>
<sect1 id="vboxmanage-clonevdi">
<title>VBoxManage clonehd</title>
<para>Cette commande duplique une image de disque dur virtuel enregistrée
vers un nouveau fichier image ayant 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 VirtualBox en utilisant le gestionnaire de médias virtuels ; voir
<xref linkend="vdis" /> et <xref linkend="cloningvdis" />. La syntaxe est
comme suit :</para>
<screen>VBoxManage clonehd <uuid>|<nomfichier> <outputfile>
[--format VDI|VMDK|VHD|RAW|<other>]
[--variant Standard,Fixed,Split2G,Stream,ESX]
[--existing]</screen>
<para>L'image de disque à cloner et celle cible doivent être spécifiées
soit par leur UUID (si le média
est enregistré), soit par leur nom du fichier. Les images enregistrées peuvent
être listées par
<computeroutput>VBoxManage list hdds</computeroutput> (voir <xref linkend="vboxmanage-list" />
pour plus d'informations). Un nom de fichier doit être spécifié en tant
que chemin valide, soit absolu soit relatif en partant du répertoire
actuel.</para>
<para>Les options suivantes sont disponibles :<glosslist>
<glossentry>
<glossterm><computeroutput>--format</computeroutput></glossterm>
<glossdef>
<para>Permet de choisir un format de fichier pour le fichier de
sortie, autre que celui du fichier d'entrée.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--variant</computeroutput></glossterm>
<glossdef>
<para>Permet de choisir une variante de format de fichier pour le
fichier de sortie. C'est une liste de drapeaux séparée par des virgules.
Toutes les combinaisons ne sont pas supportées, spécifier des
drapeaux incohérents donne un message d'erreur.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--existing</computeroutput></glossterm>
<glossdef>
<para>Effectue le clonage sur un média de destination existant. Seule
la partie du média source convenant au média de destination est copiée.
Cela signifie que si le média de destination est plus petit que
la source, seule une partie en est copiée, et si le média de
destination est plus gros que la source, le reste de l'espace du
média de destination reste inchangé.</para>
</glossdef>
</glossentry>
</glosslist> <note>
<para>Pour être compatible avec les anciennes versions de VirtualBox,
la commande "clonevdi" est également supportée et elle a été associée
en interne à la commande "clonehd".</para>
</note></para>
</sect1>
<sect1>
<title>VBoxManage convertfromraw</title>
<para>Cette commande convertit une image de disque brute en fichier VirtualBox Disk Image
(VDI). La syntaxe est la suivante :</para>
<screen>VBoxManage convertfromraw <filename> <outputfile>
[--format VDI|VMDK|VHD]
[--variant Standard,Fixed,Split2G,Stream,ESX]
[--uuid <uuid>]
VBoxManage convertfromraw stdin <fichiersortie> <octets>
[--format VDI|VMDK|VHD]
[--variant Standard,Fixed,Split2G,Stream,ESX]
[--uuid <uuid>]</screen>
<para>où les paramètres signifient :<glosslist>
<glossentry>
<glossterm><computeroutput>--bytes</computeroutput></glossterm>
<glossdef>
<para>La taille du fichier image, en octets, fournie en entrée.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--format</computeroutput></glossterm>
<glossdef>
<para>Sélectionnez le format de l'image de disque à créer. Par
défaut, c'est VDI.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--variant</computeroutput></glossterm>
<glossdef>
<para>Permet de choisir une variante de format de fichier pour le
fichier en sortie. C'est une liste de drapeaux séparée par des
virgules. Toutes les combinaisons ne sont pas supportées, spécifier
des drapeaux incohérents donne un message d'erreur.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--uuid</computeroutput></glossterm>
<glossdef>
<para>Permet de spécifier l'UUID ou le fichier de sortie.</para>
</glossdef>
</glossentry>
</glosslist> La deuxième forme oblige VBoxManage à lire le contenu de
l'image de disque à partir de l'entrée standard (utile pour utiliser
cette commande en ligne).</para>
<para><note>
<para>Pour être compatible avec d'anciennes versions de VirtualBox,
la commande "convertdd" est aussi supportée et elle est associée en interne
à la commande "convertfromraw".</para>
</note></para>
</sect1>
<sect1>
<para>Ces commandes vous permettent d'attacher et de récupérer des chaînes de
données dans une machine virtuelle ou à une configuration de VirtualBox (en
spécifiant <computeroutput>global</computeroutput> au lieu d'un nom de machine
virtuelle). Vous pouvez spécifier une clé (comme chaîne de texte) pour
associer les données que vous pourrez récupérer plus tard. Par exemple :</para>
<screen>VBoxManage setextradata Fedora5 installdate 2006.01.01
VBoxManage setextradata SUSE10 installdate 2006.02.02</screen>
<para>associerait la chaîne "2006.01.01" à la clé installdate pour la
machine virtuelle Fedora5, et "2006.02.02" pour la machine SUSE10. Vous
pourriez récupérer l'information comme suit :</para>
<screen>VBoxManage getextradata Fedora5 installdate</screen>
<para>qui renverrait</para>
<screen>VirtualBox Command Line Management Interface Version $VBOX_VERSION_MAJOR.$VBOX_VERSION_MINOR.$VBOX_VERSION_BUILD
(C) 2005-$VBOX_C_YEAR $VBOX_VENDOR
All rights reserved.
Value: 2006.01.01</screen>
<para>Pour supprimer une clé, la commande <computeroutput>setextradata</computeroutput>
doit être exécutée sans spécifier de données (la clé seule), par exemple:
</para>
<screen>VBoxManage setextradata Fedora5 installdate</screen>
</sect1>
<sect1 id="vboxmanage-setproperty">
<title>VBoxManage setproperty</title>
<para>Cette commande est utilisée pour modifier des paramètres globaux
qui modifient toute l'installation de VirtualBox. Certains d'entre eux
correspondent aux paramètres de la boîte de dialogue "Paramètres globaux" de
l'interface graphique. Les propriétés suivantes sont disponibles :<glosslist>
<glossentry>
<glossterm><computeroutput>machinefolder</computeroutput></glossterm>
<glossdef>
<para>Ceci spécifie le dossier par défaut dans lequel sont
stockées les définitions de la machine virtuelle ; voir <xref linkend="vboxconfigdata" /> pour les détails.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>hwvirtexclusive</computeroutput></glossterm>
<para>Ceci spécife si VirtualBox utilisera en exclusivité les
extensions de virtualisation matérielle (Intel VT-x ou AMD-V) du
processeur du système hôte ; voir <xref linkend="hwvirt" />. Si
vous souhaitez partager ces extensions avec d'autres hyperviseurs en
fonction en même temps, vous devez désactiver ce paramètre.
Cela a des implications négatives en termes de performance.
</para>
</glossentry>
<glossentry>
<glossterm><computeroutput>vrdeauthlibrary</computeroutput></glossterm>
<glossdef>
<para>Ceci indique la bibliothèque à utiliser quand on a sélectionné
l'authentification "externe" pour une machine virtuelle en particulier ;
voir <xref linkend="vbox-auth" /> pour des détails.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>websrvauthlibrary</computeroutput></glossterm>
<glossdef>
<para>Ceci spécifie la bibliothèque utilisée par le service web
pour authentifier les utilisateurs. Pour des détails sur le service
web de VirtualBox, merci de vous reporter au manuel de référence SDK
distinct de VirtualBox (voir <xref
linkend="VirtualBoxAPI" />).</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>vrdeextpack</computeroutput></glossterm>
<glossdef>
<para>Ceci spécifie la bibliothèque qui implémente l'extension Bureau
distant de VirtualBox.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>loghistorycount</computeroutput></glossterm>
<glossdef>
<para>Ceci sélectionne le nombre de journaux de VMs (anciens)
conservés.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>autostartdbpath</computeroutput></glossterm>
<glossdef>
<para>Ceci sélectionne le chemin vers la base de données autostart.
Voir <xref linkend="autostart" />.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>defaultfrontend</computeroutput></glossterm>
<glossdef>
<para>Ceci sélectionne l'interface globale des VMs. Voir
<xref linkend="vboxmanage-startvm" />.</para>
</glossdef>
</glossentry>
</glosslist></para>
</sect1>
<sect1>
<para>Les commandes <computeroutput>usbfilter</computeroutput> sont utilisées
pour travailler avec des filtres USB dans des machines virtuelles ou avec
des filtres globaux qui concernent tout le paramétrage de VirtualBox. Les
filtres globaux sont appliqués avant les filtres spécifiques aux machines et
ils peuvent être utilisés pour empêcher les périphériques d'être capturés par
une machine virtuelle. Les filtres globaux s'appliquent toujours dans un
ordre particulier, et seul le premier filtre convenant à un périphérique est
appliqué. Par exemple, si le premier filtre global dit de garder (rendre
disponible) une carte mémoire Kingston particulière et le deuxième d'ignorer
tous les périphériques Kingston, cette carte mémoire sera disponible pour
toutes les machines ayant un filtre adéquat mais pas les autres périphériques
Kingston.</para>
<para>Lors de la création d'un filtre USB en utilisant
<computeroutput>usbfilter add</computeroutput>, vous devez fournir trois ou
quatre paramètres obligatoires. L'index spécifie la position du filtre dans
la liste. S'il y a déjà un filtre à cette place, lui-mâme et les suivants
seront déplacés. Sinon, le nouveau filtre sera ajouté à la fin de la liste.
Le paramètre <computeroutput>target</computeroutput> sélectionne la
machine virtuelle à laquelle devrait être attaché le
filtre, sinon utilisez "global" pour l'appliquer à toutes les machines virtuelles.
<computeroutput>name</computeroutput> est le nom du nouveau filtre et
des filtres globaux, <computeroutput>action</computeroutput> autorise les
machines à accéder aux périphériques correspondant à la description du
filtre ("hold") ou ne leur donne pas accès ("ignore"). En outre, vous devriez
spécifier des paramètres de filtrage. Vous pouvez trouver les paramètres des
périphériques attachés à votre système en utilisant <computeroutput>VBoxManage list usbhost</computeroutput>.
Enfin, vous pouvez spécifier si le filtre devrait être actif, et pour les
filtres globaux, s'ils concernent les périphériques locaux, à distance (par
connexion RDP) ou autrement.</para>
<para>Quand vous modifiez un filtre USB en utilisant
<computeroutput>usbfilter modify</computeroutput>, vous devez spécifier le
filtre par index (voir la sortie de
<computeroutput>VBoxManage list usbfilters</computeroutput> pour voir les
indexes des filtres globaux et <computeroutput>VBoxManage
showvminfo</computeroutput> pour voir les indexes des machines individuelles),
et par cible, laquelle est soit une machine virtuelle, soit "global". Les
propriétés modifiables sont les mêmes que pour <computeroutput>usbfilter
add</computeroutput>. Pour supprimer un filtre, utilisez <computeroutput>usbfilter
remove</computeroutput> et spécifiez l'index et la cible.</para>
</sect1>
<sect1 id="vboxmanage-sharedfolder">
<para>Cette commande vous permet de partager des dossiers de l'ordinateur hôte
avec les systèmes d'exploitation invités. Pour cela, il faut que les systèmes
invités aient une version installée des Suppléments invité qui supporte cette
fonctionnalité.</para>
<para>Les dossiers partagés sont décrits en détails au <xref
linkend="sharedfolders" />.</para>
</sect1>
<sect1 id="vboxmanage-guestproperty">
<title>VBoxManage guestproperty</title>
<para>Les commandes "guestproperty" vous permettent de voir ou de définir
les propriétés d'une machine virtuelle en fonction. Merci de voir <xref linkend="guestadd-guestprops" />
pour une présentation. Comme il y est expliqué, les propriétés de l'invité
sont des pairs de chaînes clé/valeur arbitraires qu'on peut changer et lire
depuis l'hôte ou l'invité, donc on peut les utiliser comme des canaux de
communication à faible volume pour des chaînes du moment qu'un invité est
en fonction et a installé les suppléments invité. De plus, un certain nombre
de valeurs dont les clés commencent par "/VirtualBox/" sont automatiquement
définies et maintenues par les suppléments invité.</para>
<para>Les sous-commandes sont disponibles (où
<computeroutput><vm></computeroutput>, dans chaque cas, peut être
soit un nom soit un UUID d'une VM, comme pour les autres commandes de
VBoxManage) :<itemizedlist>
<listitem>
<para><computeroutput>enumerate <vm> [--patterns
<pattern>]</computeroutput> : Ceci liste toutes les
propriétés invité disponibles pour une VM donnée avec leur valeur.
Cette liste sera très limitée si le processus service de l'invité
ne peut pas être contacté, notamment car la VM n'est pa en fonction
ou les suppléments invité ne sont pas installés.</para>
<para>Si vous spécifiez <computeroutput>--patterns
<échantillon></computeroutput>, il agit comme un filtre pour ne
lister que les propriétés correspondant à l'échantillon donné. L'échantillon
peut contenir les caractères jokers suivants :<itemizedlist>
<listitem>
<para><computeroutput>*</computeroutput> (astérisque) :
représente n'importe quel nombre de caractères ; par exemple,
"<computeroutput>/VirtualBox*</computeroutput>" correspondrait
à toutes les propriétés commençant par "/VirtualBox".</para>
</listitem>
<listitem>
<para><computeroutput>?</computeroutput> (point d'interrogation) :
représente un seul caractère de votre choix ; par exemple,
"<computeroutput>fo?</computeroutput>" correspondrait à "foo"
et à "for".</para>
</listitem>
<listitem>
<para><computeroutput>|</computeroutput> (symbole pipe) :
peut être utilisé pour spécifier plusieurs échantillons alternatifs ;
par exemple, "<computeroutput>s*|t*</computeroutput>" correspondrait
à tout ce qui commence par un "s" ou un "t".</para>
</listitem>
</itemizedlist></para>
</listitem>
<listitem>
<para><computeroutput>get <vm></computeroutput> : Ceci ne
récupère la valeur que d'une propriété. Si la propriété est introuvable
(par exemple car l'invité n'est pas en fonction), ceci affichera
<screen>No value set!</screen></para>
</listitem>
<listitem>
<para><computeroutput>set <vm> <propriété> [<valeur>
[--flags <drapeaux>]]</computeroutput> : Ceci vous permet
de définir une propriété invité en spécifiant la clé et la valeur.
Si vous ne mettez pas <computeroutput><valeur></computeroutput>,
la propriété est effacée. Avec <computeroutput>--flags</computeroutput>,
vous pouvez éventuellement spécifier un comportement supplémentaire
(vous pouvez en combiner plusieurs en les séparant par des virgules) :<itemizedlist>
<listitem>
<para><computeroutput>TRANSIENT</computeroutput> : la
valeur ne sera pas stockée avec les données de la VM quand la
VM exite ;</para>
</listitem>
<listitem>
<para><computeroutput>TRANSRESET</computeroutput> : la valeur
</listitem>
<listitem>
<para><computeroutput>RDONLYGUEST</computeroutput> : la
valeur ne peut être modifiée que par l'hôte, l'invité ne
peut que la lire ;</para>
</listitem>
<listitem>
<para><computeroutput>RDONLYHOST</computeroutput> : inversement,
cette valeur ne peut être modifiée que par l'invité, l'hôte
ne peut que la lire ;</para>
</listitem>
<listitem>
<para><computeroutput>READONLY</computeroutput> : la
combinaison des deux, la valeur ne peut pas être modifiée.</para>
</listitem>
</itemizedlist></para>
</listitem>
<listitem>
<para><computeroutput>wait <vm> <échantillon> --timeout
<timeout></computeroutput> : Ceci attend une valeur
particulière décrite par "échantillon" à modifier ou effacer ou à
créer. Les règles de l'échantillon sont les mêmes qu'avec la commande
"enumerate" ci-dessus.</para>
</listitem>
<listitem>
<para><computeroutput>delete <vm> <propriété>
</computeroutput> : Efface une propriété invité définie précédemment.</para>
</listitem>
</itemizedlist></para>
</sect1>
<sect1 id="vboxmanage-guestcontrol">
<title>VBoxManage guestcontrol</title>
<para>Les commandes <computeroutput>guestcontrol</computeroutput> vous permettent de contrôler certaines
choses de l'invité à partir de l'hôte. Merci de voir <xref
linkend="guestadd-guestcontrol" /> pour une présentation.</para>
<para>En général, la syntaxe est la suivante :</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> <commande></screen>
<para>Les sous-commandes suivantes sont disponibles (où
<computeroutput><uuid|nomvm></computeroutput>, dans tous les cas, peut
être le nom ou l'UUID d'une VM comme avec les autres commandes de
VBoxManage) :<itemizedlist>
<listitem>
<para><emphasis role="bold"><computeroutput>execute</computeroutput></emphasis>, qui permet d'exécuter un
Cette commande ne fonctionne que pendant qu'une VM est active et en
fonction et sa syntaxe est la suivante :</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> exec[ute]
--image <chemin du programme> --username <nom>
[--passwordfile <fichier> | --password <mot de passe>]
[--environment "<NOM>=<VALEUR> [<NOM>=<VALEUR>]"]
[--verbose] [--timeout <msec>]
[--wait-exit] [--wait-stdout] [--wait-stderr]
[--dos2unix] [--unix2dos]
-- [[<argument1>] ... [<argumentN>]]</screen>
<para>où les paramètres signifient :<glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>Le nom ou l'UUID de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--image "<chemin du programme>"</computeroutput></glossterm>
<glossdef>
<para>Chemin absolu et nom du processus à exécuter dans
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--username <nom></computeroutput></glossterm>
<glossdef>
<para>Nom de l'utilisateur sous lequel devrait se lancer le
processus. Cet utilisateur doit exister sur l'OS invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--passwordfile <fichier></computeroutput></glossterm>
<glossterm><computeroutput>--password <motdepasse></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié, à lire dans
le fichier donné. Si vous n'en donnez pas, un mot de passe
vierge est supposé.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>--password <mot de passe></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié avec
<computeroutput>--username</computeroutput>. Si vous n'en
donnez pas, un mot de passe vierge est supposé.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--dos2unix</computeroutput></glossterm>
<glossdef>
en fins compatibles UNIX (CR + LF -> LF). Pas encore implémenté.
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--environment
"<NOM>=<VALEUR>"</computeroutput></glossterm>
<glossdef>
<para>Une ou plusieurs variables d'environnement à définir ou
dérégler.</para>
<para>Par défaut, le nouveau processus de l'invité sera
créé avec l'environnement standard de l'OS invité. Cette
une variable, une paire <computeroutput>NOM=VALEUR</computeroutput> doit
être spécifiée ; pour réinitialiser une certaine variable, le
nom sans valeur doit être défini, par exemple
<computeroutput>NOM=</computeroutput>.</para>
<para>Les arguments contenant des espaces doivent être entourés
de guillemets. Vous pouvez spécifier plus d'un
<computeroutput>--environment</computeroutput> en même temps
pour maintenir vierge la ligne de commande.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--timeout <msec></computeroutput></glossterm>
<glossdef>
<para>Valeur (en millisecondes) qui spécifie la durée pendant
laquelle le processus démarré est autorisé à fonctionner et
combien de temps VBoxManage attend une sortie de ce processus.
Si vous ne spécifiez pas de timeout, VBoxManage attendra
jusqu'à ce que le processus démarré se termine ou ce qu'une
erreur ne survienne.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--unix2dos</computeroutput></glossterm>
<glossdef>
en fins compatibles UNIX (CR + LF -> LF). Pas encore implémenté.
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus verbeux.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--wait-exit</computeroutput></glossterm>
<glossdef>
<para>Attend la fin d'un processus et affiche son code de
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--wait-stdout</computeroutput></glossterm>
<glossdef>
<para>Attend la fin d'un processus et affiche son code de
VBoxManage récupère la sortie du processus sur stdout.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--wait-stderr</computeroutput></glossterm>
<glossdef>
<para>Attend la fin d'un processus et affiche son code de
VBoxManage récupère la sortie du processus sur stderr.</para> </glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>[-- [<argument1s>] ... [<argumentNs>]]</computeroutput></glossterm>
<glossdef>
<para>Un ou plusieurs arguments à passer au processus à
exécuter.</para>
<para>Les arguments contenant des espaces doivent être entourés
de guillemets.</para>
</glossdef>
</glossentry>
</glosslist></para>
<para><note>
<para>Sur Windows, il existe certaines limites pour les applications
graphiques ; merci de voir <xref linkend="KnownIssues" /> pour
plus d'informations.</para>
--username foo --passwordfile bar.txt --wait-exit --wait-stdout -- -l /usr</screen> <screen>VBoxManage --nologo guestcontrol "My VM" execute --image "c:\\windows\\system32\\ipconfig.exe"
--username foo --passwordfile bar.txt --wait-exit --wait-stdout</screen> Remarquez que
les deux barres obliques inversées du deuxième exemple ne sont requis
que pour les hôtes Unix.</para>
<para><note>
<para>Pour certaines commandes, il faut spécifier le nom d'utilisateur
d'un compte utilisateur existant sur l'invité ; les exécutions
anonymes ne sont pas supportées pour des raisons de sécurité.
Néanmoins, le mot de passe d'un compte utilisateur est facultatif
et dépend de la politique et des règles de l'invité. Si vous ne
spécifiez aucun mot de passe pour un nom d'utilisateur donné,
un mot de passe vierge sera utilisé. Sur certains OS comme Windows,
il pe peut qu'il faille ajuster la politique de sécurité pour autoriser
le paramétrage d'un compte utilisateur avec un mot de passe vierge.
En outre, les règles du domaine global pourraient s'appliquer et, donc,
on ne peut pas les modifier.</para>
</note></para>
<para>À partir de VirtualBox 4.1.2 l'exécution d'un processus invité
par défaut se limite à 5 processus invités en même temps. Si un
nouveau processus invité est lancé et dépasserait cette limite, le
plus ancien dans l'invité qui ne s'exécute pas sera désactivé afin de
pouvoir lancer ce nouveau processus. En outre, la récupération de la
sortie de cet ancien processus invité ne sera alors plus possible.
Si les 5 processus invités sont toujours actifs et en fonction, le
démarrage d'un nouveau processus enverra un message d'erreur circonstancié.</para>
<para>Pour augmenter ou diminuer la limite d'exécution des processus
invité, il faut modifier soit la propriété <computeroutput>/VirtualBox/GuestAdd/VBoxService/--control-procs-max-kept</computeroutput>,
soit la ligne de commande ee VBoxService en spécifiant
<computeroutput>--control-procs-max-kept</computeroutput>. Il faut
ensuite redémarrer l'OS invité. Pour gérer un nombre illimité de
processus invités, il faut définir une valeur de <computeroutput>0</computeroutput>
(non recommandé).</para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>copyto</computeroutput></emphasis>, qui permet de copier
des fichiers de l'hôte vers l'invité (seulement si les suppléments invité
4.0 et supérieur sont installés).</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> copyto|cp
<source invité> <hôte dest> --username <nom>
[--passwordfile <fichier> | --password <mot de passe>]
[--dryrun] [--follow] [--recursive] [--verbose]</screen>
<para>où les paramètres signifient :<glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>source sur l'hôte</computeroutput></glossterm>
<glossdef>
sur l'hôte pour copier vers l'invité, comme
Il peut s'agir d'une expression joker, comme
<computeroutput>C:\Windows\System32\*.dll</computeroutput></para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>destination sur l'invité</computeroutput></glossterm>
<glossdef>
<para>Chemin de destination absolu sur l'invité, comme
<computeroutput>C:\Temp</computeroutput></para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--username <nom></computeroutput></glossterm>
<glossdef>
<para>Nom d'utilisateur sous lequel devrait fonctionner le
processus de copie. Cet utilisateur doit exister sur l'OS
invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--passwordfile <fichier></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié, à lire dans
le fichier donné. Si vous n'en donnez pas, un mot de passe
vierge est supposé.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--password <mot depasse></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié avec
<computeroutput>--username</computeroutput>. Si vous n'en
donnez pas, un mot de passe vierge est supposé.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--dryrun</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage de ne faire qu'une exécution "sèche" au
lieu de copier vraiment les fichiers dans l'invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--follow</computeroutput></glossterm>
<glossdef>
<para>Active le suivi des liens symboliques sur la
source de l'hôte.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--recursive</computeroutput></glossterm>
<glossdef>
<para>Copie récursivement les fichiers/répertoires de la
source spécifiée.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus verbeux.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--flags <drapeaux></computeroutput></glossterm>
<glossdef>
<para>Drapeaux supplémentaires à définir. Ce n'est pas utilisé
pour le moment.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>copyfrom</computeroutput></emphasis>,
qui permet de copier
des fichiers de l'invité vers l'hôte (seulement si les suppléments
invité 4.0 et supérieur sont installés). Il prend les mêmes paramètres
que <computeroutput>copyto</computeroutput> ci-dessus.</para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>createdirectory</computeroutput></emphasis>, qui permet de copier
des fichiers de l'invité vers l'hôte (seulement si les suppléments
invité 4.0 et supérieur sont installés). Il prend les mêmes paramètres
que <computeroutput>copyto</computeroutput> ci-dessus.</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> createdir[ectory]|mkdir|md
<répertoire invité>... --username <nom>
[--passwordfile <fichier> | --password <mot de passe>]
[--parents] [--mode <mode>] [--verbose]</screen>
<para>où les paramètres signifient :<glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>répertoire à créer sur l'invité</computeroutput></glossterm>
<glossdef>
comme <computeroutput>D:\Foo\Bar</computeroutput>. Les répertoires
Parents doivent exister (comme dans cet exemple
<computeroutput>D:\Foo</computeroutput>) si vous ne mettez pas
<computeroutput>--parents</computeroutput>. L'utilisateur
spécifié doit avoir les droits appropriés pour créer le répertoire
spécifié.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--username <nom></computeroutput></glossterm>
<glossdef>
<para>Nom de l'utilisateur sous lequel devrait fonctionner
le processus de copie. Cet utilisateur doit exister sur l'OS
invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--passwordfile <fichier></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié, à lire dans
le fichier donné. Si vous n'en donnez pas, un mot de passe
vierge est supposé.</para> </glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--password <mot de passe></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié avec
<computeroutput>--username</computeroutput>. Si vous n'en
donnez pas, un mot de passe vierge est supposé.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--parents</computeroutput></glossterm>
<glossdef>
<para>Crée aussi les répertoires parent non encore créés
pour le répertoire spécifié, par exemple si le répertoire
<computeroutput>D:\Foo</computeroutput> de
<computeroutput>D:\Foo\Bar</computeroutput> n'existe pas encore,
il sera créé. Si on ne spécifie pas
<computeroutput>--parent</computeroutput>, l'action échouerait.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--mode <mode></computeroutput></glossterm>
<glossdef>
<para>Définit les droits du répertoire spécifié. Seules des
valeurs octales (comme
<computeroutput>0755</computeroutput>) sont supportées pour l'heure.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus verbeux.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>removedirectory</computeroutput></emphasis>,
qui permet d'effacer des répertoires dans l'invité (seulement ceux où
sont installés les suppléments invité 4.3.2 et supérieur).</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> removedir[ectory]|rmdir
<répertoire invité>... --username <nom>
[--passwordfile <fichier> | --password <mot_de_passe>]
[--recursive|-R|-r] [--verbose]</screen>
<para>où les paramètres signifient : <glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>répertoire à supprimer dans l'invité</computeroutput></glossterm>
<glossdef>
l'invité, par exemple <computeroutput>D:\Foo\Bar</computeroutput>.
L'utilisateur spécifié doit avoir les bons droits pour effacer
le(s) répertoire(s) de l'invité spécifié(s).</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--username <nom></computeroutput></glossterm>
<glossdef>
<para>Nom d'utilisateur sous lequel devrait fonctionner le
processus de copie. Cet utilisateur doit exister sur l'OS invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--passwordfile <fichier></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié qui lit le
fichier donné. Si vous n'en mettez pas, on supposera un mot de
passe vide.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--password <mot_de_passe></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié par
<computeroutput>--username</computeroutput>. Si vous n'en donnez pas, on supposera un mot de
passe vide.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--recursive</computeroutput></glossterm>
<glossdef>
<para>Supprime des répertoires et, récursivement, leur contenu.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus bavard.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>removefile</computeroutput></emphasis>,
qui permet d'effacer des fichiers sur l'invité (seulement là où sont
installés les suppléments invité 4.3.2 et supérieur).</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> removefile|rm
<fichier_d_invité>... --username <nom>
[--passwordfile <fichier> | --password <mot_de_passe>]
[--verbose]</screen>
<para>où les paramètres signifient : <glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>fichier à supprimer dans l'invité</computeroutput></glossterm>
<glossdef>
L'utilisateur spécifié doit avoir les bons droits pour effacer
les fichiers spécifiés sur l'invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--username <nom></computeroutput></glossterm>
<glossdef>
<para>Nom d'utilisateur sous lequel devrait fonctionner le
processus de copie. Cet utilisateur doit exister sur l'OS invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--passwordfile <fichier></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié qui lit le
fichier donné. Si vous n'en mettez pas, on supposera un mot de
passe vide.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--password <mot_de_passe></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié avec
<computeroutput>--username</computeroutput>. Si vous n'en
donnez pas, un mot de passe vierge est supposé.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus bavard.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>ren[ame]|mv</computeroutput></emphasis>,
qui permet de renommer des fichiers (ou des répertoires) dans l'invité
(seulement là où sont installés les suppléments invité 4.3.2 et
supérieur).</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> ren[ame]|mv
<source>... <dest> --username <nom>
[--passwordfile <fichier> | --password <mot_de_passe>]
[--verbose]</screen>
<para>où les paramètres signifient : <glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>source</computeroutput></glossterm>
<glossdef>
<para>Chemin absolu d'une ou plusieurs sources à déplacer
quelque part. Si vous spécifiez plus d'une source, la destination
doit être un répertoire existant sur la VM. L'utilisateur
spécifié doit avoir les bons droits d'accès aux fichiers et
aux répertoires sources et de destination.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>dest</computeroutput></glossterm>
<glossdef>
source(s). Il peut s'agir d'un répertoire ou d'un fichier, selon
que vous spécifiez une ou plusieurs sources. L'utilisateur
spécifié doit avoir les bons droits d'accès au fichier et au
répertoire de.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--username <nom></computeroutput></glossterm>
<glossdef>
<para>Nom de l'utilisateur sous lequel fonctionne le processus
de copie. Cet utilisateur doit exister sur l'OS invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--passwordfile <fichier></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié d'où lire
l'invité donné. Si vous n'en donnez pas, on suppose un mot de
paasse vide.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--password <mot_de_passe></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié avec
<computeroutput>--username</computeroutput>. Si vous n'en
donnez pas, on suppose un mot de passe vide.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus bavard.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>createtemporary</computeroutput></emphasis>,
qui permet de copier des fichiers de l'hôte sur l'invité (seulement
si les suppléments invités 4.2 ou supérieur sont installés).</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> createtemp[orary]|mktemp
<modèle> --username <nom>
[--passwordfile <fichier> | --password <mot_de_passe>]
[--directory] [--secure] [--tmpdir <répertoire>]
[--domain <domaine>] [--mode <mode>] [--verbose]</screen>
<para>où les paramètres signifient :<glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>modèle</computeroutput></glossterm>
<glossdef>
<para>Un nom de fichier sans chemin et avec au moins trois
caractères 'X' consécutifs ou se terminant par 'X'.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--username <nom></computeroutput></glossterm>
<glossdef>
<para>Nom de l'utilisateur sous lequel devrait fonctionner
le processus de copie. Cet utilisateur doit exister sur l'OS
invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--passwordfile <fichier></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié, à lire dans
le fichier donné. Si vous n'en donnez pas, un mot de passe
vierge est supposé.</para> </glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--password <mot de passe></computeroutput></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié avec
<computeroutput>--username</computeroutput>. Si vous n'en
donnez pas, un mot de passe vierge est supposé.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--directory</computeroutput></glossterm>
<glossdef>
<para>Crée un répertoire temporaire au lieu d'un fichier.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--secure</computeroutput></glossterm>
<glossdef>
<para>
Création sécurisée. Le mode du fichier est
<computeroutput>0755</computeroutput>. Et l'opération
échouera si elle ne peut s'effectuer en sécurité.
</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--tmpdir <répertoire></computeroutput></glossterm>
<glossdef>
<para>
Répertoire où le fichier / répertoire sera cRéé.
Si vous n'en indiquez pas, répertoire temporaire spécifique
'à la plateforme est utilisé.
</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--mode <mode></computeroutput></glossterm>
<glossdef>
<para>Définit les droits du répertoire spécifié. Seules des
valeurs octales (comme
<computeroutput>0755</computeroutput>) sont supportées pour l'heure.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus verbeux.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>list</computeroutput></emphasis>,
qui présente plusieurs informations de contrôle de l'invité telles
que les sessions et les fichiers ouverts dans l'invité et les processus de l'invité.</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> list
<all|sessions|processes|files> [--verbose]</screen>
<para>où les paramètres signifient :<glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>all|sessions|processes|files</computeroutput></glossterm>
<glossdef>
<para>présenter les sessions dans l'invité, les processus de
l'invité, les fichiers dans l'invité ou toutes les informations disponibles.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus verbeux.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>process kill</computeroutput></emphasis>,
qui termine des processus de l'invité en particulier pour une session
de l'invité, à partir soit l'ID de la session, soit du nom de la
session.</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> process kill
--session-id <ID>
| --session-name <nom ou modèle>
[--verbose]
<PID> ... <PID n></screen>
<para>où les paramètres signifient : <glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--session-id</computeroutput></glossterm>
<glossdef>
<para>Spécifie la session de l'invité à utiliser par son ID.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--session-name</computeroutput></glossterm>
<glossdef>
<para>Spécifie la session de l'invité à utiliser par son nom.
Vous pouvez spécifier plusieurs sessions en spécifiant les jokers
* ou ?.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus verbeux.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput><PID> ... <PID n></computeroutput></glossterm>
<glossdef>
<para>Liste les identifiants des processus (PIDs) à terminer.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>[p[s]]kill</computeroutput></emphasis>,
qui termine des processus en particulier dans une session de l'invité,
à partir soit de l'ID de la session, soit de son nom.</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> process kill
--session-id <ID>
| --session-name <nom ou modèle>
[--verbose]
<PID> ... <PID n></screen>
<para>où les paramètres signifient : <glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--session-id</computeroutput></glossterm>
<glossdef>
<para>Spécifie la session de l'invité à utiliser par son ID.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--session-name</computeroutput></glossterm>
<glossdef>
<para>Spécifie la session de l'invité à utiliser par son nom. Vous
pouvez spécifier plusieurs sessions avec les jokers * ou ?.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus verbeux.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput><PID> ... <PID n></computeroutput></glossterm>
<glossdef>
<para>Liste les identifiants des processus (PIDs) à terminer.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>session close</computeroutput></emphasis>,
qui ferme des sessions spécifiques de l'invité à partir de l'ID de la
session ou de son nom.</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> session close
--session-id <ID>
| --session-name <nom ou extrait>
| --all
[--verbose]</screen>
<para>où les paramètres signifient : <glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--session-id</computeroutput></glossterm>
<glossdef>
<para>Ferme une session de ;'invité spécifiée par son ID.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--session-name</computeroutput></glossterm>
<glossdef>
<para>Ferme une session de ;'invité spécifiée par son nom. Vous
pouvez fermer plusieurs sessions grâce aux jokers * ou ?.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--all</computeroutput></glossterm>
<glossdef>
<para>Ferme toutes les sessions de l'invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus verbeux.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>stat</computeroutput></emphasis>, qui affiche l'état d'un
fichier ou d'un système de fichiers de l'invité.</para>
<screen>VBoxManage guestcontrol <nomvm>|<uuid> stat
<file>... --username <nom>
[--passwordfile <fichier> | --password <mot de passe>]
[--verbose]</screen>
<para>où les paramètres signifient : <glosslist>
<glossentry>
<glossterm>uuid|nomvm</glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>élément(s) de fichier à vérifier sur l'invité</glossterm>
<glossdef>
L'utilisateur spécifié doit avoir les droits adéquats d'accès
à/aux élément(s) fichier unique(s).</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>--username <nom></glossterm>
<glossdef>
<para>Nom de l'utilisateur sous lequel devrait s'exécuter le
processus de copie. L'utilisateur doit exister sur l'OS invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>--passwordfile <fichier></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié, à lire dans
le fichier donné. Si vous n'en donnez pas, un mot de passe
vierge est supposé.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>--password <mot de passe></glossterm>
<glossdef>
<para>Mot de passe du compte utilisateur spécifié avec
<computeroutput>--username</computeroutput>. Si vous n'en
donnez pas, un mot de passe vierge est supposé.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus verbeux.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>updateadditions</computeroutput></emphasis>, qui permet de
mettre à jour une version des suppléments invité installée sur l'invité
(sur les suppléments invité installés 4.0 et supérieur).</para>
<screen>VBoxManage guestcontrol <nomvm>|<uuid> updateadditions
[--source "<fichier des suppléments invité .ISO à utiliser>"] [--verbose]
[--wait-start] [-- [<argument1>] ... [<argumentN>]]</screen>
<para>où les paramètres signifient : <glosslist>
<glossentry>
<glossterm>uuid|nomvm</glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>--source "<fichier des suppléments invité .ISO à
utiliser>"</glossterm>
<glossdef>
<para>Chemin complet vers un autre fichier .ISO de suppléments
invité à utiliser pour mettre à jour les suppléments invité.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>--verbose</glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus verbeux.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>--wait-start</glossterm>
<glossdef>
<para>Démarre le processus normal de mise à jour et attend
jusqu'à ce que la mise à jour des suppléments invité soit
effectivement démarrée dans l'invité. Cela peut être nécessaire
du fait de l'interaction nécessaire avec l'OS invité pendant
la phase d'installation.</para>
<para>Si vous ne mettez pas ce drapeau, VBoxManage attendra
que toute la mise à jour des suppléments invité s'achève.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>[-- [<argument1s>] ... [<argumentNs>]]</glossterm>
<glossdef>
. <para>Arguments en ligne de commandes à utiliser avec l'installeur
des suppléments invité. Sert à ajouter des fonctions non
installées précédemment sur l'invité.</para>
<para>Vous devez entourer les arguments contenant des espaces
par des guillemets.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
<listitem>
<para><emphasis role="bold"><computeroutput>watch</computeroutput></emphasis>,
qui affiche un contrôle de l'activité actuelle de l'invité.</para>
<screen>VBoxManage guestcontrol <uuid|nomvm> watch
[--verbose]</screen>
<para>où les paramètres signifient : <glosslist>
<glossentry>
<glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
<glossdef>
<para>L'UUID ou le nom de la VM. Obligatoire.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm><computeroutput>--verbose</computeroutput></glossterm>
<glossdef>
<para>Dit à VBoxManage d'être plus verbeux.</para>
</glossdef>
</glossentry>
</glosslist></para>
</listitem>
</itemizedlist></para>
</sect1>
<sect1 id="vboxmanage-debugvm">
<title>VBoxManage debugvm</title>
<para>Les commandes "debugvm" sont pour les experts qui veulent jouer avec
les détails exacts de l'exécution d'une machine virtuelle. Comme le débogueur
de la VM décrit au <xref linkend="ts_debugger" />, ces commandes ne sont
utiles que si vous êtes très familier des détails l'architecture d'une VM et
de la façon de déboguer un logiciel.</para>
<para>Les sous-commandes de "debugvm" fonctionnent sur une machine virtuelle
en fonction. Celles suivantes sont disponibles :<itemizedlist>
<listitem>
<para>Avec <computeroutput>dumpguestcore --filename
<nom></computeroutput>, vous pouvez créer un fichier de renvoi
système de la VM en fonction, qui sera écrit dans le fichier donné.
Ce fichier aura un format ELF cœur standard (avec des sections
personnalisées) ; voir
<xref linkend="ts_guest-core-format" />.</para>
<para>Cela correspond à la commande
<computeroutput>writecore</computeroutput> du débogueur.
</para>
</listitem>
<listitem>
<para>La commande <computeroutput>info</computeroutput> est utilisée
pour afficher des éléments d'info liés à la VMM, aux émulations de
périphérique et aux pilotes associés. Cette commande prend un ou
deux arguments : le nom de l'élément d'info, éventuellement suivi
d'une chaîne contenant les arguments spécifiques à l'élément d'info.
L'élément d'info <computeroutput>help</computeroutput> fournit une liste
des éléments disponibles et des astuces sur les arguments supplémentaires.</para>
<para>Cela correspond à la commande <computeroutput>info</computeroutput>
du débogueur.</para>
</listitem>
<listitem>
<para>La commande <computeroutput>injectnmi</computeroutput> provoque
une interruption non masquable (<foreignphrase>non-maskable interrupt</foreignphrase>
(NMI) dans l'invité, qui pourrait être utile dans certains scénarios
de débogage. Ce qui se passe exactement dépend du système d'exploitation
invité mais une NMI peut planter tout le système d'exploitation invité.
Ne l'utilisez pas, sauf si vous savez ce que vous faites.</para>
</listitem>
<listitem>
<para>La commande <computeroutput>osdetect</computeroutput> lance
la fonction de (re)-détection du débogueur de VMM du système d'exploitation
de l'invité.</para>
<para>Cela correspond à la commande <computeroutput>detect</computeroutput>
du débogueur.</para>
</listitem>
<listitem>
<para>La commande <computeroutput>osinfo</computeroutput> est utilisée
pour afficher des infos sur le système d'exploitation (OS) détecté par
le débogueur de la VM.</para>
</listitem>
<listitem>
<para>La commande <computeroutput>getregisters</computeroutput> est
utilisée pour afficher le registre du processeur et des périphériques.
La commande prend une liste des registres, chacun ayant une des
formes suivantes :
<itemizedlist>
<listitem><computeroutput>nom-registre-processeur</computeroutput></listitem>
<listitem><computeroutput>all</computeroutput></listitem>
</itemizedlist>
La forme <computeroutput>all</computeroutput> affichera tous les
registres (pas les sous-champs). Les noms des registres sont indifférents
à la casse. Quand vous interrogez un registre du processeur, vous
pouvez ne pas mettre le réglage du registre, il sera sélectionné en
utilisant la valeur de l'option <computeroutput>--cpu</computeroutput>
(0 par défaut).
</para>
</listitem>
<listitem>
<para>La commande <computeroutput>setregisters</computeroutput> est
utilisée pour modifier les registres des périphériques et du processeur.
La commande prend une liste d'affectations de registres, chacune ayant
une des formes suivantes :
<itemizedlist>
<listitem><computeroutput>réglage-registre.nom-registre.sous-champ=valeur</computeroutput></listitem>
<listitem><computeroutput>nom-registre-processeur=valeur</computeroutput></listitem>
</itemizedlist>
Le format de la valeur devrait être du même genre que ce qu'affiche
<computeroutput>getregisters</computeroutput>, sauf qu'on peut utiliser
des octets et des décimales au lieu de l'hexadécimal. Le nommage du
registre et le réglage par défaut du registre processeur sont gérés
de la même manière qu'avec la commande
<computeroutput>getregisters</computeroutput>.</para>
</listitem>
<listitem>
<para>La commande <computeroutput>statistics</computeroutput> peut
être utilisée pour afficher des statistiques VMM sur la ligne de
commandes. L'option <computeroutput>--reset</computeroutput> réinitialisera
les statistiques. Les statistiques concernées sont filtrables avec l'option
<computeroutput>--pattern</computeroutput> qui accepte des jokers en style
<computeroutput>*</computeroutput>).</para>
</listitem>
</itemizedlist></para>
</sect1>
<sect1 id="metrics">
<title>VBoxManage metrics</title>
<para>Cette commande supporte la surveillance de l'utilisation des ressources
système. Les ressources sont représentées par différents métriques associés
au système hôte ou à une VM en particulier. Par exemple, le système hôte a
pourcentage du temps procceseur passé à tourner en mode utilisateur sur une
période spécifique.</para>
<para>Les données de métrique sont rassemblées et stockées en interne ;
vous pouvez les récupérer n'importe quand avec la sous-commande
<computeroutput>VBoxManage metric query</computeroutput>. Les données sont
disponibles tant que le processus en tâche de fond
<computeroutput>VBoxSVC</computeroutput> est vivant. Ce processus
ce termine peu après que toutes les VMs et les interfaces ont été fermées.</para>
<para>Par défaut, aucun métrique n'est enregistré. La récupération de
métriques ne commence pas avant que <computeroutput>VBoxManage metrics setup</computeroutput>
ne soit appelé avec un bon intervalle modèle et que le nombre de métriques
n'ait été conservé. On mesure l'intervalle en secondes. Par exemple, pour
activer la récupération des métriques de l'utilisation du processeur et de
la mémoire hôte toutes les secondes, en gardant les 5 échantillons les plus
actuels, vous pouvez utiliser la commande suivante :</para>
<para>Le recueil de métriques ne peut être activé que sur des VMs démarrées.
Les données et les paramètres de récupération d'une VM en particulier disparaîtront
dès que vous éteindrez la VM. Utilisez la sous-commande
<computeroutput>VBoxManage metrics list
</computeroutput> pour voir les métriques actuellement disponibles. Vous
pouvez aussi utiliser l'option <computeroutput>--list</computeroutput> avec
une sous-commande modifiant les paramètres de métrique pour chercher les
métriques concernés.</para>
<para>Remarquez que la sous-commande <computeroutput>VBoxManage metrics
setup</computeroutput> désactive tous les échantillons qui peuvent avoir été
recueillis pour un jeu d'objets et de métriques spécifiques.</para>
<para>Pour activer ou désactiver la récupération des métriques sans perdre
les données, vous pouvez utiliser les sous-commandes
<computeroutput>VBoxManage metrics enable</computeroutput> et
<computeroutput>VBoxManage metrics disable</computeroutput>. Remarquez que
ces sous-commandes attendent en paramètres des métriques, pas des sous-métriques,
n'est pas supporté.</para>
<para>L'hôte et les VMs ont différents ensembles de métriques associés.
Vous pouvez lister les métriques disponibles avec
<computeroutput>VBoxManage metrics
list</computeroutput> subcommand.</para>
<para>Un nom de métrique complet peut inclure une fonction d'agrégat. Le
nom prend la forme suivante :
<computeroutput>Catégorie/Métrique[/SousMétrique][:aggrégé]</computeroutput>.
quantité minimum de mémoire disponible parmi toutes les données en mémoire
, si c'est appliqué à l'objet hôte.</para>
<para>Les sous-commandes peuvent s'appliquer à tous les objets et les
ne donnez aucun objet ni métrique en paramètres, les sous-commandes s'appliqueront
à tous les métriques disponibles de tous les objets. Vous pouvez utiliser
un astérisque ("<computeroutput>*</computeroutput>") pour spécifier explicitement
que la commande devrait s'appliquer à tous les objets ou à tous les métriques.
Utilisez "host" en nom d'objet pour limiter la cible de la commande aux
métriques relatifs à l'hôte. Pour limiter la cible à un sous-ensemble de métriques,
utilisez une liste de noms séparés par des virgules.</para>
<para>Par exemple, pour interroger les données de métriques sur le temps
passé par le processeur en modes utilisateur et noyau, sur la machine virtuelle
nommée "test", vous pouvez utiliser la commande suivante :</para>
<para>La liste suivante résume les sous-commandes disponibles :</para>
<glosslist>
<glossentry>
<glossterm>list</glossterm>
<glossdef>
<para>Cette sous-commande affiche les paramètres des métriques
existant actuellement. Remarquez que les métriques spécifiques à la VM
ne sont disponibles que quand une VM en particulier
est en fonction.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>setup</glossterm>
<glossdef>
<para>Cette sous-commande définit l'intervalle entre deux prises
d'échantillons des données de métriques et le nombre d'échantillons gardés
en interne. Les données mémorisées sont disponibles en affichage avec
la sous-commande <code>query</code>. L'option <computeroutput>--list
</computeroutput> affiche les métriques qui ont été modifiés dans le
résultat de l'exécution de la commande.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>enable</glossterm>
<glossdef>
<para>Cette sous-commande "réactive le recueil de données après qu'il
ait été arrêté avec la sous-commande <code>disable</code>. Remarquez que
la spécification de sous-métriques comme paramètres n'activera pas les
métriques sous-jacents. Utilisez
<computeroutput>--list</computeroutput> pour savoir si la commande a
fait ce que vous aviez prévu.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>disable</glossterm>
<glossdef>
<para>Cette sous-commande "suspend" le recueil des données sans
changer les paramètres de récupération ni altérer les données recueillies.
Remarquez que la spécification de sous-métriques en paramètres ne
désactivera pas les métriques sous-jacents. Utilisez
<computeroutput>--list</computeroutput> pour voir si la commande a fait
ce que vous aviez prévu.</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>query</glossterm>
<glossdef>
<para>Cette sous-commande récupère et affiche les données de métriques
mémorisés.<note>
<para>La sous-commande <code>query</code> ne supprime
pas ni ne remet à 0 les données mémorisées. Si vous interrogez
assez souvent, vous verrez la vitesse d'évacuation graduelle des
anciens échantillons par les nouveaux.</para>
</note></para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>collect</glossterm>
<glossdef>
<para>Cette sous-commande définit l'intervalle entre la prise de deux
échantillons de données de métrique et le nombre d'échantillons mémorisés
en interne. Les données recueillies s'affichent périodiquement jusqu'à
ce que vous appuyiez sur Ctrl-C, sauf si vous spécifiez l'option
<computeroutput>--detach</computeroutput>. Avec l'option
<computeroutput>--detach</computeroutput>, cette sous-commande agit de
la même façon que <code>setup</code>. L'option <computeroutput>--list</computeroutput>
affiche les métriques correspondant au filtre spécifié.</para>
</glossdef>
</glossentry>
</glosslist>
</sect1>
<sect1>
<title>VBoxManage hostonlyif</title>
<para>Avec "hostonlyif", vous pouvez changer la configuration de l'IP d'une
interface réseau host-only. Pour une description du réseau host-only, merci
de vous reporter au <xref linkend="network_hostonly" />. Chaque interface
host-only est identifiée par un nom et peut soit utiliser le serveur DHCP interne, soit
voir son adresse IP configurée à la main (IP4 et IP6).</para>
</sect1>
<sect1 id="vboxmanage-dhcpserver">
<title>VBoxManage dhcpserver</title>
<para>Les commandes de "dhcpserver" vous permettent de contrôler le serveur
DHCP construit dans VirtualBox. Vous pourriez trouver cela utile si vous
utilisez le réseau interne ou host-only. (En théorie, vous pouvez
l'activer aussi pour un réseau bridgé, mais cela provoquera probablement des
conflits avec d'autres serveurs DHCP de votre réseau physique.)</para>
<para>Utilisez les options suivantes de la ligne de commandes :<itemizedlist>
<listitem>
<para>Si vous utilisez le réseau interne pour l'adaptateur réseau
virtuel d'une machine virtuelle, utilisez <computeroutput>VBoxManage dhcpserver add
--netname <nom_réseau></computeroutput>, où
<computeroutput><nom_réseau></computeroutput> est le même nom
de réseau que celui que vous avez utilisé avec
<computeroutput>VBoxManage modifyvm
<nomvm> --intnet<X>
<nom_réseau></computeroutput>.</para>
</listitem>
<listitem>
<para>Si vous utilisez le réseau interne pour l'adaptateur réseau
virtuel d'une machine virtuelle, utilisez plutôt <computeroutput>VBoxManage dhcpserver add
--ifname <hostonly_if_name></computeroutput>, où
<computeroutput><hostonly_if_name></computeroutput> est le même
nom de l'interface host-only que vous avez utilisé avec
<computeroutput>VBoxManage modifyvm <nomvm>
--hostonlyadapter<X>
<hostonly_if_name></computeroutput>.</para>
<para>Vous pouvez aussi utiliser l'option --netname comme avec les
réseaux internes si vous connaissez le nom du réseau host-only ;
vous pouvez voir les noms avecc <computeroutput>VBoxManage list
hostonlyifs</computeroutput> (voir <xref linkend="vboxmanage-list" />
ci-dessus).</para>
</listitem>
</itemizedlist></para>
<para>Les paramètres suivants supplémentaires sont requis quand vous ajoutez
un serveur DHCP pour la première fois :<itemizedlist>
<listitem>
<para>Avec <computeroutput>--ip</computeroutput>, spécifiez l'adresse
IP du serveur DHCP lui-même.</para>
</listitem>
<listitem>
<para>Avec <computeroutput>--netmask</computeroutput>, spécifiez
le masque du réseau.</para>
</listitem>
<listitem>
<para>Avec <computeroutput>--lowerip</computeroutput> et
<computeroutput>--upperip</computeroutput>, vous pouvez spécifier
respectivement l'adresse la plus basse et la plus haute que le serveur
DHCP attribuera aux clients.</para>
</listitem>
</itemizedlist></para>
<para>Enfin, vous devez spécifier<computeroutput>--enable</computeroutput>,
sinon le serveur DHCP sera créé en étant désactivé, ce qui ne fera rien.</para>
<para>Après cela, VirtualBox démarrera automatiquement le serveu DHCP pour
le réseau donné, interne ou host-only, dès que la première machine virtuelle utilisant
ce réseau sera démarrée.</para>
<para>Inversement, utilisez <computeroutput>VBoxManage dhcpserver
remove</computeroutput> avec <computeroutput>--netname
<nom_réseau></computeroutput> ou <computeroutput>--ifname
<hostonly_if_name></computeroutput> pour supprimer le serveur DHCP,
de nouveau pour le réseau interne ou host-only donné.</para>
<para>Pour modifier les paramètres d'un serveurDHCP créé précédemment avec
<computeroutput>VBoxManage dhcpserver add</computeroutput>, vous pouvez
utiliser
<computeroutput>VBoxManage dhcpserver modify</computeroutput> pour une
interface réseau interne ou host-only donnée.</para>
</sect1>
<sect1 id="vboxmanage-extpack">
<title>VBoxManage extpack</title>
<para>La commande "extpack" vous permet d'ajouter ou de supprimer des packs
d'extension de VirtualBox comme décrit au <xref
linkend="intro-installing" />.<itemizedlist>
<listitem>
<para>Pour ajouter un nouveau pack d'extension, utilisez <computeroutput>VBoxManage
extpack install <.vbox-extpack></computeroutput>. Cette commande
échouera si une version plus ancienne du même pack d'extension est
déjà installée. Vous pouvez utiliser le paramètre optionnel
<computeroutput>--replace</computeroutput> pour désinstaller l'ancien
paquet avant d'installer le nouveau paquet..</para>
</listitem>
<listitem>
<para>Pour supprimer un pack d'extension précédemment installé, utilisez
<computeroutput>VBoxManage extpack uninstall
<nom></computeroutput>. Vous pouvez utiliser
<computeroutput>VBoxManage list extpacks</computeroutput> pour
afficher les noms des pack d'extensions actuellement installés ;
merci de voir aussi <xref linkend="vboxmanage-list" />. Vous pouvez
utiliser le paramètre optionnel <computeroutput>--force</computeroutput>
pour surpasser le refus de se désinstaller d'un pack d'extension.</para>
</listitem>
<listitem>
<para>La commande <computeroutput>VBoxManage extpack
cleanup</computeroutput> peut être utilisée pour supprimer temporairement
les fichiers et les répertoires qui peuvent avoir été laissés après
l'échec d'une précédente commande d'installation ou de désinstallation.</para>
</listitem>
</itemizedlist></para>
<para>Les commandes suivantes montrent des exemples d'une liste des packs
d'extension et de la manière d'en supprimer un :<screen>
$ VBoxManage list extpacks
pack d'extensions: 1
Pack no. 0: Oracle VM VirtualBox pack d'extension
Version: 4.1.12
Revision: 77218
Edition:
Description: USB 2.0 Host Controller, VirtualBox RDP, PXE ROM with E1000 support.
VRDE Module: VBoxVRDP
Usable: true
Why unusable:
$ VBoxManage extpack uninstall "Oracle VM VirtualBox pack d'extension"
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%
Successfully uninstalled "Oracle VM VirtualBox pack d'extension".</screen></para>
</sect1>
</chapter>