supprime le message, mais l'utilisateur peut encore appuyer sur F12
pour sélectionner un périphérique de démarrage temporaire.</
para>
<
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>Remarquez que cette option n'a d'effet que quand le démarrage
Intel PXE ROM est utilisé.
<
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>
<
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>
<
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>
<
para><
computeroutput>--guestmemoryballoon
<taille></
computeroutput> définit la taille par défaut de la
mémoire du ballon de l'invité c'est-à-dire la mémoire affectée
par les suppléments invité de VirtualBox à partir du szstème d'exploitation
invité et rendue à l'hyperviseur pour être réutilisée par d'autres
machines virtuelles. <taille> doit être spécifiée en mégaoctets.
La taille par défaut est de 0 mégaoctets. Pour les
détails, voir <
xref linkend="guestadd-balloon" />.</
para>
<
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>
<
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
<
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
<
xref linkend="vboxmanage-startvm" /> pour des détails.</
para>
<
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>
<
para><
computeroutput>--nic<1-N>
none|null|nat|bridged|intnet|hostonly|generic
</
computeroutput> : Avec cela, vous pouvez définir, pour chacune
des cartes réseaux virtuelles de la VM, le type de réseau qui devrait
être disponible. Ils peuvent ne pas être présents
(<
computeroutput>none</
computeroutput>), non connectés à l'hôte
(<
computeroutput>null</
computeroutput>), utiliser le network
address translation (<
computeroutput>nat</
computeroutput>),
le réseau bridgé (<
computeroutput>bridged</
computeroutput>) ou
communiquer avec d'autres machines virtuelles en utilisant le réseau
internal (<
computeroutput>intnet</
computeroutput>), le réseau
host-only (<
computeroutput>hostonly</
computeroutput>), ou accéder
à des sous-modes rarement utilisés (<
computeroutput>generic</
computeroutput>).
Ces options correspondent aux modes décrits en détail au <
xref linkend="networkingmodes" />.</
para>
<
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>
<
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>
<
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>
<
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>
<
para><
computeroutput>--hostonlyadapter<1-N>
none|<nompériphérique></
computeroutput> : Si le réseau
host-only a été activé pour une carte réseau virtuelle (voir l'option
--nic ci-dessus ; sinon ce paramètre n'a aucun effet), utilisez
cette option spécifier l'interface réseau host-only qu'utilisera
l'interface réseau donnée. Pour des détails, merci de voir <
xref linkend="network_hostonly" />.</
para>
<
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>
<
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>
<
para><
computeroutput>--nicgenericdrv<1-N>
<pilote fondation></
computeroutput> : Si le réseau
générique a été activée pour une carte réseau virtuelle (voir l'option
<
computeroutput>--nic</
computeroutput> ci-dessus ; sinon ce paramètre
n'a aucun effet), ce mode vous permet d'accéder à des sous-modes
réseaux rarement utilisés, tels que le réseau VDE ou le tunnel UDP.
<
para><
computeroutput>--nicproperty<1-N>
<nomparam>="paramvaleur"</
computeroutput> :
Cette option, associée avec "nicgenericdrv", vous permet de
passer des paramètres aux fondations réseaux rarement utilisées.</
para><
para>
Ces paramètres sont des fondations spécifiques au moteur et sont
différentes entre les pilotes de la foncation du tunnel UDP et du
VDE. Par exemple,merci de voir <
xref linkend="network_udp_tunnel" />.
<
title>Paramètres du réseau NAT.</
title>
<
para>Les paramètres de réseau NAT suivants sont disponibles via
<
computeroutput>VBoxManage modifyvm</
computeroutput>. Avec tous ces
paramètres, le numéro décimale suivant le nom de l'option ("1-N"
dans la liste ci-dessous) spécifie l'adaptateur réseau virtuel que
devrait modifier ces paramètres.<
itemizedlist>
<
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>
<
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>
<
para><
computeroutput>--nattftpprefix<1-N>
<préfixe></
computeroutput> : Cette option définit un
préfixe pour le serveur TFTP intégré, à savoir là où se trouve le
fichier de démarrage (merci de voir <
xref linkend="nat-tftp" /> and <
xref linkend="nat-adv-tftp" /> pour les détails).</
para>
<
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>
<
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>
<
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>
<
para><
computeroutput>--natdnsproxy<1-N>
on|off</
computeroutput> : Cette option fait faire du proxy au
moteur NAT pour toutes les requêtes DNS de l'invité adressées au serveur DNS
de l'hôte (merci de voir <
xref linkend="nat-adv-dns" /> pour des
<
para><
computeroutput>--natdnshostresolver<1-N>
on|off</
computeroutput> : Cette option fait utiliser par le
moteur NAT le mécanismes de résolveur de l'hôte pour gérer les
requêtes DNS (merci de voir <
xref linkend="nat-adv-dns" /> pour les détails).</
para>
<
para><
computeroutput>--natnatsettings<1-N>
[<mtu>],[<socksnd>],[<sockrcv>],[<tcpsnd>],
[<tcprcv>]</
computeroutput> : Cette option contrôle
plusieurs paramètres NAT (merci de voir <
xref linkend="nat-adv-settings" />
pour les détails).</
para>
<
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>
<
sect2 id="vboxmanage-modifyvm-other">
<
title>Options du port série, du son, du presse-papier et de l'USB</
title>
<
para>Les autres paramètres matériels suivants sont disponibles avec
<
computeroutput>VBoxManage modifyvm</
computeroutput> :<
itemizedlist>
<
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>
<
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>
<
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>
<
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>
<
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>
<
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>
<
para><
computeroutput>--audio none|null|oss</
computeroutput> :
Avec cette option, vous pouvez définir si la VM supporte le son.</
para>
<
para><
computeroutput>--clipboard
disabled|hosttoguest|guesttohost|bidirectional</
computeroutput> :
Avec ce paramètre, vous pouvez sélectionner si le presse-papier du
système d'exploitation invité doit être partagé avec l'hôte ; voir
<
xref linkend="generalsettings" />. Cela exige que les suppléments
invité soient installés dans la machine virtuelle.</
para>
<
para><
computeroutput>--monitorcount
<nombre></
computeroutput> : Cela active le support multi-monitoeurs ;
voir <
xref linkend="settings-display" />.</
para>
<
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>
<
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>
<
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>
<
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>
<
para><
computeroutput>--vrdeport
default|<ports></
computeroutput> : Un port ou une plage
deports que le serveur VRDE peut sonder ; "default" ou "0"
signifient le port 3389, le port RDP standard. Vous pouvez spécifier
une liste de ports ou de plages de ports séparée par des virgules.
Utilisez un tiret entre de numéros de ports pour spécifier une plage.
Le serveur VRDE sondera <
emphasis role="bold">un</
emphasis> des
ports disponibles dans la liste spécifiée. Une seule machine peut utiliser
un port donné en même temps. Par exemple, l'option <
computeroutput> --vrdeport
5000,5010-5012</
computeroutput> dira au serveur de sonder un des ports
suivants : 5000, 5010, 5011 ou 5012.</
para>
<
para><
computeroutput>--vrdeaddress <adresse IP
></
computeroutput> : L'adresse IP de l'interface réseau de
l'hôte que sondera le serveur VRDE. Si vous la spécifiez, leserveur
n'acceptra les connexions que sur l'interface de l'hôte spécifiée.</
para>
<
para>On peut utiliser ce paramètre pour indiquer si le serveur
VRDP devrait accepter des donnexions IPv4, IPv6 ou les deux :
<
para>IPv4 seulement : <
computeroutput>--vrdeaddress "0.0.0.0"
<
para>IPv6 seulement : <
computeroutput>--vrdeaddress "::"
<
para>IPv6 et IPv4 (par défaut) : <
computeroutput>--vrdeaddress ""
<
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>
<
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>
<
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é
<
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>
<
para><
computeroutput>--vrdevideochannelquality
<pourcent></
computeroutput> : Définit la qualité de l'image
dans la redirection graphique ; voir <
xref lang="" linkend="vrde-videochannel" />.</
para>
<
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>
<
para><
computeroutput>--teleporter on|off</
computeroutput> : Avec
ce paramètre, vous activez ou désactivez l'attente par une machine
d'une requête de téléportation venant du réseau lorsqu'elle est
démarrée. Si elle est activée, quand on démarre la machine, cela ne
démarre pas la machine virtuelle comme cela est normalement le cas,
mais cela attend qu'une requête de téléportation n'arrive à l'adresse
listée avec les deux options suivantes.</
para>
<
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
<
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
<
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>
<
para><
computeroutput>--cpuid <leaf> <eax> <ebx>
<ecx> <edx></
computeroutput> : Les utilisateurs
avancés peuvent utiliser cette commande avant une opération de
téléportation pour restreindre les possibilités du processeur virtuel
présenté par VirtualBox au système d'exploitation invité. Il faut
l'exécuter à la fois sur la machine source et cible.
impliquées dans la téléportation et cela modifiera ce que l'invité
verra quand il exécutera l'instruction machine
<
computeroutput>CPUID</
computeroutput>. Cel pourrait aider les applications
se comportant mal à cause d'un mauvais présupposé sur la présence de
certaines capacités du processeur. La signification des paramètres
dépend do matériel ; merci de vous reporter aux manuels des
processeurs AMD ou Intel.</
para>
<
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>
<
para><
computeroutput>--snapshot <uuid>|<nom></
computeroutput> :
Sélectionne un instantané spécifique auquel se reporte le processus
de clonage. Par défaut, c'est à l'état courant qu'il se réfère.</
para>
<
para><
computeroutput>--mode machine|machineandchildren|all</
computeroutput> :
Sélectionne le mode de clonage. Si
<
computeroutput>machine</
computeroutput> est sélectionnée (comme par
défaut), l'état actuel de la VM sans instantanés est cloné. En mode
<
computeroutput>machineandchildren</
computeroutput>, l'instantané
fourni par <
computeroutput>--snapshot</
computeroutput> et tous les
instantanés fils sont clonés. Si vous
sélectionnez le mode <
computeroutput>all</
computeroutput>, tous les
instantanés de l'état actuel seront clonés.
<
para><
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
<
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>
<
para><
computeroutput>--basefolder <basefolder></
computeroutput> :
Sélectionne le dossier où devrait être sauvegardée la configuration.</
para>
<
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>
<
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>
<
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
<
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
<
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
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>")
(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")
(disable with "--vsys 0 --unit 6 --ignore")
7: Network adapter: orig bridged, config 2, extra type=bridged
(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")
(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 id="vboxmanage-export">
<
title>VBoxManage export</
title>
<
para>Cette commande exporte une ou plusieurs machines virtuelles à partir
de VirtualBox vers un applicatif virtuel au format OVF, ce qui inclut la
copie de leurs images de disque virtuel en VMDK compressé. Voir <
xref linkend="ovf" />
pour une présentation des applicatifs.</
para>
<
para>La commande <
computeroutput>export</
computeroutput> est simple à
utiliser : affichez la machine (ou les machines) que vous voulez
exporter dans un même fichier OVF et spécifiez le fichier OVF cible après
l'option facultative <
computeroutput>--output</
computeroutput> ou
<
computeroutput>-o</
computeroutput>. Remarquez que le répertoire du fichier
cible OVF recevra également les images de disques exportés au format VNDK
compressé (quel que soit le format d'origine) et vous devriez leur laisser
assez d'espace disque.</
para>
<
para>Derrière une simple exportation d'une machine virtuelle donnée, vous
pouvez ajouter diverses informations produit dans le fichier applicatif.
Utilisez <
computeroutput>--product</
computeroutput>,
<
computeroutput>--producturl</
computeroutput>,
<
computeroutput>--vendor</
computeroutput>,
<
computeroutput>--vendorurl</
computeroutput> et
<
computeroutput>--version</
computeroutput> pokr spécifier les
informations supplémentaires. Pour des raisons légales, vous pouvez ajouter
un texte de licence ou le contenu d'un fichier de licence en utilisant
respectivement les options <
computeroutput>--eula</
computeroutput> et
<
computeroutput>--eulafile</
computeroutput>. Comme avec l'importation
OVF, vous devez utiliser l'option <
computeroutput>--vsys X</
computeroutput>
pour adresser les options précitées à la bonne
machine virtuelle.</
para>
<
para>Pour les produits de virtualisation non pleinement compatibles avec
le standard OVF 1.0, vous pouvez activer un mode OVF 0.9 basique avec
l'option <
computeroutput>--legacy09</
computeroutput>.</
para>
<
sect1 id="vboxmanage-startvm">
<
title>VBoxManage startvm</
title>
<
para>Cette commande démarre une machine virtuelle qui est en état "Éteinte"
<
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 sont
acceptés par la variante d'un produit.</
para>
<
para>La valeur par défaut, globale ou individuelle à une VM, du type
d'interface d'une VM sera utilisée si vous ne spécifiez pas explicitement
le type. Si aucune n'est définie, c'est la variante GUI qui sera démarrée.</
para>
<
para>Les valeurs suivantes sont autorisées :</
para>
<
glossterm>gui</
glossterm>
<
para>Démarre une VM en affichant une fenêtre graphique. C'est le cas
<
glossterm>headless</
glossterm>
<
para>Démarre une VM sans fenêtre pour un affichage distant.</
para>
<
glossterm>sdl</
glossterm>
<
para>Démarre une VM avec une GUI minimale et limitée dans ses
<
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>
<
sect1 id="vboxmanage-controlvm">
<
title>VBoxManage controlvm</
title>
<
para>La sous-commande <
computeroutput>controlvm</
computeroutput> vous permet
modifier l'état d'une machine virtuelle en fonction. Vous pouvez spécifiar
ce qui suit :</
para>
<
para><
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
<
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
<
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>
<
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>
<
para><
computeroutput>VBoxManage controlvm <vm>
savestate</
computeroutput> sauvegardera l'état actuel de la VM sur le
disque et arrêtera la VM. (Cela revient à sélectionner l'élément
"Fermer" du menu "Machine" de l'interface graphique ou à appuyer sur
le bouton fermer de la fenêtre et sélectionner "Sauvegarder l'état de
la machine" dans la boîte de dialogue.)</
para>
<
para>Après cela, l'çtat de la machine sera "Sauveegardé". À partir de
là, vous pouvez la relancer ; voir
<
xref linkend="vboxmanage-startvm" />.</
para>
<
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" />
<
para>Quelques options supplémentaires sont disponibles avec
<
computeroutput>controlvm</
computeroutput>, ne modifiant pas directement
l'état de la VM en fonction :</
para>
<
para>L'opération <
computeroutput>setlinkstate<1-N></
computeroutput>
connecte ou déconnecte les câbles réseaux virtuels à leurs interfaces
<
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
(<
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
(<
computeroutput>generic</
computeroutput>). Ces options correspondent
aux modes décrits en détails au <
xref linkend="networkingmodes" />.</
para>
<
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>
<
para><
computeroutput>vrde on|off</
computeroutput> vous permet d'activer
ou de désactiver le serveur VRDP s'il est installé.</
para>
<
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>
<
para><
computeroutput>setvideomodehint</
computeroutput> demande
que le système invité passe dans un mode graphique particulier. Cela exige
l'installation des suppléments invité et ne fonctionner pas pour tous
les systèmes invités.</
para>
<
para><
computeroutput>screenshotpng</
computeroutput> prend une impression
écran de l'affichage invité et le sauvegarde au format PNG.</
para>
<
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>
<
para>L'opération <
computeroutput>guestmemoryballoon</
computeroutput>
modifie la taille du ballon de la mémoire de l'invité, c'est-à-dire la
mémoire affectée par les suppléments invité de VirtualBox au système
d'exploitation invité et rendue à l'hyperviseur pour être réutilisée
par d'autres machines virtuelles. Elle doit être spécifiée en mégaoctets.
Pour des détails, voir <
xref linkend="guestadd-balloon" />.</
para>
<
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>
<
title>VBoxManage discardstate</
title>
<
para>Cette commande désactive l'état sauvegardé d'une machine virtuelle
qui n'est pas en fonction, ce qui fera redémarrer son système d'exploitation
la prochaine fois que vous démarrerez. Cela revient à débrancher le câble
d'alimentation d'une machine physique et vous devrieu l'éviter si possible.</
para>
<
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>
<
title>VBoxManage snapshot</
title>
<
para>Cette commande est utilisée pour contrôler les instantanés en ligne de
commande. Un instantané consiste en une copie complète des paramètres de la
machine virtuelle, copiés à un moment où l'instantané a été pris, et éventuellement
un fichier d'état sauvegardé de la machine virtuelle si l'instantané a été
pris alors que la machine était en fonction. Après qu'un instantné a été pris,
VirtualBox cre un disque dur de différenciatin pour chaque disque dur normal
associé à la machine pour que, quand on restaure un instantané, les disques durs
virtuels de la machine virtuelle puissent être rapidement réinitialisés en
reabandonnant simplement les fichiers de différenciation.</
para>
<
para>L'opération <
computeroutput>take</
computeroutput> prend un instantané de
l'état actuel de la machne viruelle. Vous devez fournir un nom pour l'instantané
et vous pouvez éventuellement entrer une description. Le nouvel instantané est
inséré à l'arborescence des instantanés comme un fichier de l'instantané
actuel et il devient le nouvel instantané actuel.</
para>
<
para>L'opération <
computeroutput>delete</
computeroutput> efface un
instantané (spécifié par son nom ou son UUID). Cela peut être long à se
terminer car les images de différenciation associées à l'instantané pourraient
devoir être synchronisées avec leurs images de différenciation filles.</
para>
<
para>L'opération <
computeroutput>restore</
computeroutput> restaurera l'instantané
donné (spécifié par son nom ou son UUID) en réinitialisant les paramètres
de la machine virtuelle et l'état actuel à ceux de l'instantané. L'état
actuel précédent de la machine sera perdu. Après cela, l'instantané donné
devient le nouvel instantané "actuel" pour que les instantanés consécutifs
s'insèrent sous l'instantané à partir duquel on a restauré.</
para>
<
para>L'opération <
computeroutput>restorecurrent</
computeroutput> est un
raccourci pour restaurer l'instantané actuel (donc l'instantané d'où provient
l'état actuel). Cette sous-commande revient à utiliser la sous-commande
"restore" avec le nom ou l'UUID de l'instantané actuel, sauf qu'elle évite
l'étape supplémentaire de déterminer ce nom ou cet UUID.</
para>
<
para>Avec l'opération <
computeroutput>edit</
computeroutput>, vous pouvez
modifier le nom ou la description d'un instantané existant.</
para>
<
para>Avec l'opération <
computeroutput>showvminfo</
computeroutput>, vous
pouvez voir les paramètres de la machine virtuelle stockées dans un instantané
<
sect1 id="vboxmanage-closemedium">
<
title>VBoxManage closemedium</
title>
<
para>Cette commande supprime un fichier image de disque dur, de DVD ou
disquette, d'un registre de médias VirtualBox.<
footnote>
<
para>Avant VirtualBox 4.0, il fallait appeler VBoxManage
openmedium avant de pouvoir attacher à média à une machine virtuelle ;
cet appel "enregistrait" le média avec le registre des médias global de
VirtualBox. Avec VirtualBox 4.0, ce n'est plus nécessaire ; les
médias sont ajoutés aux registres des médias automatiquement. L'appel
"closemedium" a cependant été conservé pour permettre de supprimer
explicitement un média du registre.</
para>
<
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 id="vboxmanage-storageattach">
<
title>VBoxManage storageattach</
title>
à un contrôleur de stockage précédemment ajouté avec la commande
<
computeroutput>storagectl</
computeroutput> command (voir la section précédente).
La syntaxe est ainsi :</
para>
<
screen>VBoxManage storageattach <uuid|nomvm>
--storagectl <name>
[--device <number>]
[--type dvddrive|hdd|fdd]
[--medium none|emptydrive|
<uuid>|<filename>|host:<drive>|iscsi]
[--mtype normal|writethrough|immutable|shareable]
[--setparentuuid <uuid>]
[--bandwidthgroup name|none]
[--server <name>|<ip>]
[--target <target>]
[--encodedlun <lun>]
[--username <username>]
[--password <password>]
[--initiator <initiator>]
<
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>
<
glossterm>uuid|nomvm</
glossterm>
<
para>Le nom ou l'UUID de la VM. Obligatoire.</
para>
<
glossterm>storagectl</
glossterm>
<
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>
<
glossterm>port</
glossterm>
<
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
<
glossterm>device</
glossterm>
<
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>
<
glossterm>type</
glossterm>
<
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>
<
glossterm>medium</
glossterm>
<
para>Spécifie ce qu'il faut attacher. Les valeurs suivantes sont
supportées :<
itemizedlist>
<
para>"none" : Tout périphérique existant serait supprimé du
<
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>
<
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>
<
para>Si vous spécifiez un UUID, il doit s'agir de l'UUID d'un
média de stockage déjà connu de VirtualBox (par exemple car il
a été attaché à une autre machine virtuelle). Voir
<
xref linkend="vboxmanage-list" /> pour la façon de lister
les médias connus. Ce média est alors attaché au slot du
périphérique donné.</
para>
<
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>
<
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>
<
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>
<
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>
<
glossterm>mtype</
glossterm>
<
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" />
<
glossterm>comment</
glossterm>
<
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>
<
glossterm>setuuid, setparentuuid</
glossterm>
<
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>
<
glossterm>passthrough</
glossterm>
<
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>
<
glossterm>tempeject</
glossterm>
<
para>Seulement pour un lecteur DVD virtuel, vous pouvez configurer
le comportement pour avoir l'éjection du média synchrnmiùe avec l'invité.
Si vous l'activez, l'éjection n'a qu'un effet temporaire. Si vous
éteignez puis redémarrez la VM, le média configuré au départ sera
toujours dans le lecteur.</
para>
<
glossterm>nonrotational</
glossterm>
<
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>
<
glossterm>bandwidthgroup</
glossterm>
<
para>Définit le groupe de bande passante à utiliser pour le
périphérique donné ; voir <
xref linkend="storage-bandwidth-limit" />.</
para>
<
glossterm>forceunmount</
glossterm>
<
para>Seulement pour un lecteur DVD ou amovible virtuel, cela démonte
même si celui précédent est verrouillé en lecture par l'invité.
De nouveau, voir <
xref linkend="storage-cds" /> pour des détails.</
para>
<
para>Quand on utilise "iscsi" avec le paramètre
<
computeroutput>--medium</
computeroutput> pour le support iSCSI --
see <
xref linkend="storage-iscsi" /> --, vous pouvez ou devez utiliser
des paramètres supplémentaires :<
glosslist>
<
glossterm>server</
glossterm>
<
para>Le nom de l'hôte ou l'adresse IP de la cible iSCSI ;
<
glossterm>target</
glossterm>
<
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 ;
<
glossterm>tport</
glossterm>
<
para>Numéro de port
TCP/
IP du service iSCSI sur la cible (facultatif).</
para>
<
glossterm>lun</
glossterm>
<
para>Numéro d'unité logique de la ressource cible (facultatif).
Souvent, cette valeur vaut zéro.</
para>
<
glossterm>username, password</
glossterm>
<
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>
<
glossterm>intnet</
glossterm>
<
para>Si vous le spécifiez, connecte à la cible iSCSI via le réseau
interne. Cela nécessite une configuration supplémentaire décrite au
<
xref linkend="iscsi-intnet" />.</
para>
<
sect1 id="vboxmanage-storagectl">
<
title>VBoxManage storagectl</
title>
Après elle, on peut attacher des médias virtuels au contrôleur avec la
commande <
computeroutput>storageattach</
computeroutput> (voir la prochaine
<
para>La syntaxe est comme suit :</
para>
<
screen>VBoxManage storagectl <uuid|nomvm>
[--controller <LsiLogic|LSILogicSAS|BusLogic|
IntelAhci|PIIX3|PIIX4|ICH6|I82078>]
[--sataportcount <1-30>]
<
para>où les paramètres signifient : <
glosslist>
<
glossterm>uuid|nomvm</
glossterm>
<
para>Nom ou UUID de la VM. Obligatoire.</
para>
<
glossterm>nom</
glossterm>
<
para>Nom du contrôleur de stockage. Obligatoire.</
para>
<
glossterm>add</
glossterm>
<
para>Définit le type de bus système auquel doit être connecté le
contrôleur de stockage.</
para>
<
glossterm>controller</
glossterm>
<
para>Permet de choisir le type de chipset à émuler pour le
contrôleur de stockage donné.</
para>
<
glossterm>sataportcount</
glossterm>
<
para>Ceci détermine le nombre de ports que le contrôleur SATA
devrait supporter.</
para>
<
glossterm>hostiocache</
glossterm>
<
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,
linkend="iocaching" />.</
para>
<
glossterm>bootable</
glossterm>
<
para>Sélectionne si ce contrôleur est amorçable.</
para>
<
glossterm>remove</
glossterm>
<
para>Supprime le contrôleur de stockage de la config de la VM.</
para>
<
title>VBoxManage bandwidthctl</
title>
passante de la machine virtuelle donnée :<
screen>VBoxManage bandwidthctl <uuid|nomvm>
add <nom> --type disk|network --limit <megabytes per second>[k|m|g|K|M|G] |
set <nom> --limit <megabytes per second>[k|m|g|K|M|G] |
list [--machinereadable]</
screen></
para>
<
para>Les sous-commandes suivantes sont disponibles :<
itemizedlist>
<
para><
computeroutput>add</
computeroutput>, crée un nouveau groupe de
dande passante d'un type doné.</
para>
<
para><
computeroutput>set</
computeroutput>, modifie la limite d'un groupe
de bande passante existante.</
para>
<
para><
computeroutput>remove</
computeroutput>, détruit un groupe de
<
para><
computeroutput>list</
computeroutput>, affiche tous les groupes
de bande passante définis pour la VM donnée.</
para>
<
para>Les paramètres signifient :<
glosslist>
<
glossterm>uuid|nomvm</
glossterm>
<
para>Le nom ou l'UUID de la VM. Obligatoire.</
para>
<
glossterm>nom</
glossterm>
<
para>Nom du groupe de bande passante. Obligatoire.</
para>
<
glossterm>type</
glossterm>
<
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
<
glossterm>limit</
glossterm>
<
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>
<
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
<
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>
<
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>
<
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
<
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
<
sect1 id="vboxmanage-createvdi">
<
title>VBoxManage createhd</
title>
<
para>Cette commande crée une nouvelle de disque dur virtuel. La
syntaxe est comme suit :</
para>
<
screen>VBoxManage createhd --filename <filename>
[--format VDI|VMDK|VHD] (par défaut : VDI)
[--variant Standard,Fixed,Split2G,Stream,ESX]</
screen>
<
para>où les paramètres signifient :<
glosslist>
<
glossterm>filename</
glossterm>
<
para>Permet de choisir un nom de fichier. Obligatoire.</
para>
<
glossterm>size</
glossterm>
<
para>Permet de définir la capacité de l'image, en MiO.
<
glossterm>format</
glossterm>
<
para>Permet de choisir un format de fichier pour le fichier
de sortie, différent du format du fichier d'entrée.</
para>
<
glossterm>variant</
glossterm>
<
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>
<
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>
<
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|
[--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>
<
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
<
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
<
para>Les options suivantes sont disponibles :<
itemizedlist>
<
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>
<
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,
<
para>L'option <
computeroutput>--compact</
computeroutput>,
peut être utilisée pour compresser des images de disque (à savoir
supprimer des blocs qui ne contiennent que des zéros). Cela réallègera
une image à taille dynamique ; cela réduira la taille
<
emphasis>physique</
emphasis> de l'image sans changer la taille logique
du disque virtuel. La compression fonctionne aussi bien pour les images
de base que celles de différenciation créées dans un instantané.</
para>
<
para>Pour que l'opération soit efficace, il faut d'abord libérer de
l'espace dans le système invité en y mettant des zéros via le logiciel
adapté. Pour les invités Windows, vous pouvez utiliser l'outil
<
computeroutput>sdelete</
computeroutput> de Microsoft.
Exécutez <
computeroutput>sdelete -z</
computeroutput> dans l'invité pour
mettre des zéros dans l'espace libre avant de compresser l'image de
disque virtuel. Pour Linux, utilisez l'outil
<
code>zerofree</
code> qui supporte les systèmes de fichiers s
ext2/
ext3.
Pour les invités Mac OS X, utilisez utilisez la fonction <
emphasis>Supprimer l'espace libre</
emphasis> de
<
emphasis>l'outil de disque</
emphasis> intégré. Utilisez-y
<
emphasis>Zero Out Data</
emphasis>.</
para>
<
para>Remarquez que la compression n'est actuellement disponible que
pour les images VDI. Vous pouvez obtenir la même chose en mettant des
zéros sur les blocs libres et clonant le disque vers un autre format
dynamique. Vous pouvez utiliser ce contournement jusqu'à ce que la
compression soit supportée pour les autres formats de disque que VDI.</
para>
<
para>L'option <
computeroutput>--resize x</
computeroutput> (où x est
le nouvel espace total désiré en <
emphasis role="bold">mégaoctets</
emphasis>)
vous permet de modifier la capacité d'une image existante ; ceci
ajuste la taille <
emphasis>logique</
emphasis> d'un disque virtuel sans
beaucoup changer la taille physiqu.<
footnote>
<
para>Le redimensionnement d'images a été ajouté à VirtualBox 4.0.</
para>
</
footnote> Cela ne fonctionne actuellement que pour les formats
VDI et VHD et pour les variantse, à taille dynamique, et vous ne
pouvez l'utiliser que pour augmenter (ou réviser) la capacité.
Par exemple, si vous avez créé au départ un disque de 10G à présent
plein, vous pouvez utiliser la commande <
computeroutput>--resize 15360</
computeroutput>
pour passer la capacité à 15G (15,360Mo) sans devoir créer une nouvelle
image et y copier toutes les données à partir d'un e machine virtuelle.
Cependant, remarquez que cela ne change que la capacité du lecteur ;
vous devrez ensuite, en général, utiliser un outil de gestion des
partitions dans l'invité pour ajuster la partition principale et
remplir le lecteur.</
para><
para>L'option <
computeroutput>--resizebyte x</
computeroutput>
fait presque la même chose mait x est exprimé en octets au lieu de
<
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
<
screen>VBoxManage clonehd <uuid>|<nomfichier> <outputfile>
[--format VDI|VMDK|VHD|RAW|<other>]
[--variant Standard,Fixed,Split2G,Stream,ESX]
<
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
<
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
<
para>Les options suivantes sont disponibles :<
glosslist>
<
glossterm>format</
glossterm>
<
para>Permet de choisir un format de fichier pour le fichier de
sortie, autre que celui du fichier d'entrée.</
para>
<
glossterm>variant</
glossterm>
<
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>
<
glossterm>existing</
glossterm>
<
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>
<
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>
<
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>
[--variant Standard,Fixed,Split2G,Stream,ESX]
VBoxManage convertfromraw stdin <fichiersortie> <octets>
[--variant Standard,Fixed,Split2G,Stream,ESX]
[--uuid <uuid>]</
screen>
<
para>où les paramètres signifient :<
glosslist>
<
glossterm>octets</
glossterm>
<
para>La taille du fichier image, en octets, fournie en entrée.</
para>
<
glossterm>format</
glossterm>
<
para>Sélectionnez le format de l'image de disque à créer. Par
défaut, c'est VDI.</
para>
<
glossterm>variant</
glossterm>
<
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>
<
glossterm>uuid</
glossterm>
<
para>Permet de spécifier l'UUID ou le fichier de sortie.</
para>
</
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>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>
<
para>Ces commandes vous permet d'attacher et de récupérer des chaînes de
données dans une machine virtuelle ou à une configuration de VirtualBox (en
spécifiant <
computeroutput>global</
computeroutput> au lieu d'un nom de machine
virtuelle). Vous pouvez spécifier une clé (comme chaîne de texte) pour
associer les données que vous pourrez récupérer plus tard. Par exemple :</
para>
<
screen>VBoxManage setextradata Fedora5 installdate 2006.01.01
VBoxManage setextradata SUSE10 installdate 2006.02.02</
screen>
<
para>associerait la chaîne "2006.01.01" à la clé installdate pour la
the machine virtuelle Fedora5, et "2006.02.02" pour la machine SUSE10. Vous
pourriez récupçrer l'information comme suit :</
para>
<
screen>VBoxManage getextradata Fedora5 installdate</
screen>
<
para>qui renverrait</
para>
<
screen>VirtualBox Command Line Management Interface Version $VBOX_VERSION_MAJOR.$VBOX_VERSION_MINOR.$VBOX_VERSION_BUILD
(C) 2005-$VBOX_C_YEAR $VBOX_VENDOR
Value: 2006.01.01</
screen>
<
para>To remove a key, the <
computeroutput>setextradata</
computeroutput>
command must be run without specifying data (only the key), for example:
<
screen>VBoxManage setextradata Fedora5 installdate</
screen>
<
sect1 id="vboxmanage-setproperty">
<
title>VBoxManage setproperty</
title>
<
para>Cette commande est utilisée pour modifier des paramètres globaux
qui modifient toute l'installation de VirtualBox. Certains d'entr eux
correspondent aux paramètres de la boîte de dialogue "Paramètres globaux" de
l'interface graphique. Les propriétés suivantes sont disponibles :<
glosslist>
<
glossterm>machinefolder</
glossterm>
<
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>
<
glossterm>vrdeauthlibrary</
glossterm>
<
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>
<
glossterm>websrvauthlibrary</
glossterm>
<
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>
<
glossterm>vrdeextpack</
glossterm>
<
para>Ceci spécifie la bibliothèque qui implémente l'extension Bureau
distant de VirtualBox.</
para>
<
glossterm>loghistorycount</
glossterm>
<
para>Ceci sélectionne le nombre de journaux de VMs (anciens)
<
glossterm>autostartdbpath</
glossterm>
<
para>Ceci sélectionne le chemin vers la base de données autostart.
Voir <
xref linkend="autostart" />.</
para>
<
glossterm>defaultfrontend</
glossterm>
<
para>Ceci sélectionne l'interface globale des VMs. Voir
<
xref linkend="vboxmanage-startvm" />.</
para>
<
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
<
para>Lors de la création d'un filtre USB en utilisant
<
computeroutput>usbfilter add</
computeroutput>, vous devez fournir trois ou
quatre paramètres obligatoires. L'index spécifie la position du filtre dans
la liste. S'il y a déjà un filtre à cette place, lui-mâme et les suivants
seront déplacés. Sinon, le nouveau filtre sera ajouté à la fin de laliste.
Le paramètre <
computeroutput>target</
computeroutput> sélectionne la
machine virtuelle à laquelle devrait être attaché le
filtre, sinon utilisez "global" pour l'appliquer à toutes les machines virtuelles.
<
computeroutput>name</
computeroutput> est le nom du nouveau filtre et
des filtres globaux, <
computeroutput>action</
computeroutput> autorise les
machines à accéder aux périphériques correspondant à la description du
filtre ("hold") ou ne leur donne pas accès ("ignore"). En outre, vous devriez
spécifier des paramètres de filtrage. Vous pouvez trouver les paramètres des
périphériques attachés à votre système en utilisant <
computeroutput>VBoxManage list usbhost</
computeroutput>.
Enfin, vous pouvez spécifier si le filtre devrait être actif, et pour les
filtres globaux, s'ils concernent les périphériques locaux, à distance (par
connexion RDP) ou autrement.</
para>
<
para>Quand vous modifiez un filtre USB en utilisant
<
computeroutput>usbfilter modify</
computeroutput>, vous devez spécifier le
filtre par index (voir la sortie de
<
computeroutput>VBoxManage list usbfilters</
computeroutput> pour voir les
indexes des filtres globaux et <
computeroutput>VBoxManage
showvminfo</
computeroutput> pour voir les indexes des machines individuelles),
et par cible, laquelle est soit une machine virtuelle, soit "global". Les
propriétés modifiables sont les mêmes que pour <
computeroutput>usbfilter
add</
computeroutput>. Pour supprimer un filtre, utilisez <
computeroutput>usbfilter
remove</
computeroutput> et spécifiez l'index et la cible.</
para>
<
sect1 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
<
para>Les dossiers partagés sont décrits en détails au <
xref linkend="sharedfolders" />.</
para>
<
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>
<
para><
computeroutput>enumerate <vm> [--patterns
<pattern>]</
computeroutput> : Ceci liste toutes les
propriétés invité disponibles pouq une VM donnée avec leur valeur.
Cette liste sera très limitée si le processus service de l'invité
ne peut pas être contacté, notamment car la VM n'est pa en fonction
ou les suppléments invité ne sont pas installés.</
para>
<
para>Si vous spécifiez <
computeroutput>--patterns
<échantillon></
computeroutput>, il agit comme un filtre pour ne
lister que les propriétés correspondant à l'échantillon donné. L'échantillon
peut contenir les caractères jokers suivants :<
itemizedlist>
<
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>
<
para><
computeroutput>?</
computeroutput> (point d'interrogation) :
représente un seul caractère de votre choix ; par exemple,
"<
computeroutput>fo?</
computeroutput>" correspondrait à "foo"
<
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>
<
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>
<
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>
<
para><
computeroutput>TRANSIENT</
computeroutput> : la
valeur ne sera pas stockée avec les données de la VM quand la
<
para><
computeroutput>TRANSRESET</
computeroutput> : la valeur
sera effacée dès que la VM redémarrera
et/
ou existera ;</
para>
<
para><
computeroutput>RDONLYGUEST</
computeroutput> : la
valeur ne peut être modifiée que par l'hôte, l'invité ne
peut que la lire ;</
para>
<
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>
<
para><
computeroutput>READONLY</
computeroutput> : la
combinaison des deux, la valeur ne peut pas être modifiée.</
para>
<
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>
<
para><
computeroutput>delete <vm> <propriété>
</
computeroutput> : Efface une propriété invité définie précédemment.</
para>
<
sect1 id="vboxmanage-guestcontrol">
<
title>VBoxManage guestcontrol</
title>
<
para>Les commandes "guestcontrol" vous permettent de contrôler certaines
choses de l'invité à partir de l'hôte. Merci de voir <
xref linkend="guestadd-guestcontrol" /> pour une présentation.</
para>
<
para>En général, la syntaxe est la suivante :</
para>
<
screen>VBoxManage guestcontrol <commande></
screen>
<
para>Les sous-commandes suivantes sont disponibles (où
<
computeroutput><vm></
computeroutput>, dans tous les cas, peut
être le nom ou l'UUID d'une VM comme avec les autres commandes de
VBoxManage) :<
itemizedlist>
<
para><
computeroutput>execute</
computeroutput>, qui permet d'exécuter un
Cette commande ne fonctionne que pendant qu'une VM est active et en
fonction et sa syntaxe est la suivante :</
para>
<
screen>VBoxManage guestcontrol <nomvm>|<uuid> exec[ute]
--image <chemin du programme> --username <nom>
[--passwordfile <fichier> | --password <mot de passe>]
[--environment "<NOM>=<VALEUR> [<NOM>=<VALEUR>]"]
[--verbose] [--timeout <msec>]
[--wait-exit] [--wait-stdout] [--wait-stderr]
[--dos2unix] [--unix2dos]
-- [[<argument1>] ... [<argumentN>]]</
screen>
<
para>où les paramètres signifient : <
glosslist>
<
glossterm>uuid|nomvm</
glossterm>
<
para>Le nom ou l'UUID de la VM. Obligatoire.</
para>
<
glossterm>--image "<chemin du programme>"</
glossterm>
<
para>Chemin absolu et nom du processus à exécuter dans
l'invité, comme <
computeroutput>C:\Windows\System32\
calc.exe</
computeroutput></
para>
<
glossterm>--username <nom></
glossterm>
<
para>Nom de l'utilisateur sous lequel devrait se lancer le
processus. Cet utilisateur doit exister sur l'OS invité.</
para>
<
glossterm>--passwordfile <fichier></
glossterm>
<
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>
<
glossterm>--password <mot de passe></
glossterm>
<
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>
<
glossterm>--dos2unix</
glossterm>
Convertit les fins de lignes de la sortie des invités
DOS/
Windows en fins compatibles UNIX (CR + LF -> LF). Pas encore implémenté.
"<NAME>=<VALUE>"</
glossterm>
<
para>Une ou plusieurs variables d'environnement à définir ou
<
para>Par défaut, le nouveau processus de l'invité sera
créé avec l'environnement standard de l'OS invité. Cette
option permet de modifier cet environnement. Pour dé
finir/
modifier une variable, une paire <
computeroutput>NOM=VALEUR</
computeroutput> doit
être spécifiée ; pour dérégler une certaine variable, le
nom sans valeur doit être défini, par exemple
<
computeroutput>NOM=</
computeroutput>.</
para>
<
para>Les arguments contenant des espaces doivent être entourés
de guillemets. Vous pouvez spécifier plus d'un
<
computeroutput>--environment</
computeroutput> en même temps
pour maintenir vierge la ligne de commande.</
para>
<
glossterm>--timeout <msec></
glossterm>
<
para>Valeur (ien millisecondes) qui spécifie la durée pendant
laquelle le processus démarré est autorisé à fonctionner et
combien de temps VBoxManage attent une sortie de ce processus.
Si vous ne spécifiez pas de timeout, VBoxManage attendra
jusqu'à ce que le processus démarré se termine ou ce qu'une
erreur ne survienne.</
para>
<
glossterm>--unix2dos</
glossterm>
Convertit les fins de lignes de la sortie des invités
DOS/
Windows en fins compatibles UNIX (CR + LF -> LF). Pas encore implémenté.
<
glossterm>--verbose</
glossterm>
<
para>Dit à VBoxManage d'être plus verbeux.</
para>
<
glossterm>--wait-exit</
glossterm>
<
para>Attend la fin d'un processus et affiche son code de
sortie avec la
raison/
les drapeaux de sa fin.</
para>
<
glossterm>--wait-stdout</
glossterm>
<
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>
<
glossterm>--wait-stderr</
glossterm>
<
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>
<
glossterm>[-- [<argument1s>] ... [<argumentNs>]]</
glossterm>
<
para>Un ou plusieurs arguments à passer au processus à
<
para>Les arguments contenant des espaces doivent être entourés
<
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>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>
<
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
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>
<
para><
computeroutput>copyto</
computeroutput>, qui permet de copier
des fichiers de l'hôte vers l'invité (seulement si les suppléments invité
4.0 et supérieur sont installés).</
para>
<
screen>VBoxManage guestcontrol <nomvm>|<uuid> copyto|cp
<source invité> <hôte dest> --username <nom>
[--passwordfile <fichier> | --password <mot de passe>]
[--dryrun] [--follow] [--recursive] [--verbose]</
screen>
<
para>où les paramètres signifient : <
glosslist>
<
glossterm>uuid|nomvm</
glossterm>
<
para>L'UUID ou le nom de la VM. Obligatoire.</
para>
<
glossterm>source sur l'hôte</
glossterm>
<
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>
<
glossterm>destination sur l'invité</
glossterm>
<
para>Chemin de destination absolu sur l'invité, comme
<
computeroutput>C:\Temp</
computeroutput></
para>
<
glossterm>--username <nom></
glossterm>
<
para>Nom d'utilisateur sous lequel devrait fonctionner le
processus de copie. Cet utilisateur doit exister sur l'OS
<
glossterm>--passwordfile <fichier></
glossterm>
<
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>
<
glossterm>--password <mot depasse></
glossterm>
<
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>
<
glossterm>--dryrun</
glossterm>
<
para>Dit à VBoxManage de ne faire qu'une exécution dry au
lieu de copier vraiment les fichiers dans l'invité.</
para>
<
glossterm>--follow</
glossterm>
<
para>Active le suivi des liens symboliques sur la
<
glossterm>--recursive</
glossterm>
<
para>Copie récursivement les fichiers/répertoires de la
<
glossterm>--verbose</
glossterm>
<
para>Dit à VBoxManage d'être plus verbeux.</
para>
<
glossterm>--flags <drapeaux></
glossterm>
<
para>Drapeaux supplémentaires à définir. Ce n'est pas utilisé
<
para><
computeroutput>copyfrom</
computeroutput>, qui permet de copier
des fichiers de l'invité vers l'hôte (seulement si les suppléments
invité 4.0 et supérieur sont installés). Il prend les mêmes paramètres
que <
computeroutput>copyto</
computeroutput> ci-dessus.</
para>
<
para><
computeroutput>createdirectory</
computeroutput>, qui permet de copier
des fichiers de l'invité vers l'hôte (seulement si les suppléments
invité 4.0 et supérieur sont installés). Il prend les mêmes paramètres
que <
computeroutput>copyto</
computeroutput> ci-dessus.</
para>
<
screen>VBoxManage guestcontrol <nomvm>|<uuid> createdir[ectory]|mkdir|md
<répertoire invité>... --username <nom>
[--passwordfile <fichier> | --password <mot de passe>]
[--parents] [--mode <mode>] [--verbose]</
screen>
<
para>où les paramètres signifient : <
glosslist>
<
glossterm>uuid|nomvm</
glossterm>
<
para>L'UUID ou le nom de la VM. Obligatoire.</
para>
<
glossterm>répertoire à créer sur l'invité</
glossterm>
<
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
<
glossterm>--username <nom></
glossterm>
<
para>Nom de l'utilisateur sous lequel devrait fonctionner
le processus de copie. Cet utilisateur doit exister sur l'OS
<
glossterm>--passwordfile <fichier></
glossterm>
<
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>
<
glossterm>--password <mot de passe></
glossterm>
<
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>
<
glossterm>--parents</
glossterm>
<
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>
<
glossterm>--mode <mode></
glossterm>
<
para>Définit les droits du répertoire spécifié. Seules des
<
computeroutput>0755</
computeroutput>) sont supportées pour l'heure.</
para>
<
glossterm>--verbose</
glossterm>
<
para>Dit à VBoxManage d'être plus verbeux.</
para>
<
para><
computeroutput>stat</
computeroutput>, qui affiche l'état d'un
fichier ou d'un gestionnaire de fichiers de l'invité.</
para>
<
screen>VBoxManage guestcontrol <nomvm>|<uuid> stat
<file>... --username <nom>
[--passwordfile <fichier> | --password <mot de passe>]
<
para>où les paramètres signifient : <
glosslist>
<
glossterm>uuid|nomvm</
glossterm>
<
para>L'UUID ou le nom de la VM. Obligatoire.</
para>
<
glossterm>élément(s) de fichier à vérifier sur l'invité</
glossterm>
<
para>Chemin absolu
du/
des répertoire(s) à vérifier sur l'invité,
L'utilisateur spécifié doit avoir les droits adéquats d'accès
à/aux élément(s) fichier unique(s).</
para>
<
glossterm>--username <nom></
glossterm>
<
para>Nom de l'utilisateur sous lequel devrait s'exécuter le
processus de copie. L'utilisateur doit exister sur l'OS invité.</
para>
<
glossterm>--passwordfile <fichier></
glossterm>
<
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>
<
glossterm>--password <mot de passe></
glossterm>
<
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>
<
glossterm>--verbose</
glossterm>
<
para>Dit à VBoxManage d'être plus verbeux.</
para>
<
para><
computeroutput>updateadditions</
computeroutput>, qui permet de
mettre à jour une version des suppléments invité installée sur l'invité
(sur les suppléments invité installés 4.0 et supérieur).</
para>
<
screen>VBoxManage guestcontrol <nomvm>|<uuid> updateadditions
[--source "<fichier des suppléments invité .ISO à utiliser>"] [--verbose]
[--wait-start] [-- [<argument1>] ... [<argumentN>]]</
screen>
<
para>où les paramètres signifient : <
glosslist>
<
glossterm>uuid|nomvm</
glossterm>
<
para>L'UUID ou le nom de la VM. Obligatoire.</
para>
<
glossterm>--source "<fichier des suppléments invité .ISO à
utiliser>"</
glossterm>
<
para>Chemin complet vers un autre fichier .ISO de suppléments
invité à utiliser pour mettre à jour les suppléments invité.</
para>
<
glossterm>--verbose</
glossterm>
<
para>Dit à VBoxManage d'être plus verbeux.</
para>
<
glossterm>--wait-start</
glossterm>
<
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>
<
glossterm>[-- [<argument1s>] ... [<argumentNs>]]</
glossterm>
. <
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>
<
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>
<
para>Avec <
computeroutput>dumpguestcore --filename
<nom></
computeroutput>, vous pouvez créer un fichier de renvoi
système de la VM en fonction, qui sera écrit dans le fichier donné.
Ce fichier aura un format ELF cœur standard (avec des sections
personnalisées) ; voir
<
xref linkend="ts_guest-core-format" />.</
para>
<
para>Cela correspond à la commande
<
computeroutput>writecore</
computeroutput> du débogueur.
<
para>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>
<
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>
<
para>La commande <
computeroutput>osdetect</
computeroutput> lance
la fonction de (re)-détection du débogueur de VMM du système d'exploitation
<
para>Cela correspond à la commande <
computeroutput>detect</
computeroutput>
<
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>
<
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
<
listitem><
computeroutput>nom-registre-processeur</
computeroutput></
listitem>
<
listitem><
computeroutput>all</
computeroutput></
listitem>
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>
<
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 :
<
listitem><
computeroutput>nom-registre-processeur=valeur</
computeroutput></
listitem>
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>
<
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>
<
title>VBoxManage metrics</
title>
<
para>Cette commande supporte la surveillance de l'utilisation des ressources
système. Les ressources sont représentées par différentes métriques associées
au système hôte ou à une VM en particulier. Par exemple, le système hôte a
une métrique <
computeroutput>
CPU/
Load/
User</
computeroutput> qui affiche le
pourcentage du temps procc!eur passé à tourner en mode utilisateur sur une
période spécifique.</
para>
<
para>Les données de métrique sont rassemblées et stockées en interne ;
vous pouvez les récupérer n'importe quand avec la sous-commande
<
computeroutput>VBoxManage metric query</
computeroutput>. Les données sont
disponibles tant que le processus en tâche de fond
<
computeroutput>VBoxSVC</
computeroutput> process is est vivant. Ce processus
ce termine peu après que toutes les VMs et les interfaces ont été fermées.</
para>
<
para>Par défaut, aucune métrique n'est enregistrée. La récupération de
métriques ne commence pas avant que <
computeroutput>VBoxManage metrics setup</
computeroutput>
ne soit appelé avec un bon intervalle modèle et que le nombre de métriques
n'a été conservé. On mesure l'intervalle en secondes. Par exemple, pour
activer la récupération des métriques de l'utilisation du processeur et de
la mémoire hôte toutes les secondes, en gardant les 5 échantillons les plus
actuels, vous pouvez utiliser la commande suivante :</
para>
<
screen>VBoxManage metrics setup --period 1 --samples 5 host
CPU/
Load,
RAM/
Usage</
screen>
<
para>Le recueil de métriques ne peut être activé que sur des VMs démarrées.
Les données et les paramètres de récupération d'une VM en particulier disparaîtront
dès que vous éteindrez la VM. Utilisez la sous-commande
<
computeroutput>VBoxManage metrics list
</
computeroutput> pour voir les métriques actuellement disponibles. Vous
pouvez aussi utiliser l'option <
computeroutput>--list</
computeroutput> avec
une sous-commande modifiant les paramètres de métrique pour chercher les
métriques concernées.</
para>
<
para>Remarquez que la sous-commande <
computeroutput>VBoxManage metrics
setup</
computeroutput> désactive tous les échantillons qui peuvent avoir été
recueillis pour un jeu d'objets et de métriques spécifique.</
para>
<
para>Pour activer ou désactiver la récupération des métriques sans perdre
les données, vous pouvez utiliser les sous-commandes
<
computeroutput>VBoxManage metrics enable</
computeroutput> et
<
computeroutput>VBoxManage metrics disable</
computeroutput>. Remarquez que
ces sous-commandes attendent en paramètres des métriques, pas des sous-métriques,
n'est pas supporté.</
para>
<
para>L'hôte et les VMs ont différents ensembles de métriques associées.
Vous pouvez lister les métriques disponibles avec
<
computeroutput>VBoxManage metrics
list</
computeroutput> subcommand.</
para>
<
para>Un nom de métrique complet peut inclure une fonction d'agrégat. Le
nom prend la forme suivante :
<
computeroutput>Catégorie/Métrique[/SousMétrique][:aggrégé]</
computeroutput>.
Par exemple, <
computeroutput>
RAM/
Usage/
Free:min</
computeroutput> signifie la
quantité minimum de mémoire disponible parmi toutes les données en mémoire
s, cela s'applique à l'objet hôte.</
para>
<
para>Les sous-commandes peuvent s'appliquer à tous les objets et les
métriques ou se limiter à un objet
et/
ou une liste de métriques. Si vous
ne donnez aucun objet ni métrique en paramètres, les sous-commandes s'appliqueront
à toutes les métriques disponibles de tous les objets. Vous pouvez utiliser
une astérisque ("<
computeroutput>*</
computeroutput>") pour spécifier explicitement
que la commande devrait s'appliquer à tous les objets ou à toutes les métriques.
Utilisez "host" en nom d'objet pour limiter la cible de la commande aux
métriques relatives à l'hôte. Pour limiter la cible à un sous-ensemble de métriques,
utilisez une liste de noms séparés par des virgules.</
para>
<
para>Par exemple, pour interroger les données de métriques sur le temps
passé par le processeur en modes utilisateur et noyau, sur la machine virtuelle
nommée "test", vous pouvez utiliser la commande suivante :</
para>
<
para>La liste suivante résume les sous-commandes disponibles :</
para>
<
glossterm>list</
glossterm>
<
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
<
glossterm>setup</
glossterm>
<
para>Cette sous-commande définit l''intervalle entre deux prises
d'échantillons des données de métriques et le nombre d'échantillons gardés
en interne. Les données mémorisées sont disponibles en affichage avec
la sous-commande <
code>query</
code>. L'option <
computeroutput>--list
</
computeroutput> affiche les métriques qui ont été modifiées dans le
résultat de l'exécution de la commande.</
para>
<
glossterm>enable</
glossterm>
<
para>Cette sous-commande "réactive le recueil de données après qu'il
a été arrêTé avec la sous-commande <
code>disable</
code>. Remarquez que
la spécification de sous-métriques comme paramètres n'activera pas les
métriques sous-jacentes. Utilisez
<
computeroutput>--list</
computeroutput> pour savoir si la commande a
fait ce que vous aviez prévu.</
para>
<
glossterm>disable</
glossterm>
<
para>Cette sous-commande "suspends" le recueil des données sans
changer les paramètres de récupération ni altérer les données recueillies.
Remarquez que la spécification de sous-métriques en paramètres ne
désactivera pas les métriques sous-jacentes. Utilisez
<
computeroutput>--list</
computeroutput> pour voir si la commande a fait
ce que vous aviez prévu.</
para>
<
glossterm>query</
glossterm>
<
para>Cette sous-commande récupère et affiche les données de métriques
<
para>La sous-commande <
code>query</
code> subcommand ne supprime
pas ni ne remet à 0 les données mémorisées. Si vous interrogez
assez souvent, vous verrez la durée d'évacuation graduelle des
échantillons par les nouveaux échantillons.</
para>
<
glossterm>collect</
glossterm>
<
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>
<
title>VBoxManage hostonlyif</
title>
<
para>Avec "hostonlyif", vous pouvez changer la configuration de l'IP d'une
interface réseau host-only. Pour une description du réseau host-only, merci
de vous reporter au <
xref linkend="network_hostonly" />. Chaque interface
host-only par un nom et peut soit utiliser le serveur DHCP interne, soit
voir son adresse IP configurée à la main (IP4 et IP6).</
para>
<
sect1 id="vboxmanage-dhcpserver">
<
title>VBoxManage dhcpserver</
title>
<
para>Les commandes de "dhcpserver" vous permettent de contrôler le serveur
DHCP construit dans VirtualBox. Vous pourriez trouver cela utile si vous
utilisez le réseau interne ou host-only. (En théorie, vous pouvez
l'activer aussi pour un réseu bridgé, mais cela provoquera probablement des
conflits avec d'autres serveurs DHCP de votre réseau physique.)</
para>
<
para>Utilisez les options suivantes de la ligne de commandes :<
itemizedlist>
<
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>
<
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" />
<
para>Les paramètres suivants supplémentaires sont requis quand vous ajoutez
un serveur DHCP pour la première fois :<
itemizedlist>
<
para>Avec <
computeroutput>--ip</
computeroutput>, spécifiez l'adresse
IP du serveur DHCP lui-même.</
para>
<
para>Avec <
computeroutput>--netmask</
computeroutput>, spécifiez
le masque du réseau.</
para>
<
para>Avec <
computeroutput>--lowerip</
computeroutput> aet
<
computeroutput>--upperip</
computeroutput>, vous pouvez spécifier
respectivement l'adresse la plus basse et la plus haute que le serveur
DHCP attribuera aux clients.</
para>
<
para>Enfin, vous devez spécifier<
computeroutput>--enable</
computeroutput>,
sinon le serveur DHCP sera créé en état désactivé, ce qui ne fera rien.</
para>
<
para>Après cela, VirtualBox démarrera automatiquement le serveu DHCP pour
le réseau nterne ou host-only donné dès que la première machine virtuelle utilisant
ce réseau sera démarrée.</
para>
<
para>Inversement, utilisez <
computeroutput>VBoxManage dhcpserver
remove</
computeroutput> avec <
computeroutput>--netname
<nom_réseau></
computeroutput> ou <
computeroutput>--ifname
<hostonly_if_name></
computeroutput> pour supprimer le serveur DHCP,
de nouveau pour le réseau interne ou host-only donné.</
para>
<
para>Pour modifier les paramètres d'un serveurDHCP créé précédemment avec
<
computeroutput>VBoxManage dhcpserver add</
computeroutput>, vous pouvez
<
computeroutput>VBoxManage dhcpserver modify</
computeroutput> pour une
interface réseau interne ou host-only donnée.</
para>
<
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>
<
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>
<
para>Pour supprimer un pack d'extension précédemment installé, utilisez
<
computeroutput>VBoxManage extpack uninstall
<nom></
computeroutput>. Vous pouvez utiliser
<
computeroutput>VBoxManage list extpacks</
computeroutput> tpour
afficher les noms des pack d'extensions actuellement installés ;
merci de voir aussi <
xref linkend="vboxmanage-list" />. Vous pouvez
utiliser le paramètre optionnel <
computeroutput>--force</
computeroutput>
pour surpasser le refus de se désinstaller d'un pack d'extension.</
para>
<
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>
<
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 no. 0: Oracle VM VirtualBox pack d'extension
Description: USB 2.0 Host Controller, VirtualBox RDP, PXE ROM with E1000 support.
$ 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>