[vbox-dev] Updated translation
Jean-Philippe MENGUAL
mengualjeanphi at free.fr
Wed Feb 27 22:06:00 GMT 2013
Hi,
Here's a patch to update the French translation according to the English latest
changes.
Best regards,
JPM
-------------- next part --------------
Index: doc/manual/fr_FR/user_VBoxManage.xml
===================================================================
--- doc/manual/fr_FR/user_VBoxManage.xml (r?vision 44845)
+++ doc/manual/fr_FR/user_VBoxManage.xml (copie de travail)
@@ -3656,3 +3656,3663 @@
Successfully uninstalled "Oracle VM VirtualBox pack d'extension".</screen></para>
</sect1>
</chapter>
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<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
+Settings file: '/home/nomutilisateur/.config/VirtualBox/Machines/SUSE 10.2/SUSE 10.2.xml'
+</screen>
+
+ <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 "512MB"</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??cifiie
+ 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'initateur 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 aavec 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 fondations
+ de disque virtuel connues 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 machinc( 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
+Guest OS: Other/Unknown
+UUID: 1bf3464d-57c6-4d49-92a9-a5cc3816b7e7
+Config file: /home/nomutilisateur/.config/VirtualBox/Machines/Windows XP/Windows XP.xml
+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
+Hardw. virt.ext exclusive: 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
+IDE Controller (0, 0): /home/user/windows.vdi (UUID: 46f6e53a-4557-460a-9b95-68b0f17d744b)
+IDE Controller (0, 1): /home/user/openbsd-cd46.iso (UUID: 4335e162-59d3-4512-91d5-b63e94eebe0b)
+Floppy Controller 1 (0, 0): /home/user/floppy.img (UUID: 62ac6ccb-df36-42f2-972e-22f836368137)
+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 s'il y en
+ a (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>
+ <title id="vboxmanage-createvm">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
+ du dossier <computeroutput>.config/VirtualBox/Machines</computeroutput>), il doit
+ 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
+ les tables m??moire (DMI/SMBIOS), les propri??t??s mat??rielles
+ 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>--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>--pae on|off</computeroutput> : Ceci active/d??sactive
+ la PAE (voir <xref
+ linkend="settings-processor" />).</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>--hwvirtexexcl on|off</computeroutput> :
+ Ceci sp??cifie si VirtualBox utilisera exclusivement les extensions de
+ virtualisation mat??rielle (Intel VT-x ou AMD-V) dans le processeur de
+ votre syst??me h??te ; voir <xref linkend="hwvirt" />. Si vous
+ souhaitez partager en m??me temps ces extensions avec d'autres
+ hyperviseurs, vous devez d??sactiver ce param??tre. Ceci a des implications
+ n??gatives en performance.</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 see <xref linkend="hwvirt" />.</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>, you pouvez d??terminer si le logo devrait
+ fade in and out.</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 szst??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>
+ </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
+ internal (<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), utilisez
+ cette option sp??cifier l'interface r??seau host-only qu'utilisera
+ l'interface r??seau 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??e 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 fondations r??seaux rarement utilis??es.</para><para>
+ Ces param??tres sont des fondations sp??cifiques au moteur et sont
+ diff??rentes entre les pilotes de la foncation du tunnel UDP et du
+ 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??cimale 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" /> and <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 faire du proxy au
+ moteur NAT pour toutes les requ??tes DNS de l'invit?? adress??es 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 utiliser par le
+ moteur NAT 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>--natnatsettings<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>Options du port s??rie, du son, du presse-papier, du bureau distant
+ et de l'USB</title>
+
+ <para>Les autres param??tres mat??riels suivants 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 ??
+ <computeroutput>/dev/ttyS0</computeroutput>. Cela vous permet
+ 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?? doit ??tre partag?? avec l'h??te ; voir
+ <xref linkend="generalsettings" />. 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-monitoeurs ;
+ 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>
+ <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
+ deports 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 de 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, leserveur
+ n'acceptra les connexions que sur l'interface de l'h??te sp??cifi??e.</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 n'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>
+ peut ??tre n'importe quel num??ro de port TCP/IP libre (comme 6000) ;
+ <computeroutput><adresse></computeroutput> peut ??tre n'importe
+ quelle adresse IP ou nom d'h??te et il sp??cifie une socket TCP/IP
+ ?? 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>. Cel pourrait aider les applications
+ se comportant mal ?? cause d'un mauvais pr??suppos?? sur la pr??sence de
+ certaines capacit??s du processeur. La signification des param??tres
+ d??pend do 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 reporte 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??s 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,
+ target path=/home/user/disks/WindowsXp.vmdk, controller=9;channel=0
+ (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>
+ </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>
+
+ <note>
+ <para>Elle n'est offerte que pour des raisons de r??tro-compatibilit??. Nous
+ vous recommandons de d??marrer les machines virtuelles directement via les
+ interfaces choisies car vous pourriez sans cela manquer des messages d'erreur
+ et des informations d'??tat importantes que peut afficher
+ VirtualBox en console. C'est surtout important pour les autres interfaces que
+ <computeroutput>VirtualBox</computeroutput>, notre interface graphique, car
+ ils ne peuvent pas afficher des messages d'erreur dans une fen??tre popup.
+ Voir<xref linkend="vboxheadless" /> pour plus d'informations.</para>
+ </note>
+
+ <para>Le param??tre facultatif <computeroutput>--type</computeroutput>
+ d??termine si la machine sera d??marr??e dans une fen??tre (mode graphique,
+ qui est celui par d??faut) ou 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, il n'est pas garanti que tous les types sont
+ accept??s par la variante d'un produit.</para>
+
+ <para>Les valeurs suivantes sont autoris??es :</para>
+
+ <glosslist>
+ <glossentry>
+ <glossterm>gui</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>headless</glossterm>
+
+ <glossdef>
+ <para>D??marre une VM sans fen??tre pour un affichage distant.</para>
+ </glossdef>
+ </glossentry>
+ </glosslist>
+ </sect1>
+
+ <sect1 id="vboxmanage-controlvm">
+ <title>VBoxManage controlvm</title>
+
+ <para>La sous-commande <computeroutput>controlvm</computeroutput> vous permet
+ modifier l'??tat d'une machine virtuelle en fonction. Vous pouvez sp??cifiar
+ 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 "Sauveegard??". ?? 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><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>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 fonctionner pas pour tous
+ les syst??mes invit??s.</para>
+ </listitem>
+
+ <listitem>
+ <para><computeroutput>screenshotpng</computeroutput> prend une impression
+ ??cran de l'affichage invit?? et le 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>L'op??ration <computeroutput>guestmemoryballoon</computeroutput>
+ modifie la taille du ballon de la m??moire de l'invit??, c'est-??-dire la
+ m??moire affect??e par les suppl??ments invit?? de VirtualBox au syst??me
+ d'exploitation invit?? et rendue ?? l'hyperviseur pour ??tre r??utilis??e
+ par d'autres machines virtuelles. Elle doit ??tre sp??cifi??e en m??gaoctets.
+ Pour des d??tails, voir <xref linkend="guestadd-balloon" />.</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 devrieu 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 instantn?? a ??t?? pris,
+ VirtualBox cre un disque dur de diff??renciatin 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
+ reabandonnant 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.</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 ?? 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>
+ <title id="vboxmanage-storageattach">VBoxManage storageattach</title>
+
+ <para>Cette commande attache/modifie/supprime un m??dia de stockage connect??
+ ?? un contr??leur de stockage pr??c??demment ajout?? avec la commande
+ <computeroutput>storagectl</computeroutput> command (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>uuid|nomvm</glossterm>
+
+ <glossdef>
+ <para>Le nom ou l'UUID de la VM. Obligatoire.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>storagectl</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 car 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
+ les m??dias amovibles (disquettes ou CDs/DVDs), peuvent prendre effet
+ 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 pour avoir l'??jection du m??dia synchrnmi??e avec 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
+ de force le DVD/CD/disquette ou monte un nouveau DVD/CD/disquette
+ 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 --
+ see <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>
+ <para>Num??ro de port TCP/IP du service iSCSI sur la cible (facultatif).</para>
+ </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 vous le sp??cifiez, 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>
+
+ <para>Cette commande attache/modifie/supprime un contr??leur de stockage.
+ 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>
+ [--add <ide/sata/scsi/floppy>]
+ [--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>
+
+ <para>Cette commande cr??e/efface/modifie/affiche les groupes de bande
+ 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
+ dande passante d'un type don??.</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 <filename>
+ --size <m??gaoctet>
+ [--format VDI|VMDK|VHD] (par d??faut : VDI)
+ [--variant Standard,Fixed,Split2G,Stream,ESX]</screen>
+
+ <para>o?? les param??tres signifient :<glosslist>
+ <glossentry>
+ <glossterm>filename</glossterm>
+
+ <glossdef>
+ <para>Permet de choisir un nom de fichier. Obligatoire.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>size</glossterm>
+
+ <glossdef>
+ <para>Permet de d??finir la capacit?? de l'image, en MiO.
+ Obligatoire.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>format</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>variant</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
+ <code>zerofree</code> qui supporte les syst??mes de fichiers s ext2/ext3.
+ Pour les invit??s Mac OS X, utilisez utilisez la fonction <emphasis>Supprimer l'espace libre</emphasis> de
+ <emphasis>l'outil de disque</emphasis> int??gr??. Utilisez-y
+ <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 physiqu.<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 variantse, ?? 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 mait 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>format</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>variant</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>existing</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>octets</glossterm>
+
+ <glossdef>
+ <para>La taille du fichier image, en octets, fournie en entr??e.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>format</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>variant</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>uuid</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>
+ <title>VBoxManage getextradata/setextradata</title>
+
+ <para>Ces commandes vous permet 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
+ the 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>To remove a key, the <computeroutput>setextradata</computeroutput>
+ command must be run without specifying data (only the key), for example:
+ </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'entr 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>machinefolder</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>vrdeauthlibrary</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>websrvauthlibrary</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>vrdelibrary</glossterm>
+
+ <glossdef>
+ <para>Ceci sp??cifie la biblioth??que qui impl??mente l'extension Bureau
+ distant de VirtualBox.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>hwvirtexenabled</glossterm>
+
+ <glossdef>
+ <para>Ceci s??lectionne l'activation du support de la virtualisation
+ mat??rielle par d??faut.</para>
+ </glossdef>
+ </glossentry>
+ </glosslist></para>
+ </sect1>
+
+ <sect1>
+ <title>VBoxManage usbfilter add/modify/remove</title>
+
+ <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 laliste.
+ 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">
+ <title>VBoxManage sharedfolder add/remove</title>
+
+ <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
+ fonctionnaalit??.</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 pouq 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
+ sera effac??e d??s que la VM red??marrera et/ou existera ;</para>
+ </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 "guestcontrol" 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 <commande></screen>
+
+ <para>Les sous-commandes suivantes sont disponibles (o??
+ <computeroutput><vm></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><computeroutput>execute</computeroutput>, qui permet d'ex??cuter un
+ programme/script (processus) d??j?? install?? et ex??cutable sur l'invit??.
+ Cette commande ne fonctionne que pendant qu'une VM est active et en
+ fonction et sa syntaxe est la suivante :</para>
+
+ <screen>VBoxManage guestcontrol <nomvm>|<uuid> 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>uuid|nomvm</glossterm>
+
+ <glossdef>
+ <para>Le nom ou l'UUID de la VM. Obligatoire.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--image "<chemin du programme>"</glossterm>
+
+ <glossdef>
+ <para>Chemin absolu et nom du processus ?? ex??cuter dans
+ l'invit??, comme <computeroutput>C:\Windows\System32\calc.exe</computeroutput></para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--username <nom></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>--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>--dos2unix</glossterm>
+
+ <glossdef>
+ Convertit les fins de lignes de la sortie des invit??s DOS/Windows
+ en fins compatibles UNIX (CR + LF -> LF). Pas encore impl??ment??.
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--environment
+ "<NAME>=<VALUE>"</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
+ option permet de modifier cet environnement. Pour d??finir/modifier
+ une variable, une paire <computeroutput>NOM=VALEUR</computeroutput> doit
+ ??tre sp??cifi??e ; pour d??r??gler 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>--timeout <msec></glossterm>
+
+ <glossdef>
+ <para>Valeur (ien millisecondes) qui sp??cifie la dur??e pendant
+ laquelle le processus d??marr?? est autoris?? ?? fonctionner et
+ combien de temps VBoxManage attent 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>--unix2dos</glossterm>
+
+ <glossdef>
+ Convertit les fins de lignes de la sortie des invit??s DOS/Windows
+ en fins compatibles UNIX (CR + LF -> LF). Pas encore impl??ment??.
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--verbose</glossterm>
+
+ <glossdef>
+ <para>Dit ?? VBoxManage d'??tre plus verbeux.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--wait-exit</glossterm>
+
+ <glossdef>
+ <para>Attend la fin d'un processus et affiche son code de
+ sortie avec la raison/les drapeaux de sa fin.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--wait-stdout</glossterm>
+
+ <glossdef>
+ <para>Attend la fin d'un processus et affiche son code de
+ sortie avec la raison/les drapeaux de sa fin. En attendant,
+ VBoxManage r??cup??re la sortie du processus sur stdout.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--wait-stderr</glossterm>
+
+ <glossdef>
+ <para>Attend la fin d'un processus et affiche son code de
+ sortie avec la raison/les drapeaux de sa fin. En attendant,
+ VBoxManage r??cup??re la sortie du processus sur stderr.</para> </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>[-- [<argument1s>] ... [<argumentNs>]]</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>
+ </note> Exemples : <screen>VBoxManage --nologo guestcontrol "Ma VM" execute --image "/bin/ls"
+ --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><computeroutput>copyto</computeroutput>, 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 <nomvm>|<uuid> 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>uuid|nomvm</glossterm>
+
+ <glossdef>
+ <para>L'UUID ou le nom de la VM. Obligatoire.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>source sur l'h??te</glossterm>
+
+ <glossdef>
+ <para>Chemin absolu du/des fichier(s) source(s) de l'h??te
+ sur l'h??te pour copier vers l'invit??, comme
+ <computeroutput>C:\Windows\System32\calc.exe</computeroutput>.
+ Il peut s'agir d'une expression joker, comme
+ <computeroutput>C:\Windows\System32\*.dll</computeroutput></para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>destination sur l'invit??</glossterm>
+
+ <glossdef>
+ <para>Chemin de destination absolu sur l'invit??, comme
+ <computeroutput>C:\Temp</computeroutput></para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--username <nom></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>--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 depasse></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>--dryrun</glossterm>
+
+ <glossdef>
+ <para>Dit ?? VBoxManage de ne faire qu'une ex??cution dry au
+ lieu de copier vraiment les fichiers dans l'invit??.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--follow</glossterm>
+
+ <glossdef>
+ <para>Active le suivi des liens symboliques sur la
+ source de l'h??te.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--recursive</glossterm>
+
+ <glossdef>
+ <para>Copie r??cursivement les fichiers/r??pertoires de la
+ source sp??cifi??e.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--verbose</glossterm>
+
+ <glossdef>
+ <para>Dit ?? VBoxManage d'??tre plus verbeux.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>--flags <drapeaux></glossterm>
+
+ <glossdef>
+ <para>Drapeaux suppl??mentaires ?? d??finir. Ce n'est pas utilis??
+ pour le moment.</para>
+ </glossdef>
+ </glossentry>
+ </glosslist></para>
+ </listitem>
+
+ <listitem>
+ <para><computeroutput>copyfrom</computeroutput>, 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><computeroutput>createdirectory</computeroutput>, 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 <nomvm>|<uuid> 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>uuid|nomvm</glossterm>
+
+ <glossdef>
+ <para>L'UUID ou le nom de la VM. Obligatoire.</para>
+ </glossdef>
+ </glossentry>
+
+ <glossentry>
+ <glossterm>r??pertoire ?? cr??er sur l'invit??</glossterm>
+
+ <glossdef>
+ <para>Chemin absolu du/des r??pertoire(s) ?? cr??er sur l'invit??,
+ 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>--username <nom></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>--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>--parents</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>--mode <mode></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>--verbose</glossterm>
+
+ <glossdef>
+ <para>Dit ?? VBoxManage d'??tre plus verbeux.</para>
+ </glossdef>
+ </glossentry>
+ </glosslist></para>
+ </listitem>
+
+ <listitem>
+ <para><computeroutput>stat</computeroutput>, qui affiche l'??tat d'un
+ fichier ou d'un gestionnaire 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>
+ <para>Chemin absolu du/des r??pertoire(s) ?? v??rifier sur l'invit??,
+ comme <computeroutput>/home/foo/a.out</computeroutput>.
+ 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>--verbose</glossterm>
+
+ <glossdef>
+ <para>Dit ?? VBoxManage d'??tre plus verbeux.</para>
+ </glossdef>
+ </glossentry>
+ </glosslist></para>
+ </listitem>
+
+ <listitem>
+ <para><computeroutput>updateadditions</computeroutput>, 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]</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>
+ </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>r??glage-registre.nom-registre.sous-champ</computeroutput></listitem>
+ <listitem><computeroutput>r??glage-registre.nom-registre</computeroutput></listitem>
+ <listitem><computeroutput>nom-registre-processeur.sous-champ</computeroutput></listitem>
+ <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??2ant).
+ </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>r??glage-registre.nom-registre=valeur</computeroutput></listitem>
+ <listitem><computeroutput>nom-registre-processeur.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
+ DOS/NT (<computeroutput>?</computeroutput> et
+ <computeroutput>*</computeroutput>).</para>
+ </listitem>
+ </itemizedlist></para>
+ </sect1>
+
+ <sect1>
+ <title id="metrics">VBoxManage metrics</title>
+
+ <para>Cette commande supporte la surveillance de l'utilisation des ressources
+ syst??me. Les ressources sont repr??sent??es par diff??rentes m??triques associ??es
+ au syst??me h??te ou ?? une VM en particulier. Par exemple, le syst??me h??te a
+ une m??trique <computeroutput>CPU/Load/User</computeroutput> qui affiche le
+ pourcentage du temps procc!eur 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> process is 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, aucune m??trique n'est enregistr??e. 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'a ??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>
+
+ <screen>VBoxManage metrics setup --period 1 --samples 5 host CPU/Load,RAM/Usage</screen>
+
+ <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??es.</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??cifique.</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,
+ comme <code>CPU/Load</code> ou <code>RAM/Usage</code>. En d'autres termes,
+ l'activation de <code>CPU/Load/User</code> tout en d??sactivant <code>CPU/Load/Kernel</code>
+ n'est pas support??.</para>
+
+ <para>L'h??te et les VMs ont diff??rents ensembles de m??triques associ??es.
+ 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>.
+ Par exemple, <computeroutput>RAM/Usage/Free:min</computeroutput> signifie la
+ quantit?? minimum de m??moire disponible parmi toutes les donn??es en m??moire
+ s, cela s'applique ?? l'objet h??te.</para>
+
+ <para>Les sous-commandes peuvent s'appliquer ?? tous les objets et les
+ m??triques ou se limiter ?? un objet et/ou une liste de m??triques. Si vous
+ ne donnez aucun objet ni m??trique en param??tres, les sous-commandes s'appliqueront
+ ?? toutes les m??triques disponibles de tous les objets. Vous pouvez utiliser
+ une ast??risque ("<computeroutput>*</computeroutput>") pour sp??cifier explicitement
+ que la commande devrait s'appliquer ?? tous les objets ou ?? toutes les m??triques.
+ Utilisez "host" en nom d'objet pour limiter la cible de la commande aux
+ m??triques relatives ?? 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>
+
+ <screen>VBoxManage metrics query test CPU/Load/User,CPU/Load/Kernel</screen>
+
+ <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??es 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
+ a ??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-jacentes. 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 "suspends" 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-jacentes. 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??es.<note>
+ <para>La sous-commande <code>query</code> subcommand ne supprime
+ pas ni ne remet ?? 0 les donn??es m??moris??es. Si vous interrogez
+ assez souvent, vous verrez la dur??e d'??vacuation graduelle des
+ ??chantillons par les nouveaux ??chantillons.</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 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??seu 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> aet
+ <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 ??tat d??sactiv??, ce qui ne fera rien.</para>
+
+ <para>Apr??s cela, VirtualBox d??marrera automatiquement le serveu DHCP pour
+ le r??seau nterne ou host-only donn?? 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> tpour
+ 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>
More information about the vbox-dev
mailing list