<?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)&#xA0;;</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>&#xA0;: 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&#xA0;:</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&#xA0;:<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&#xA0;:<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&#xA0;; 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&#xA0;:</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&#xA0;:</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>&#xA0;; 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&#xA0;:
        <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>&#xA0;; 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&#xA0;:<itemizedlist>
            <listitem>
              <para>Pour démarrer une VM éteinte, utilisez
              <computeroutput>VBoxManage startvm</computeroutput>&#xA0;; 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>&#xA0;; 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&#xA0;; 
    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>&#xA0;: affiche la 
          version de cet outil et quitte.</para>
        </listitem>
        <listitem>
          <para><computeroutput>--nologo</computeroutput>&#xA0;: supprime l'affichage
            des informations de logo (utile pour les scripts)</para>
        </listitem>
        <listitem>
          <para><computeroutput>--settingspw</computeroutput>&#xA0;: spécifiie
          un mot de passe pour les paramètres</para>
        </listitem>
        <listitem>
          <para><computeroutput>--settingspwfile</computeroutput>&#xA0;: 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>&#xA0;: <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&#xA0;;
          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&#xA0;; 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&#xA0;; 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&#xA0;:</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
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:
&lt;none&gt;

Shared folders:
&lt;none&gt;

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&#xA0;:<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&#xA0;;</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)&#xA0;;</para>
        </listitem>

        <listitem>
          <para>le fichier XML de la machine et ses sauvegardes&#xA0;;</para>
        </listitem>

        <listitem>
          <para>les fichiers journaux de la machine s'il y en a&#xA0;;</para>
        </listitem>

        <listitem>
          <para>le répertoire de la machine s'il est vide après l'effacement de
          tout ce qui précède.</para>
        </listitem>
      </orderedlist></para>
  </sect1>

  <sect1 id="vboxmanage-createvm">
    <title>VBoxManage createvm</title>

    <para>Cette commande crée un nouveau fichier de définition de machine virtuelle 
    XML.</para>

    <para>Le paramètre <computeroutput>--name &lt;name&gt;</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
    &lt;path&gt;</computeroutput>, le dossier de la machine sera appelé
    <computeroutput>&lt;path&gt;</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&#xA0;;
    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&#xA0;;
    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>&#xA0;:<itemizedlist>
          <listitem>
            <para><computeroutput>--name &lt;nom&gt;</computeroutput>&#xA0;: 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 &lt;ostype&gt;</computeroutput>&#xA0;:
            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
            &lt;taillemémoire&gt;</computeroutput>&#xA0;: 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 &lt;taillevram&gt;</computeroutput>&#xA0;:
            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>&#xA0;;
            <computeroutput>--ioapic on|off</computeroutput>&#xA0;: Ces deux éléments
            déterminent si la VM devrait supporter respectivement l'ACPI et 
            l'APIC I/O&#xA0;; voir <xref linkend="settings-motherboard" /> pour
            des détails.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--hardwareuuid
            &lt;uuid&gt;</computeroutput>&#xA0;: 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 &lt;nombreprocesseur&gt;</computeroutput>&#xA0;:
            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>&#xA0;: 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>&#xA0;: 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
            &lt;id&gt;</computeroutput>&#xA0;: 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>&lt;id&gt;</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
            &lt;1-100&gt;</computeroutput>&#xA0;: Ce paramètre contrôle le nombre
            de temps processeur utilisable par un processeur. La valeur 50 implique
            qu'un seul processeur virtuel peut utiliser jusqu'à 50% d'un seul
            processeur de l'hôte.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--pae on|off</computeroutput>&#xA0;: Ceci active/désactive
            la PAE (voir <xref
            linkend="settings-processor" />).</para>
          </listitem>

          <listitem>
            <para><computeroutput>--longmode on|off</computeroutput> : Ceci
            active/désactive le mode long (voir <xref
            linkend="settings-processor" />).</para>
          </listitem>

          <listitem>
            <para><computeroutput>--synthcpu on|off</computeroutput>&#xA0;: Ce
            paramètre détermine si VirtualBox présente ou non un processeur
            synthétique à l'invité pour permettre une migration en direct entre
            les systèmes hôtes qui diffèrent de manière significative.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--hpet on|off</computeroutput>&#xA0;: 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>&#xA0;: 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&#xA0;; voir <xref linkend="hwvirt" />.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--triplefaultreset on|off</computeroutput> : ce
            paramètre permet de relancer l'invité au lieu de récupérer une Guru Meditation. Certains invités échouent par une triple erreur lors de la réinitialisation
            du processeur, donc on peut parfois souhaiter ce comportement. Cela
            ne fonctionne que sur les invités non SMP.</para>
          </listitem>
          <listitem>
            <para><computeroutput>--nestedpaging on|off</computeroutput>&#xA0;: 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&#xA0;; voir <xref
            linkend="hwvirt" />.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--largepages on|off</computeroutput>&#xA0;: 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>&#xA0;: 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&#xA0;; 
            voir see <xref linkend="hwvirt" />.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--vtxux on|off</computeroutput> : Si vous avez
            activé la virtualisation matérielle, seulement pour VT-x d'Intel, ce
            paramètre active ou désactive l'utilisation de la fonction mode invité
            sans restriction pour faire tourner votre invité.</para>
          </listitem>
          <listitem>
            <para><computeroutput>--accelerate3d on|off</computeroutput>&#xA0;: 
            Ceci active, si vous avez installé les suppléments invité, la disponibilité
            de l'accélération 3D&#xA0;; 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
            &lt;msec&gt;</computeroutput> vous pouvez définir la durée d'affichage
            du logo en millisecondes.</para>

            <para>Avec <computeroutput>--bioslogoimagepath
            &lt;cheminimage&gt;</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>&#xA0;: 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&lt;1-N&gt;
            &lt;priorité&gt;</computeroutput>&#xA0;: 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&lt;1-4&gt;
            none|floppy|dvd|disk|net</computeroutput>&#xA0;: 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|&lt;path&gt;</computeroutput>&#xA0;: 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>&#xA0;:
            Spécifie le firmware utilisé pour démarrer une
            machine virtuelle en particulier&#xA0;: EFI ou BIOS. N'utilisez EFI
            que si vous comprenez bien ce que vous faites.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--guestmemoryballoon
            &lt;taille&gt;</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. &lt;taille&gt; 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&lt;1-N&gt;
            &lt;Périphérique&gt;</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&lt;1-N&gt;
              &lt;base E/S&gt; &lt;IRQ&gt;</computeroutput> Spécifie l'adresse
              E/S du port parallèle et le numéro IRQ utilisés par la fonction
              Port parallèle. Utilisez ceci <emphasis>après</emphasis>
              <computeroutput>--lptmod</computeroutput>. L'adresse de base
              E/S et le numéro IRQ sont les valeurs vues par l'invité, c'est-à-dire
              les valeurs disponibles dans le gestionnaire de périphériques de
              l'invité.</para>
            </listitem>

          <listitem>
            <para><computeroutput>--defaultfrontend
            default|&lt;nom&gt;</computeroutput>&#xA0;: Ceci vous permet de
            spécifier l'interface par défaut qui sera utilisée au démarrage de
            cette VM&#xA0; voir 
            <xref linkend="vboxmanage-startvm" /> pour des détails.</para>
          </listitem>
        </itemizedlist></para>
    </sect2>

    <sect2>
      <title>Paramètres réseaux</title>

      <para>Les paramètres réseaux suivants sont disponibles avec
      <computeroutput>VBoxManage modifyvm</computeroutput>. Avec tous ces paramètres,
      le numéro décimal suivant directement le nom de l'option ("1-N" dans la
      in liste ci-dessous) spécifie l'adaptateur réseau virtuel dont vous
      modifiez les paramètres.<itemizedlist>
          <listitem>
            <para><computeroutput>--nic&lt;1-N&gt;
            none|null|nat|bridged|intnet|hostonly|generic
            </computeroutput>&#xA0;: 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&lt;1-N&gt;
            Am79C970A|Am79C973|82540EM|82543GC|82545EM|virtio</computeroutput>&#xA0;:
            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é&#xA0;;
            voir <xref linkend="nichardware" />.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--cableconnected&lt;1-N&gt;
            on|off</computeroutput>&#xA0;: 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&lt;1-N&gt;
            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&lt;1-N&gt;
            &lt;nomfichier&gt;</computeroutput> le fichier où devrait être
            journalisée la trace.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--bridgeadapter&lt;1-N&gt;
            none|&lt;nompériphérique&gt;</computeroutput>&#xA0;: Si le réseau
            bridgé est activé pour une carte réseau virtuelle (voir l'option
            <computeroutput>--nic</computeroutput> ci-dessus&#xA0;; 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&lt;1-N&gt;
            none|&lt;nompériphérique&gt;</computeroutput>&#xA0;: Si le réseau
            host-only a été activé pour une carte réseau virtuelle (voir l'option
            --nic ci-dessus&#xA0;; 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&lt;1-N&gt;
            network</computeroutput>&#xA0;: Si le réseau interne a été activé
            pour une carte réseau virtuelle (voir l'option 
            <computeroutput>--nic</computeroutput> ci-dessus&#xA0;; 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&lt;1-N&gt;
            auto|&lt;mac&gt;</computeroutput>&#xA0;: 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&lt;1-N&gt;
            &lt;pilote fondation&gt;</computeroutput>&#xA0;: 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&#xA0;; 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&lt;1-N&gt;
            &lt;nomparam&gt;="paramvaleur"</computeroutput>&#xA0;:
            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&lt;1-N&gt;
              [&lt;nom&gt;],tcp|udp,[&lt;hostip&gt;],&lt;porthôte&gt;,[&lt;ipinvité&gt;],
              &lt;portinvité&gt;</computeroutput>&#xA0;: 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&lt;1-N&gt; delete
              &lt;nom&gt;</computeroutput>&#xA0;: 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&lt;1-N&gt;
              &lt;préfixe&gt;</computeroutput>&#xA0;: 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&lt;1-N&gt;
              &lt;fichierdémarrage&gt;</computeroutput>&#xA0;: 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&lt;1-N&gt;
              &lt;serveurtftp&gt;</computeroutput>&#xA0;: 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&lt;1-N&gt;
              on|off</computeroutput>&#xA0;: 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&lt;1-N&gt;
              on|off</computeroutput>&#xA0;: 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&lt;1-N&gt;
              on|off</computeroutput>&#xA0;: 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&lt;1-N&gt;
              [&lt;mtu&gt;],[&lt;socksnd&gt;],[&lt;sockrcv&gt;],[&lt;tcpsnd&gt;],
              [&lt;tcprcv&gt;]</computeroutput>&#xA0;: 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&lt;1-N&gt;
              default|[log],[proxyonly],[sameports]</computeroutput>&#xA0;: Cette
              option définit le comportement du c&#x153;ur du moteur NAT&#xA0;: 
              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 et de l'USB</title>

      <para>Les autres paramètres matériels suivants sont disponibles avec
      <computeroutput>VBoxManage modifyvm</computeroutput>&#xA0;:<itemizedlist>
          <listitem>
            <para><computeroutput>--uart&lt;1-N&gt; off|&lt;I/O base&gt;
            &lt;IRQ&gt;</computeroutput>&#xA0;: 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&lt;1-N&gt;
            &lt;arg&gt;</computeroutput>&#xA0;: 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>&lt;arg&gt;</computeroutput> comme une des
            options suivantes&#xA0;:<itemizedlist>
                <listitem>
                  <para><computeroutput>disconnected</computeroutput>&#xA0;: 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
                  &lt;pipename&gt;</computeroutput>&#xA0;: Sur un hôte Windows,
                  ceci dit à VirtualBox de créer un tuyau nommé sur l'hôte, 
                  appelé <computeroutput>&lt;pipename&gt;</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
                  &lt;pipename&gt;</computeroutput>&#xA0;: 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>&lt;devicename&gt;</computeroutput>&#xA0;:
                  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>&#xA0;; 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>&#xA0;: 
            Avec cette option, vous pouvez définir si la VM supporte le son.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--clipboard
            disabled|hosttoguest|guesttohost|bidirectional</computeroutput>&#xA0;:
            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&#xA0;; voir
            <xref linkend="generalsettings" />. Cela exige que les suppléments
            invité soient installés dans la machine virtuelle.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--monitorcount
            &lt;nombre&gt;</computeroutput>&#xA0;: Cela active le support multi-monitoeurs&#xA0;;
            voir <xref linkend="settings-display" />.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--usb on|off</computeroutput>&#xA0;: Cette
            option active ou désactive le contrôleur virtuel USB de la VM&#xA0;; voir
            <xref linkend="settings-usb" /> pour les détails.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--usbehci on|off</computeroutput>&#xA0;: Cette
            option active ou désactive le contrôleur USB 2.0 virtuel de la VM&#xA0;;
            voir <xref linkend="settings-usb" /> pour des détails.</para>
          </listitem>
        </itemizedlist></para>
    </sect2>

    <sect2 id="vboxmanage-modifyvm-vrde">
      <title>Paramètres de la machine distante</title>

      <para>Les paramètres suivants concernant le comportement de la machine 
      distante sont disponibles avec <computeroutput>VBoxManage
      modifyvm</computeroutput>&#xA0;:<itemizedlist>
          <listitem>
            <para><computeroutput>--vrde on|off</computeroutput>&#xA0;: 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|&lt;ports&gt;</computeroutput>&#xA0;: Un port ou une plage
            deports que le serveur VRDE peut sonder&#xA0;; "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&#xA0;: 5000, 5010, 5011 ou 5012.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--vrdeaddress &lt;adresse IP
            &gt;</computeroutput>&#xA0;: 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>
            <para>On peut utiliser ce paramètre pour indiquer si le serveur
            VRDP devrait accepter des donnexions IPv4, IPv6 ou les deux :
            <itemizedlist>
              <listitem>
                <para>IPv4 seulement : <computeroutput>--vrdeaddress "0.0.0.0"
                </computeroutput></para>
              </listitem>
              <listitem>
                <para>IPv6 seulement : <computeroutput>--vrdeaddress "::"
                </computeroutput></para>
              </listitem>
              <listitem>
                <para>IPv6 et IPv4 (par défaut) : <computeroutput>--vrdeaddress ""
                </computeroutput></para>
              </listitem>
            </itemizedlist></para>
          </listitem>

          <listitem>
            <para><computeroutput>--vrdeauthtype
            null|external|guest</computeroutput>&#xA0;: Cela vous permet de choisir
            s'il faut une autorisation et sous quelle forme&#xA0;; voir <xref
            linkend="vbox-auth" /> pour des détails.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--vrdemulticon on|off</computeroutput>&#xA0;: 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>&#xA0;: 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>&#xA0;:
            Ceci active la redirection graphique, si elle est supportée par le
            serveur VRDE&#xA0;; voir <xref lang="" linkend="vrde-videochannel" />.</para>
          </listitem>

          <listitem>
            <para><computeroutput>--vrdevideochannelquality
            &lt;pourcent&gt;</computeroutput>&#xA0;: Définit la qualité de l'image
            dans la redirection graphique&#xA0;; 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>&#xA0;: 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
            &lt;port&gt;</computeroutput>, <computeroutput>--teleporteraddress
            &lt;adresse&gt;</computeroutput>&#xA0;: 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>&lt;port&gt;</computeroutput>
           peut être n'importe quel numéro de port TCP/IP libre (comme 6000)&#xA0;;
            <computeroutput>&lt;adresse&gt;</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
            &lt;mot_de_passe&gt;</computeroutput>&#xA0;: 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
            &lt;mot_de_passe&gt;</computeroutput>&#xA0;: 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 &lt;leaf&gt; &lt;eax&gt; &lt;ebx&gt;
            &lt;ecx&gt; &lt;edx&gt;</computeroutput>&#xA0;: 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&#xA0;; 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&#xA0;:</para>

    <itemizedlist>
       <listitem>
           <para><computeroutput>--snapshot &lt;uuid&gt;|&lt;nom&gt;</computeroutput>&#xA0;:
            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>&#xA0;:
           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>&#xA0;:
           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 &lt;name&gt;</computeroutput>&#xA0;: 
           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 &lt;basefolder&gt;</computeroutput>&#xA0;:
           Sélectionne le dossier où devrait être sauvegardée la configuration.</para>
       </listitem>
       <listitem>
           <para><computeroutput>--uuid &lt;uuid&gt;</computeroutput>&#xA0;:
           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>&#xA0;:
           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&#xA0;:<screen>VBoxManage import WindowsXp.ovf --dry-run
Interpreting WindowsXp.ovf...
OK.
Virtual system 0:
 0: Suggested OS type: "WindowsXP"
    (change with "--vsys 0 --ostype &lt;type&gt;"; use "list ostypes" to list all)
 1: Suggested VM name "Windows XP Professional_1"
    (change with "--vsys 0 --nomvm &lt;name&gt;")
 3: Number of CPUs: 1
    (change with "--vsys 0 --cpus &lt;n&gt;")
 4: Guest memory: 956 MB (change with "--vsys 0 --memory &lt;MB&gt;")
 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 &lt;id&gt;";
    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&#xA0;; 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&#xA0;:<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&#xA0;: 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>

    <para>Le paramètre facultatif <computeroutput>--type</computeroutput> 
    détermine si la machine sera démarrée dans une fenêtre ou si la sortie devrait passer par 
    <computeroutput>VBoxHeadless</computeroutput>, en activant ou pas VRDE&#xA0;;
    voir <xref linkend="vboxheadless" /> pour plus d'informations. La liste
    des types peut changer et il n'est pas garanti que tous les types sont
    acceptés par la variante d'un produit.</para>

    <para>La valeur par défaut, globale ou individuelle à une VM, du type
    d'interface d'une VM sera utilisée si vous ne spécifiez pas explicitement
    le type. Si aucune n'est définie, c'est la variante GUI qui sera démarrée.</para>
    <para>Les valeurs suivantes sont autorisées&#xA0;:</para>

    <glosslist>
      <glossentry>
        <glossterm><computeroutput>gui</computeroutput></glossterm>

        <glossdef>
          <para>Démarre une VM en affichant une fenêtre graphique. C'est le cas 
          par défaut.</para>
        </glossdef>
      </glossentry>

      <glossentry>
        <glossterm><computeroutput>headless</computeroutput></glossterm>

        <glossdef>
          <para>Démarre une VM sans fenêtre pour un affichage distant.</para>
        </glossdef>
      </glossentry>

      <glossentry>
        <glossterm><computeroutput>sdl</computeroutput></glossterm>

        <glossdef>
          <para>Démarre une VM avec une GUI minimale et limitée dans ses
          fonctionnalités.</para>
        </glossdef>
      </glossentry>
    </glosslist>

    <note>
      <para>Si vous rencontrez des problèmes en démarrant des machines virtuelles
      avec certaines interfaces et s'il n'y a pas d'informations d'erreur
      convaincantes, essayez de démarrer les machines virtuelles en lançant
      directement leur interface respective, car cela peut donner des informations
      supplémentaires sur l'erreur.</para>
    </note>
  </sect1>

  <sect1 id="vboxmanage-controlvm">
    <title>VBoxManage controlvm</title>

    <para>La sous-commande <computeroutput>controlvm</computeroutput> vous permet
    modifier l'état d'une machine virtuelle en fonction. Vous pouvez spécifiar
    ce qui suit&#xA0;:</para>

    <para><itemizedlist>
        <listitem>
          <para><computeroutput>VBoxManage controlvm &lt;vm&gt;
          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 &lt;vm&gt;
          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 &lt;vm&gt;
          reset</computeroutput> a le même effet sur une machine virtuelle que
          l'appui sur le bouton "Reset" d'un vrai ordinateur&#xA0;: 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 &lt;vm&gt;
          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&#xA0;; voir <xref
          linkend="vboxmanage-startvm" />.</para>
        </listitem>

        <listitem>
          <para><computeroutput>VBoxManage controlvm &lt;vm&gt;
          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&#xA0;; voir 
<xref linkend="vboxmanage-startvm" />.</para>
        </listitem>

        <listitem>
          <para><computeroutput>VBoxManage controlvm &lt;vm&gt; teleport
          --hostname &lt;nom&gt; --port &lt;port&gt; [--passwordfile
          &lt;fichier&gt; | --password &lt;mot_de_passe&gt;]</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&#xA0;; 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&#xA0;:</para>

    <itemizedlist>
      <listitem>
        <para>L'opération <computeroutput>setlinkstate&lt;1-N&gt;</computeroutput>
        connecte ou déconnecte les câbles réseaux virtuels à leurs interfaces
        réseaux.</para>
      </listitem>

      <listitem>
        <para><computeroutput>nic&lt;1-N&gt;
        null|nat|bridged|intnet|hostonly|generic</computeroutput>&#xA0;: 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|&lt;ports&gt;</computeroutput>
        modifie le port ou la plage de ports que peut sonder le serveur
        VRDP&#xA0;; "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
        &lt;1-100&gt;</computeroutput>&#xA0;: 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. Le paramètre
    <computeroutput>--description</computeroutput> permet de décrire
    l'instantané. Si vous spécifiez <computeroutput>--live</computeroutput>,
    la VM ne s'arrêtera pas pendant la créqation de l'instantané.</para>

    <para>L'opération <computeroutput>delete</computeroutput> efface un
    instantané (spécifié par son nom ou son UUID). Cela peut être long à se
    terminer car les images de différenciation associées à l'instantané pourraient
    devoir être synchronisées avec leurs images de différenciation filles.</para>

    <para>L'opération <computeroutput>restore</computeroutput> restaurera l'instantané
    donné (spécifié par son nom ou son UUID) en réinitialisant les paramètres
    de la machine virtuelle et l'état actuel à ceux de l'instantané. L'état
    actuel précédent de la machine sera perdu. Après cela, l'instantané donné
    devient le nouvel instantané "actuel" pour que les instantanés consécutifs
    s'insèrent sous l'instantané à partir duquel on a restauré.</para>

    <para>L'opération <computeroutput>restorecurrent</computeroutput> est un
    raccourci pour restaurer l'instantané actuel (donc l'instantané d'où provient
    l'état actuel). Cette sous-commande revient à utiliser la sous-commande
    "restore" avec le nom ou l'UUID de l'instantané actuel, sauf qu'elle évite
    l'étape supplémentaire de déterminer ce nom ou cet UUID.</para>

    <para>Avec l'opération <computeroutput>edit</computeroutput>, vous pouvez
    modifier le nom ou la description d'un instantané existant.</para>

    <para>Avec l'opération <computeroutput>showvminfo</computeroutput>, vous
    pouvez voir les paramètres de la machine virtuelle stockées dans un instantané
    existant.</para>
  </sect1>

  <sect1 id="vboxmanage-closemedium">
    <title>VBoxManage closemedium</title>

    <para>Cette commande supprime un fichier image de disque dur, de DVD ou
    disquette, d'un registre de médias VirtualBox.<footnote>
        <para>Avant VirtualBox 4.0, il fallait appeler VBoxManage
        openmedium avant de pouvoir attacher à média à une machine virtuelle&#xA0;;
        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&#xA0;; les
        médias sont ajoutés aux registres des médias automatiquement. L'appel
        "closemedium" a cependant été conservé pour permettre de supprimer
        explicitement un média du registre.</para>
      </footnote></para>

    <para>Éventuellement, vous pouvez demander que l'image seit effacée. Vous aurez
    les retours circonstanciés selon lesquels la suppression a échoué, mais l'image
    ne sera pas enregistrée.</para>
  </sect1>

  <sect1 id="vboxmanage-storageattach">
    <title>VBoxManage storageattach</title>

    <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&#xA0;:</para>

    <screen>VBoxManage storageattach    &lt;uuid|nomvm&gt;
                            --storagectl &lt;name&gt;
                            [--port &lt;number&gt;]
                            [--device &lt;number&gt;]
                            [--type dvddrive|hdd|fdd]
                            [--medium none|emptydrive|
                                      &lt;uuid&gt;|&lt;filename&gt;|host:&lt;drive&gt;|iscsi]
                            [--mtype normal|writethrough|immutable|shareable]
                            [--comment &lt;text&gt;]
                            [--setuuid &lt;uuid&gt;]
                            [--setparentuuid &lt;uuid&gt;]
                            [--passthrough on|off]
                            [--tempeject on|off]
                            [--nonrotational on|off]
                            [--discard on|off]
                            [--bandwidthgroup name|none]
                            [--forceunmount]
                            [--server &lt;name&gt;|&lt;ip&gt;]
                            [--target &lt;target&gt;]
                            [--tport &lt;port&gt;]
                            [--lun &lt;lun&gt;]
                            [--encodedlun &lt;lun&gt;]
                            [--username &lt;username&gt;]
                            [--password &lt;password&gt;]
                            [--initiator &lt;initiator&gt;]
                            [--intnet]
</screen>

    <para>Un certain nombre de paramètres sont requis classiquement&#xA0;; ceux
    à la fin de la liste ne sont requis que pour les cibles iSCSI (voir ci-dessous).</para>

    <para>Les paramètres classiques sont&#xA0;:<glosslist>
        <glossentry>
          <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>

          <glossdef>
            <para>Le nom ou l'UUID de la VM. Obligatoire.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>storagectl</computeroutput></glossterm>

          <glossdef>
            <para>Nom du contrôleur de stockage. Obligatoire. Vous pouvez obtenir
            la liste des contrôleurs de stockage actuellement attachés à une VM
            avec <computeroutput>VBoxManage showvminfo</computeroutput>&#xA0;; 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&#xA0;:<itemizedlist>
                <listitem>
                  <para>"none"&#xA0;: Tout périphérique existant serait supprimé du
                  slot donné.</para>
                </listitem>

                <listitem>
                  <para>"emptydrive"&#xA0;: 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"&#xA0;: 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:&lt;lecteur&gt;": 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"&#xA0;: Pour les disques durs virtuels seulement,
                  cela permet de spécifier une cible iSCSI. Dans ce cas, vous
                  devez donner davantage de paramètres&#xA0;; 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&#xA0;;
            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&#xA0;; 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é&#xA0;; 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&#xA0;:<glosslist>
        <glossentry>
          <glossterm>server</glossterm>

          <glossdef>
            <para>Le nom de l'hôte ou l'adresse IP de la cible iSCSI&#xA0;;
            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&#xA0;; 
            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&#xA0;:</para>

    <screen>VBoxManage storagectl       &lt;uuid|nomvm&gt;
                            --name &lt;nom&gt;
                            [--add &lt;ide/sata/scsi/floppy&gt;]
                            [--controller &lt;LsiLogic|LSILogicSAS|BusLogic|
                                          IntelAhci|PIIX3|PIIX4|ICH6|I82078&gt;]
                            [--sataportcount &lt;1-30&gt;]
                            [--hostiocache on|off]
                            [--bootable on|off]
                            [--remove]</screen>

    <para>où les paramètres signifient&#xA0;: <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&#xA0;:<screen>VBoxManage bandwidthctl    &lt;uuid|nomvm&gt;
                            add &lt;nom&gt; --type disk|network --limit &lt;megabytes per second&gt;[k|m|g|K|M|G] |
                            set &lt;nom&gt; --limit &lt;megabytes per second&gt;[k|m|g|K|M|G] |
                            remove &lt;nom&gt; |
                            list [--machinereadable]</screen></para>

    <para>Les sous-commandes suivantes sont disponibles&#xA0;:<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&#xA0;:<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&#xA0;: <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&#xA0;: <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&#xA0;:</para>

    <screen>VBoxManage createhd         --filename &lt;nomfichier&gt;
                            --size &lt;mégaoctets&gt;
                            [--format VDI|VMDK|VHD] (par défaut : VDI)
                            [--variant Standard,Fixed,Split2G,Stream,ESX]</screen>

    <para>où les paramètres signifient&#xA0;:<glosslist>
        <glossentry>
          <glossterm><computeroutput>nomfichier</computeroutput></glossterm>

          <glossdef>
            <para>Permet de choisir un nom de fichier. Obligatoire.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>mégaoctets</computeroutput></glossterm>

          <glossdef>
            <para>Permet de définir la capacité de l'image, en MiO.
            Obligatoire.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>format</computeroutput></glossterm>

          <glossdef>
            <para>Permet de choisir un format de fichier pour le fichier
            de sortie, différent du format du fichier d'entrée.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>variant</computeroutput></glossterm>

          <glossdef>
            <para>Permet de choisir une variante du format de fichier pour le
            fichier de sortie. C'est une liste de drapeaux séparée par des virgules.
            Toutes les combinaisons ne sont pas supportées, spécifier des
            drapeaux incohérents donne un message d'erreur.</para>
          </glossdef>
        </glossentry>
      </glosslist> <note>
        <para>Pour être compatible avec d'anciennes versions de VirtualBox, la
        commande "createvdi" est également supportée et associée en interne avec
        la commande "createhd".</para>
      </note></para>
  </sect1>

  <sect1 id="vboxmanage-modifyvdi">
    <title>VBoxManage modifyhd</title>

    <para>Avec la commande <computeroutput>modifyhd</computeroutput>, vous pouvez
    modifier les caractéristiques d'une image de disque après l'avoir 
    créé&#xA0;:<screen>VBoxManage modifyhd         &lt;uuid&gt;|&lt;nomfichier&gt;
                            [--type normal|writethrough|immutable|shareable|
                                    readonly|multiattach]
                            [--autoreset on|off]
                            [--compact]
                            [--resize &lt;megabytes&gt;|--resizebyte &lt;octets&gt;]</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&#xA0;:<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&#xA0;; 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&#xA0;; 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&#xA0;; 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&#xA0;;
          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&#xA0;; voir
    <xref linkend="vdis" /> et <xref linkend="cloningvdis" />. La syntaxe est
    comme suit&#xA0;:</para>

    <screen>VBoxManage clonehd         &lt;uuid&gt;|&lt;nomfichier&gt; &lt;outputfile&gt;
                           [--format VDI|VMDK|VHD|RAW|&lt;other&gt;]
                           [--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&#xA0;:<glosslist>
        <glossentry>
          <glossterm><computeroutput>--format</computeroutput></glossterm>

          <glossdef>
            <para>Permet de choisir un format de fichier pour le fichier de
            sortie, autre que celui du fichier d'entrée.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>--variant</computeroutput></glossterm>

          <glossdef>
            <para>Permet de choisir une variante de format de fichier pour le 
            fichier de sortie. C'est une liste de drapeaux séparée par des virgules.
            Toutes les combinaisons ne sont pas supportées, spécifier des
            drapeaux incohérents donne un message d'erreur.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>--existing</computeroutput></glossterm>

          <glossdef>
            <para>Effectue le clonage sur un média de destination existant. Seule
            la partie du média source convenant au média de destination est copiée.
            Cela signifie que si le média de destination est plus petit que
            la source, seule une partie en est copiée, et si le média de
            destination est plus gros que la source, le reste de l'espace du
            média de destination reste inchangé.</para>
          </glossdef>
        </glossentry>
      </glosslist> <note>
        <para>Pour être compatible avec les anciennes versions de VirtualBox, 
        la commande "clonevdi" est également supportée et elle a été associée
        en interne à la commande "clonehd".</para>
      </note></para>
  </sect1>

  <sect1>
    <title>VBoxManage convertfromraw</title>

    <para>Cette commande convertit une image de disque brute en fichier VirtualBox Disk Image
    (VDI). La syntaxe est la suivante&#xA0;:</para>

    <screen>VBoxManage convertfromraw   &lt;filename&gt; &lt;outputfile&gt;
                            [--format VDI|VMDK|VHD]
                            [--variant Standard,Fixed,Split2G,Stream,ESX]
                            [--uuid &lt;uuid&gt;]
VBoxManage convertfromraw   stdin &lt;fichiersortie&gt; &lt;octets&gt;
                            [--format VDI|VMDK|VHD]
                            [--variant Standard,Fixed,Split2G,Stream,ESX]
                            [--uuid &lt;uuid&gt;]</screen>

    <para>où les paramètres signifient&#xA0;:<glosslist>
        <glossentry>
          <glossterm><computeroutput>--bytes</computeroutput></glossterm>

          <glossdef>
            <para>La taille du fichier image, en octets, fournie en entrée.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>--format</computeroutput></glossterm>

          <glossdef>
            <para>Sélectionnez le format de l'image de disque à créer. Par
            défaut, c'est VDI.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>--variant</computeroutput></glossterm>

          <glossdef>
            <para>Permet de choisir une variante de format de fichier pour le 
            fichier en sortie. C'est une liste de drapeaux séparée par des 
            virgules. Toutes les combinaisons ne sont pas supportées, spécifier
            des drapeaux incohérents donne un message d'erreur.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>--uuid</computeroutput></glossterm>

          <glossdef>
            <para>Permet de spécifier l'UUID ou le fichier de sortie.</para>
          </glossdef>
        </glossentry>
      </glosslist> La deuxième forme oblige VBoxManage à lire le contenu de
      l'image de disque à partir de l'entrée standard (utile pour utiliser
      cette commande en ligne).</para>

    <para><note>
        <para>Pour être compatible avec d'anciennes versions de VirtualBox,
        la commande "convertdd" est aussi supportée et elle est associée en interne
        à la commande "convertfromraw".</para>
      </note></para>
  </sect1>

  <sect1>
    <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&#xA0;:</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&#xA0;:</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&#xA0;:<glosslist>
        <glossentry>
          <glossterm><computeroutput>machinefolder</computeroutput></glossterm>

          <glossdef>
            <para>Ceci spécifie le dossier par défaut dans lequel sont
            stockées les définitions de la machine virtuelle&#xA0;; voir <xref linkend="vboxconfigdata" /> pour les détails.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>hwvirtexclusive</computeroutput></glossterm>
          <para>Ceci spécife si VirtualBox utilisera en exclusivité les
          extensions de virtualisation matérielle (Intel VT-x ou AMD-V) du
          processeur du système hôte ; voir <xref linkend="hwvirt" />. Si
          vous souhaitez partager ces extensions avec d'autres hyperviseurs en
          fonction en même temps, vous devez désactiver ce paramètre.
          Cela a des implications négatives en termes de performance.
          </para>
        </glossentry>


        <glossentry>
          <glossterm><computeroutput>vrdeauthlibrary</computeroutput></glossterm>

          <glossdef>
            <para>Ceci indique la bibliothèque à utiliser quand on a sélectionné
            l'authentification "externe" pour une machine virtuelle en particulier&#xA0;;
            voir <xref linkend="vbox-auth" /> pour des détails.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>websrvauthlibrary</computeroutput></glossterm>

          <glossdef>
            <para>Ceci spécifie la bibliothèque utilisée par le service web 
            pour authentifier les utilisateurs. Pour des détails sur le service
            web de VirtualBox, merci de vous reporter au manuel de référence SDK
            distinct de VirtualBox (voir <xref
            linkend="VirtualBoxAPI" />).</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>vrdeextpack</computeroutput></glossterm>
          <glossdef>
            <para>Ceci spécifie la bibliothèque qui implémente l'extension Bureau
            distant de VirtualBox.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>loghistorycount</computeroutput></glossterm>

          <glossdef>
            <para>Ceci sélectionne le nombre de journaux de VMs (anciens)
            conservés.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>autostartdbpath</computeroutput></glossterm>

          <glossdef>
            <para>Ceci sélectionne le chemin vers la base de données autostart.
            Voir <xref linkend="autostart" />.</para>
          </glossdef>
        </glossentry>

        <glossentry>
          <glossterm><computeroutput>defaultfrontend</computeroutput></glossterm>

          <glossdef>
            <para>Ceci sélectionne l'interface globale des VMs. Voir
            <xref linkend="vboxmanage-startvm" />.</para>
          </glossdef>
        </glossentry>
      </glosslist></para>
  </sect1>

  <sect1>
    <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>&lt;vm&gt;</computeroutput>, dans chaque cas, peut être
    soit un nom soit un UUID d'une VM, comme pour les autres commandes de
    VBoxManage)&#xA0;:<itemizedlist>
        <listitem>
          <para><computeroutput>enumerate &lt;vm&gt; [--patterns
          &lt;pattern&gt;]</computeroutput>&#xA0;: 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 
          &lt;échantillon&gt;</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&#xA0;:<itemizedlist>
              <listitem>
                <para><computeroutput>*</computeroutput> (astérisque)&#xA0;:
                représente n'importe quel nombre de caractères&#xA0;; par exemple,
                "<computeroutput>/VirtualBox*</computeroutput>" correspondrait
                à toutes les propriétés commençant par "/VirtualBox".</para>
              </listitem>

              <listitem>
                <para><computeroutput>?</computeroutput> (point d'interrogation)&#xA0;:
                représente un seul caractère de votre choix&#xA0;; par exemple,
                "<computeroutput>fo?</computeroutput>" correspondrait à "foo"
                et à "for".</para>
              </listitem>

              <listitem>
                <para><computeroutput>|</computeroutput> (symbole pipe)&#xA0;:
                peut être utilisé pour spécifier plusieurs échantillons alternatifs&#xA0;;
                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 &lt;vm&gt;</computeroutput>&#xA0;: 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 &lt;vm&gt; &lt;propriété&gt; [&lt;valeur&gt;
          [--flags &lt;drapeaux&gt;]]</computeroutput>&#xA0;: Ceci vous permet
          de définir une propriété invité en spécifiant la clé et la valeur.
          Si vous ne mettez pas <computeroutput>&lt;valeur&gt;</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)&#xA0;:<itemizedlist>
              <listitem>
                <para><computeroutput>TRANSIENT</computeroutput>&#xA0;: la
                valeur ne sera pas stockée avec les données de la VM quand la
                VM exite&#xA0;;</para>
              </listitem>

              <listitem>
                <para><computeroutput>TRANSRESET</computeroutput>&#xA0;: la valeur
                sera effacée dès que la VM redémarrera et/ou existera&#xA0;;</para>
              </listitem>

              <listitem>
                <para><computeroutput>RDONLYGUEST</computeroutput>&#xA0;: la
                valeur ne peut être modifiée que par l'hôte, l'invité ne
                peut que la lire&#xA0;;</para>
              </listitem>

              <listitem>
                <para><computeroutput>RDONLYHOST</computeroutput>&#xA0;: inversement,
                cette valeur ne peut être modifiée que par l'invité, l'hôte
                ne peut que la lire&#xA0;;</para>
              </listitem>

              <listitem>
                <para><computeroutput>READONLY</computeroutput>&#xA0;: la
                combinaison des deux, la valeur ne peut pas être modifiée.</para>
              </listitem>
            </itemizedlist></para>
        </listitem>

        <listitem>
          <para><computeroutput>wait &lt;vm&gt; &lt;échantillon&gt; --timeout
          &lt;timeout&gt;</computeroutput>&#xA0;: 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 &lt;vm&gt; &lt;propriété&gt;
          </computeroutput>&#xA0;: 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&#xA0;:</para>

    <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; &lt;commande&gt;</screen>

    <para>Les sous-commandes suivantes sont disponibles (où
    <computeroutput>&lt;uuid|nomvm&gt;</computeroutput>, dans tous les cas, peut
    être le nom ou l'UUID d'une VM comme avec les autres commandes de
    VBoxManage)&#xA0;:<itemizedlist>
        <listitem>
          <para><emphasis role="bold"><computeroutput>execute</computeroutput></emphasis>, 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&#xA0;:</para>

          <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; exec[ute]
            --image &lt;chemin du programme&gt; --username &lt;nom&gt;
            [--passwordfile &lt;fichier&gt; | --password &lt;mot de passe&gt;]
            [--environment "&lt;NOM&gt;=&lt;VALEUR&gt; [&lt;NOM&gt;=&lt;VALEUR&gt;]"]
            [--verbose] [--timeout &lt;msec&gt;]
            [--wait-exit] [--wait-stdout] [--wait-stderr]
            [--dos2unix] [--unix2dos]
            -- [[&lt;argument1&gt;] ... [&lt;argumentN&gt;]]</screen>

          <para>où les paramètres signifient&#xA0;: <glosslist>
              <glossentry>
                <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>

                <glossdef>
                  <para>Le nom ou l'UUID de la VM. Obligatoire.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--image "&lt;chemin du programme&gt;"</computeroutput></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><computeroutput>--username &lt;nom&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Nom de l'utilisateur sous lequel devrait se lancer le 
                  processus. Cet utilisateur doit exister sur l'OS invité.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--passwordfile &lt;fichier&gt;</computeroutput></glossterm>
                  <glossterm><computeroutput>--password &lt;motdepasse&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Mot de passe du compte utilisateur spécifié, à lire dans
                  le fichier donné. Si vous n'en donnez pas, un mot de passe
                  vierge est supposé.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm>--password &lt;mot de passe&gt;</glossterm>

                <glossdef>
                  <para>Mot de passe du compte utilisateur spécifié avec
                  <computeroutput>--username</computeroutput>. Si vous n'en
                  donnez pas, un mot de passe vierge est supposé.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--dos2unix</computeroutput></glossterm>

                <glossdef>
                  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><computeroutput>--environment
                  "&lt;NOM&gt;=&lt;VALEUR&gt;"</computeroutput></glossterm>

                <glossdef>
                  <para>Une ou plusieurs variables d'environnement à définir ou
                  dérégler.</para>

                  <para>Par défaut, le nouveau processus de l'invité sera
                  créé avec l'environnement standard de l'OS invité. Cette
                  option permet de modifier cet environnement. Pour définir/modifier
                  une variable, une paire <computeroutput>NOM=VALEUR</computeroutput> doit
                  être spécifiée&#xA0;; 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><computeroutput>--timeout &lt;msec&gt;</computeroutput></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><computeroutput>--unix2dos</computeroutput></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><computeroutput>--verbose</computeroutput></glossterm>

                <glossdef>
                  <para>Dit à VBoxManage d'être plus verbeux.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--wait-exit</computeroutput></glossterm>

                <glossdef>
                  <para>Attend la fin d'un processus et affiche son code de
                  sortie avec la raison/les drapeaux de sa fin.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--wait-stdout</computeroutput></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><computeroutput>--wait-stderr</computeroutput></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><computeroutput>[-- [&lt;argument1s&gt;] ... [&lt;argumentNs&gt;]]</computeroutput></glossterm>

                <glossdef>
                  <para>Un ou plusieurs arguments à passer au processus à 
                  exécuter.</para>
                  <para>Les arguments contenant des espaces doivent être entourés
                  de guillemets.</para>
                </glossdef>
              </glossentry>

            </glosslist></para>

          <para><note>
              <para>Sur Windows, il existe certaines limites pour les applications
              graphiques&#xA0;; merci de voir <xref linkend="KnownIssues" /> pour
              plus d'informations.</para>
            </note> Exemples&#xA0;: <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é&#xA0;; les exécutions 
            anonymes ne sont pas supportées pour des raisons de sécurité.
            Néanmoins, le mot de passe d'un compte utilisateur est facultatif
            et dépend de la politique et des règles de l'invité. Si vous ne
            spécifiez aucun mot de passe pour un nom d'utilisateur donné,
            un mot de passe vierge sera utilisé. Sur certains OS comme Windows,
            il pe peut qu'il faille ajuster la politique de sécurité pour autoriser
            le paramétrage d'un compte utilisateur avec un mot de passe vierge.
            En outre, les règles du domaine global pourraient s'appliquer et, donc,
            on ne peut pas les modifier.</para>
          </note></para>

          <para>À partir de VirtualBox 4.1.2 l'exécution d'un processus invité 
          par défaut se limite à 5 processus invités en même temps. Si un
          nouveau processus invité est lancé et dépasserait cette limite, le
          plus ancien dans l'invité qui ne s'exécute pas sera désactivé afin de
          pouvoir lancer ce nouveau processus. En outre, la récupération de la
          sortie de cet ancien processus invité ne sera alors plus possible.
          Si les 5 processus invités sont toujours actifs et en fonction, le
          démarrage d'un nouveau processus enverra un message d'erreur circonstancié.</para>

          <para>Pour augmenter ou diminuer la limite d'exécution des processus
          invité, il faut modifier soit la propriété <computeroutput>/VirtualBox/GuestAdd/VBoxService/--control-procs-max-kept</computeroutput>,
          soit la ligne de commande ee VBoxService en spécifiant 
          <computeroutput>--control-procs-max-kept</computeroutput>. Il faut
          ensuite redémarrer l'OS invité. Pour gérer un nombre illimité de
          processus invités, il faut définir une valeur de <computeroutput>0</computeroutput>
          (non recommandé).</para>
        </listitem>

        <listitem>
          <para><emphasis role="bold"><computeroutput>copyto</computeroutput></emphasis>, qui permet de copier
          des fichiers de l'hôte vers l'invité (seulement si les suppléments invité
          4.0 et supérieur sont installés).</para>

          <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; copyto|cp
            &lt;source invité&gt; &lt;hôte dest&gt; --username &lt;nom&gt;
            [--passwordfile &lt;fichier&gt; | --password &lt;mot de passe&gt;]
            [--dryrun] [--follow] [--recursive] [--verbose]</screen>

          <para>où les paramètres signifient&#xA0;: <glosslist>
              <glossentry>
                <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>

                <glossdef>
                  <para>L'UUID ou le nom de la VM. Obligatoire.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>source sur l'hôte</computeroutput></glossterm>

                <glossdef>
                  <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><computeroutput>destination sur l'invité</computeroutput></glossterm>

                <glossdef>
                  <para>Chemin de destination absolu sur l'invité, comme
                  <computeroutput>C:\Temp</computeroutput></para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--username &lt;nom&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Nom d'utilisateur sous lequel devrait fonctionner le 
                  processus de copie. Cet utilisateur doit exister sur l'OS
                  invité.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--passwordfile &lt;fichier&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Mot de passe du compte utilisateur spécifié, à lire dans
                  le fichier donné. Si vous n'en donnez pas, un mot de passe
                  vierge est supposé.</para>
               </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--password &lt;mot depasse&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Mot de passe du compte utilisateur spécifié avec
                  <computeroutput>--username</computeroutput>. Si vous n'en
                  donnez pas, un mot de passe vierge est supposé.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--dryrun</computeroutput></glossterm>

                <glossdef>
                  <para>Dit à VBoxManage de ne faire qu'une exécution dry au
                  lieu de copier vraiment les fichiers dans l'invité.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--follow</computeroutput></glossterm>

                <glossdef>
                  <para>Active le suivi des liens symboliques sur la
                  source de l'hôte.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--recursive</computeroutput></glossterm>

                <glossdef>
                  <para>Copie récursivement les fichiers/répertoires de la
                  source spécifiée.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--verbose</computeroutput></glossterm>

                <glossdef>
                  <para>Dit à VBoxManage d'être plus verbeux.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--flags &lt;drapeaux&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Drapeaux supplémentaires à définir. Ce n'est pas utilisé
                  pour le moment.</para>
                </glossdef>
              </glossentry>
            </glosslist></para>
        </listitem>

        <listitem>
          <para><emphasis role="bold"><computeroutput>copyfrom</computeroutput></emphasis>,
          qui permet de copier
          des fichiers de l'invité vers l'hôte (seulement si les suppléments
          invité 4.0 et supérieur sont installés). Il prend les mêmes paramètres
          que <computeroutput>copyto</computeroutput> ci-dessus.</para>
        </listitem>

        <listitem>
          <para><emphasis role="bold"><computeroutput>createdirectory</computeroutput></emphasis>, qui permet de copier
          des fichiers de l'invité vers l'hôte (seulement si les suppléments
          invité 4.0 et supérieur sont installés). Il prend les mêmes paramètres
          que <computeroutput>copyto</computeroutput> ci-dessus.</para>

          <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; createdir[ectory]|mkdir|md
            &lt;répertoire invité&gt;... --username &lt;nom&gt;
            [--passwordfile &lt;fichier&gt; | --password &lt;mot de passe&gt;]
            [--parents] [--mode &lt;mode&gt;] [--verbose]</screen>

          <para>où les paramètres signifient&#xA0;: <glosslist>
              <glossentry>
                <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>

                <glossdef>
                  <para>L'UUID ou le nom de la VM. Obligatoire.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>répertoire à créer sur l'invité</computeroutput></glossterm>

                <glossdef>
                  <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><computeroutput>--username &lt;nom&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Nom de l'utilisateur sous lequel devrait fonctionner
                  le processus de copie. Cet utilisateur doit exister sur l'OS
                  invité.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--passwordfile &lt;fichier&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Mot de passe du compte utilisateur spécifié, à lire dans
                  le fichier donné. Si vous n'en donnez pas, un mot de passe
                  vierge est supposé.</para>                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--password &lt;mot de passe&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Mot de passe du compte utilisateur spécifié avec
                  <computeroutput>--username</computeroutput>. Si vous n'en
                  donnez pas, un mot de passe vierge est supposé.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--parents</computeroutput></glossterm>

                <glossdef>
                  <para>Crée aussi les répertoires parent non encore créés 
                  pour le répertoire spécifié, par exemple si le répertoire
                  <computeroutput>D:\Foo</computeroutput> de
                  <computeroutput>D:\Foo\Bar</computeroutput> n'existe pas encore,
                  il sera créé. Si on ne spécifie pas 
                  <computeroutput>--parent</computeroutput>, l'action échouerait.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--mode &lt;mode&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Définit les droits du répertoire spécifié. Seules des
                  valeurs octales (comme
                  <computeroutput>0755</computeroutput>) sont supportées pour l'heure.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--verbose</computeroutput></glossterm>

                <glossdef>
                  <para>Dit à VBoxManage d'être plus verbeux.</para>
                </glossdef>
              </glossentry>
            </glosslist></para>
        </listitem>

        <listitem>
          <para><emphasis role="bold"><computeroutput>createtemporary</computeroutput></emphasis>,
          qui permet de copier des fichiers de l'hôte sur l'invité (seulement
          si les suppléments invités 4.2 ou supérieur sont installés).</para>

          <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; createtemp[orary]|mktemp
            &lt;modèle&gt; --username &lt;nom&gt;
            [--passwordfile &lt;fichier&gt; | --password &lt;mot_de_passe&gt;]
            [--directory] [--secure] [--tmpdir &lt;répertoire&gt;]
            [--domain &lt;domaine&gt;] [--mode &lt;mode&gt;] [--verbose]</screen>

          <para>où les paramètres signifient&#xA0;: <glosslist>
              <glossentry>
                <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>

                <glossdef>
                  <para>L'UUID ou le nom de la VM. Obligatoire.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>modèle</computeroutput></glossterm>

                <glossdef>
                  <para>Un nom de fichier sans chemin et avec au moins trois
                  caractères 'X' consécutifs ou se terminant par 'X'.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--username &lt;nom&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Nom de l'utilisateur sous lequel devrait fonctionner
                  le processus de copie. Cet utilisateur doit exister sur l'OS
                  invité.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--passwordfile &lt;fichier&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Mot de passe du compte utilisateur spécifié, à lire dans
                  le fichier donné. Si vous n'en donnez pas, un mot de passe
                  vierge est supposé.</para>                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--password &lt;mot de passe&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Mot de passe du compte utilisateur spécifié avec
                  <computeroutput>--username</computeroutput>. Si vous n'en
                  donnez pas, un mot de passe vierge est supposé.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--directory</computeroutput></glossterm>

                <glossdef>
                  <para>Crée un répertoire temporaire au lieu d'un fichier.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--secure</computeroutput></glossterm>

                <glossdef>
                  <para>
                    Création sécurisée. Le mode du fichier est
                    <computeroutput>0755</computeroutput>. Et l'opération
                    échouera si elle ne peut s'effectuer en sécurité.
                  </para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--tmpdir &lt;répertoire&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>
                    Répertoire où le fichier / répertoire sera cRéé.
                    Si vous n'en indiquez pas, répertoire temporaire spécifique
                    'à la plateforme est utilisé.
                  </para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--mode &lt;mode&gt;</computeroutput></glossterm>

                <glossdef>
                  <para>Définit les droits du répertoire spécifié. Seules des
                  valeurs octales (comme
                  <computeroutput>0755</computeroutput>) sont supportées pour l'heure.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--verbose</computeroutput></glossterm>

                <glossdef>
                  <para>Dit à VBoxManage d'être plus verbeux.</para>
                </glossdef>
              </glossentry>
            </glosslist></para>
        </listitem>

        <listitem>
          <para><emphasis role="bold"><computeroutput>list</computeroutput></emphasis>,
          qui présente plusieurs informations de contrôle de l'invité telles
          que les sessions et les fichiers ouverts dans l'invité et les processus de l'invité.</para>

          <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; list
          &lt;all|sessions|processes|files&gt; [--verbose]</screen>

          <para>où les paramètres signifient&nbsp;: <glosslist>
            <glossentry>
              <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
              <glossdef>
                <para>L'UUID ou le nom de la VM. Obligatoire.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>all|sessions|processes|files</computeroutput></glossterm>

              <glossdef>
                <para>présenter les sessions dans l'invité, les processus de
                l'invité, les fichiers dans l'invité ou toutes les informations disponibles.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--verbose</computeroutput></glossterm>

              <glossdef>
                <para>Dit à VBoxManage d'être plus verbeux.</para>
              </glossdef>
            </glossentry>
          </glosslist></para>
        </listitem>

        <listitem>
          <para><emphasis role="bold"><computeroutput>process kill</computeroutput></emphasis>,
          qui termine des processus de l'invité en particulier pour une session
          de l'invité, à partir soit l'ID de la session, soit du nom de la
          session.</para>

          <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; process kill
            --session-id &lt;ID&gt;
          | --session-name &lt;nom ou modèle&gt;
          [--verbose]
          &lt;PID&gt; ... &lt;PID n&gt;</screen>

          <para>où les paramètres signifient&nbsp;: <glosslist>
            <glossentry>
              <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>

              <glossdef>
                <para>L'UUID ou le nom de la VM. Obligatoire.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--session-id</computeroutput></glossterm>

              <glossdef>
                <para>Spécifie la session de l'invité à utiliser par son ID.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--session-name</computeroutput></glossterm>

              <glossdef>
                <para>Spécifie la session de l'invité à utiliser par son nom.
                Vous pouvez spécifier plusieurs sessions en spécifiant les jokers
                * ou ?.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--verbose</computeroutput></glossterm>

              <glossdef>
                <para>Dit à VBoxManage d'être plus verbeux.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>&lt;PID&gt; ... &lt;PID n&gt;</computeroutput></glossterm>

              <glossdef>
                <para>Liste les identifiants des processus (PIDs) à terminer.</para>
              </glossdef>
            </glossentry>
          </glosslist></para>
        </listitem>

        <listitem>
          <para><emphasis role="bold"><computeroutput>[p[s]]kill</computeroutput></emphasis>,
          qui termine des processus en particulier dans une session de l'invité,
          à partir soit de l'ID de la session, soit de son nom.</para>

          <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; process kill
            --session-id &lt;ID&gt;
          | --session-name &lt;nom ou modèle&gt;
          [--verbose]
          &lt;PID&gt; ... &lt;PID n&gt;</screen>

          <para>où les paramètres signifient&nbsp;: <glosslist>
            <glossentry>
              <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>

              <glossdef>
                <para>L'UUID ou le nom de la VM. Obligatoire.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--session-id</computeroutput></glossterm>

              <glossdef>
                <para>Spécifie la session de l'invité à utiliser par son ID.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--session-name</computeroutput></glossterm>

              <glossdef>
                <para>Spécifie la session de l'invité à utiliser par son nom. Vous
                pouvez spécifier plusieurs sessions avec les jokers * ou ?.</para>
              </glossdef>

            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--verbose</computeroutput></glossterm>

              <glossdef>
                <para>Dit à VBoxManage d'être plus verbeux.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>&lt;PID&gt; ... &lt;PID n&gt;</computeroutput></glossterm>

              <glossdef>
                <para>Liste les identifiants des processus (PIDs) à terminer.</para>
              </glossdef>
            </glossentry>
          </glosslist></para>
        </listitem>

        <listitem>
          <para><emphasis role="bold"><computeroutput>session close</computeroutput></emphasis>,
          qui ferme des sessions spécifiques de l'invité à partir de l'ID de la
          session ou de son nom.</para>

          <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; session close
            --session-id &lt;ID&gt;
          | --session-name &lt;nom ou extrait&gt;
          | --all
          [--verbose]</screen>

          <para>où les paramètres signifient : <glosslist>
            <glossentry>
              <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>

              <glossdef>
                <para>L'UUID ou le nom de la VM. Obligatoire.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--session-id</computeroutput></glossterm>

              <glossdef>
                <para>Ferme une session de ;'invité spécifiée par son ID.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--session-name</computeroutput></glossterm>

              <glossdef>
                <para>Ferme une session de ;'invité spécifiée par son nom. Vous
                pouvez fermer plusieurs sessions grâce aux jokers * ou ?.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--all</computeroutput></glossterm>

              <glossdef>
                <para>Ferme toutes les sessions de l'invité.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--verbose</computeroutput></glossterm>

              <glossdef>
                <para>Dit à VBoxManage d'être plus verbeux.</para>
              </glossdef>
            </glossentry>
          </glosslist></para>
        </listitem>

        <listitem>
          <para><emphasis role="bold"><computeroutput>stat</computeroutput></emphasis>, qui affiche l'état d'un
          fichier ou d'un système de fichiers de l'invité.</para>

          <screen>VBoxManage guestcontrol &lt;nomvm&gt;|&lt;uuid&gt; stat
            &lt;file&gt;... --username &lt;nom&gt;
            [--passwordfile &lt;fichier&gt; | --password &lt;mot de passe&gt;]
            [--verbose]</screen>

          <para>où les paramètres signifient&#xA0;: <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 &lt;nom&gt;</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 &lt;fichier&gt;</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 &lt;mot de passe&gt;</glossterm>

                <glossdef>
                  <para>Mot de passe du compte utilisateur spécifié avec
                  <computeroutput>--username</computeroutput>. Si vous n'en
                  donnez pas, un mot de passe vierge est supposé.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm><computeroutput>--verbose</computeroutput></glossterm>

                <glossdef>
                  <para>Dit à VBoxManage d'être plus verbeux.</para>
                </glossdef>
              </glossentry>
            </glosslist></para>
        </listitem>

        <listitem>
          <para><emphasis role="bold"><computeroutput>updateadditions</computeroutput></emphasis>, qui permet de
          mettre à jour une version des suppléments invité installée sur l'invité
          (sur les suppléments invité installés 4.0 et supérieur).</para>

          <screen>VBoxManage guestcontrol &lt;nomvm&gt;|&lt;uuid&gt; updateadditions
            [--source "&lt;fichier des suppléments invité .ISO à utiliser&gt;"] [--verbose]
            [--wait-start] [-- [&lt;argument1&gt;] ... [&lt;argumentN&gt;]]</screen>

          <para>où les paramètres signifient&#xA0;: <glosslist>
              <glossentry>
                <glossterm>uuid|nomvm</glossterm>

                <glossdef>
                  <para>L'UUID ou le nom de la VM. Obligatoire.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm>--source "&lt;fichier des suppléments invité .ISO à
                utiliser&gt;"</glossterm>

                <glossdef>
                  <para>Chemin complet vers un autre fichier .ISO de suppléments
                  invité à utiliser pour mettre à jour les suppléments invité.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm>--verbose</glossterm>

                <glossdef>
                  <para>Dit à VBoxManage d'être plus verbeux.</para>
                </glossdef>
              </glossentry>

              <glossentry>
                <glossterm>--wait-start</glossterm>
                <glossdef>
                  <para>Démarre le processus normal de mise à jour et attend 
                  jusqu'à ce que la mise à jour des suppléments invité soit 
                  effectivement démarrée dans l'invité. Cela peut être nécessaire
                  du fait de l'interaction nécessaire avec l'OS invité pendant
                  la phase d'installation.</para>
                  <para>Si vous ne mettez pas ce drapeau, VBoxManage attendra
                  que toute la mise à jour des suppléments invité s'achève.</para>
                </glossdef>
              </glossentry>
            <glossentry>
                <glossterm>[-- [&lt;argument1s&gt;] ... [&lt;argumentNs&gt;]]</glossterm>

                <glossdef>
.                  <para>Arguments en ligne de commandes à utiliser avec l'installeur
                  des suppléments invité. Sert à ajouter des fonctions non
                  installées précédemment sur l'invité.</para>
                  <para>Vous devez entourer les arguments contenant des espaces
                  par des guillemets.</para>
                </glossdef>
              </glossentry>
            </glosslist></para>
        </listitem>

        <listitem>
          <para><emphasis role="bold"><computeroutput>watch</computeroutput></emphasis>,
          qui affiche un contrôle de l'activité actuelle de l'invité.</para>

          <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; watch
          [--verbose]</screen>

          <para>où les paramètres signifient : <glosslist>
            <glossentry>
              <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>

              <glossdef>
                <para>L'UUID ou le nom de la VM. Obligatoire.</para>
              </glossdef>
            </glossentry>

            <glossentry>
              <glossterm><computeroutput>--verbose</computeroutput></glossterm>

              <glossdef>
                <para>Dit à VBoxManage d'être plus verbeux.</para>
              </glossdef>
            </glossentry>
          </glosslist></para>
        </listitem>
      </itemizedlist></para>
  </sect1>

  <sect1 id="vboxmanage-debugvm">
    <title>VBoxManage debugvm</title>

    <para>Les commandes "debugvm" sont pour les experts qui veulent jouer avec
    les détails exacts de l'exécution d'une machine virtuelle. Comme le débogueur
    de la VM décrit au <xref linkend="ts_debugger" />, ces commandes ne sont
    utiles que si vous êtes très familier des détails l'architecture d'une VM et
    de la façon de déboguer un logiciel.</para>

    <para>Les sous-commandes de "debugvm" fonctionnent sur une machine virtuelle
    en fonction. Celles suivantes sont disponibles&#xA0;:<itemizedlist>
        <listitem>
          <para>Avec <computeroutput>dumpguestcore --filename
          &lt;nom&gt;</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&#x153;ur standard (avec des sections
          personnalisées)&#xA0;; 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&#xA0;: 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&#xA0;:
          <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&#xA0;:
          <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 id="metrics">
    <title>VBoxManage metrics</title>

    <para>Cette commande supporte la surveillance de l'utilisation des ressources
    système. Les ressources sont représentées par diffé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&#xA0;;
    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&#xA0;:</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&#xA0;:
    <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&#xA0;:</para>

    <screen>VBoxManage metrics query test CPU/Load/User,CPU/Load/Kernel</screen>

    <para>La liste suivante résume les sous-commandes disponibles&#xA0;:</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&#xA0;:<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 &lt;nom_réseau&gt;</computeroutput>, où
          <computeroutput>&lt;nom_réseau&gt;</computeroutput> est le même nom 
          de réseau que celui que vous avez utilisé avec 
          <computeroutput>VBoxManage modifyvm
          &lt;nomvm&gt; --intnet&lt;X&gt;
          &lt;nom_réseau&gt;</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 &lt;hostonly_if_name&gt;</computeroutput>, où
          <computeroutput>&lt;hostonly_if_name&gt;</computeroutput> est le même
          nom de l'interface host-only que vous avez utilisé avec
          <computeroutput>VBoxManage modifyvm &lt;nomvm&gt;
          --hostonlyadapter&lt;X&gt;
          &lt;hostonly_if_name&gt;</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&#xA0;;
          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&#xA0;:<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
    &lt;nom_réseau&gt;</computeroutput> ou <computeroutput>--ifname
    &lt;hostonly_if_name&gt;</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 &lt;.vbox-extpack&gt;</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
          &lt;nom&gt;</computeroutput>. Vous pouvez utiliser
          <computeroutput>VBoxManage list extpacks</computeroutput> tpour
          afficher les noms des pack d'extensions actuellement installés&#xA0;;
          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&#xA0;:<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>
