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