VirtualBox

source: vbox/trunk/doc/manual/fr_FR/user_VBoxManage.xml@ 49380

Last change on this file since 49380 was 49380, checked in by vboxsync, 11 years ago

doc/manual: French user manual update, thank you Jean-Philippe Mengual!

File size: 188.6 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
4<chapter id="vboxmanage">
5 <title>VBoxManage</title>
6
7 <sect1>
8 <title>Introduction</title>
9
10 <para>Comme brièvement indiqué au <xref linkend="frontends" />, VBoxManage
11 est l'interface en ligne de commande de VirtualBox. Avec elle, vous pouvez
12 contrôler complètement VirtualBox depuis la ligne de commandes
13 de votre système d'exploitation hôte.
14 VBoxManage supporte toutes les fonctionnalités auxquelles vous donne accès
15 l'interface graphique, mais il supporte bien plus que ça. Il ouvre vraiment
16 toutes les fonctions du moteur de virtualisation, même celles auxquelles on
17 ne peut pas (encore) accéder en mode graphique.</para>
18
19 <para>Vous devrez utiliser la ligne de commande si vous voulez</para>
20
21 <para><itemizedlist>
22 <listitem>
23 <para>utiliser une autre interface que celle graphique (par exemple,
24 VBoxSDL ou le serveur VBoxHeadless)&#xA0;;</para>
25 </listitem>
26
27 <listitem>
28 <para>contrôler certains paramètres de configuration plus avancés et
29 expérimentaux d'une VM.</para>
30 </listitem>
31 </itemizedlist></para>
32
33 <para>Il faut avoir en tête deux choses en utilisant
34 <computeroutput>VBoxManage</computeroutput>&#xA0;: D'abord,
35 <computeroutput>VBoxManage</computeroutput> doit toujours être utilisé
36 avec des "sous-commandes" spécifiques telles que "list" ou "createvm" ou
37 "startvm". Toutes les sous-commandes supportées par
38 <computeroutput>VBoxManage</computeroutput> sont décrites en détail à la
39 <xref linkend="vboxmanage" />.</para>
40
41 <para>Ensuite, la plupart de ces sous-commandes exigent que vous spécifiez
42 une machine virtuelle en particulier après la sous-commande. Il y a deux façons
43 de faire cela&#xA0;:</para>
44
45 <itemizedlist>
46 <listitem>
47 <para>Vous pouvez spécifier le nom de la VM comme il s'affiche dans
48 l'interface graphique de VirtualBox. Remarquez que si ce nom contient des
49 espaces, vous devez l'entourer de guillemets), comme cela est toujours
50 le cas avec les arguments d'une ligne de commande contenant des espaces).</para>
51
52 <para>Par exemple&#xA0;:<screen>VBoxManage startvm "Windows XP"</screen></para>
53 </listitem>
54
55 <listitem>
56 <para>Vous pouvez spécifier l'UUID, qui est l'identifiant interne unique
57 utilisé par VirtualBox pour parler de la machine virtuelle. En supposant que
58 la VM précitée nommée "Windows XP" porte l'UUID affiché ci-dessous,
59 la commande suivante a le même effet que celle précédente&#xA0;:<screen>VBoxManage startvm 670e746d-abea-4ba6-ad02-2a3b043810a5</screen></para>
60 </listitem>
61 </itemizedlist>
62
63 <para>Vous pouvez taper <computeroutput>VBoxManage list vms</computeroutput>
64 pour voir toutes les VMs enregistrées&#xA0;; listées avec leurs paramètres,
65 y compris leurs noms respectifs et leurs UUIDs.</para>
66
67 <para>Des exemples classiques de la façon de contrôler VirtualBox depuis la
68 ligne de commande apparaissent ci-dessous&#xA0;:</para>
69
70 <itemizedlist>
71 <listitem>
72 <para>Pour créer une nouvelle machine virtuelle en ligne de commandes
73 et l'enregistrer immédiatement avec VirtualBox, utilisez
74 <computeroutput>VBoxManage createvm</computeroutput> avec l'option
75 <computeroutput>--register</computeroutput>,<footnote>
76 <para>Pour des détails, voir <xref
77 linkend="vboxmanage-createvm" />.</para>
78 </footnote> comme ceci&#xA0;:</para>
79
80 <screen>$ VBoxManage createvm --name "SUSE 10.2" --register
81VirtualBox Command Line Management Interface Version $VBOX_VERSION_MAJOR.$VBOX_VERSION_MINOR.$VBOX_VERSION_BUILD
82(C) 2005-$VBOX_C_YEAR $VBOX_VENDOR
83All rights reserved.
84
85Virtual machine 'SUSE 10.2' is created.
86UUID: c89fc351-8ec6-4f02-a048-57f4d25288e5
87Settings file: '/home/nomutilisateur/.config/VirtualBox/Machines/SUSE 10.2/SUSE 10.2.xml'</screen>
88
89 <para>Comme vous pouvez le voir dans la sortie ci-dessus, une nouvelle
90 machine virtuelle a été créée avec le nouvel UUID et un nouveau fichier
91 XML de paramètres.</para>
92 </listitem>
93
94 <listitem>
95 <para>Pour afficher la configuration d'une VM en particulier, utilisez
96 <computeroutput>VBoxManage showvminfo</computeroutput>&#xA0;; voir <xref
97 linkend="vboxmanage-showvminfo" /> pour des détails et un exemple.</para>
98 </listitem>
99
100 <listitem>
101 <para>Pour modifier les paramètres pendant qu'une VM est éteinte, utilisez
102 <computeroutput>VBoxManage modifyvm</computeroutput>, comme ceci&#xA0;:
103 <screen>VBoxManage modifyvm "Windows XP" --memory "512MB"</screen></para>
104
105 <para>Pour des détails,voir <xref linkend="vboxmanage-modifyvm" />.</para>
106 </listitem>
107
108 <listitem>
109 <para>Pour modifier la configuration du stockage (par exemple pour ajouter un
110 contrôleur de stockage et ensuite un disque virtuel), utilisez <computeroutput>VBoxManage
111 storagectl</computeroutput> et <computeroutput>VBoxManage
112 storageattach</computeroutput>&#xA0;; voir <xref
113 linkend="vboxmanage-storagectl" /> et <xref
114 linkend="vboxmanage-storageattach" /> pour les détails.</para>
115 </listitem>
116
117 <listitem>
118 <para>Pour contrôler le comportement de la VM, utilisez&#xA0;:<itemizedlist>
119 <listitem>
120 <para>Pour démarrer une VM éteinte, utilisez
121 <computeroutput>VBoxManage startvm</computeroutput>&#xA0;; voir <xref
122 linkend="vboxmanage-startvm" /> pour les détails.</para>
123 </listitem>
124
125 <listitem>
126 <para>Pour mettre en pause ou sauvegarder une VM en fonction, ou
127 pour modifier certains de ses paramètres, utilisez
128 <computeroutput>VBoxManage
129 controlvm</computeroutput>&#xA0;; voir <xref
130 linkend="vboxmanage-controlvm" /> pour les détails.</para>
131 </listitem>
132 </itemizedlist></para>
133 </listitem>
134 </itemizedlist>
135 </sect1>
136
137 <sect1>
138 <title>Aperçu des commandes</title>
139
140 <para>Quand vous lancez VBoxManage sans paramètres ou si vous entrez une ligne de
141 commande invalide, le diagramme de syntaxe ci-dessous s'affichera. Remarquez
142 que la sortie sera légèrement différente selon la plateforme hôte&#xA0;;
143 en cas de doute, vérifiez la sortie de <computeroutput>VBoxManage</computeroutput>
144 pour voir les commandes disponibles sur votre hôte en particulier.</para>
145
146 <screen>$VBOX_MANAGE_OUTPUT</screen>
147
148 <para>À chaque fois que vous appelez VBoxManage, une seule commande peut être
149 exécutée. Toutefois, une commande peut supporter plusieurs sous-commandes
150 que vous pouvez appeler en une seule fois. Les sections suivantes fournissent
151 des informations de référence détaillées sur les différentes commandes.</para>
152 </sect1>
153
154 <sect1 id="vboxmanage-general">
155 <title>Options générales</title>
156 <para>
157 <itemizedlist>
158 <listitem>
159 <para><computeroutput>--version</computeroutput>&#xA0;: affiche la
160 version de cet outil et quitte.</para>
161 </listitem>
162 <listitem>
163 <para><computeroutput>--nologo</computeroutput>&#xA0;: supprime l'affichage
164 des informations de logo (utile pour les scripts)</para>
165 </listitem>
166 <listitem>
167 <para><computeroutput>--settingspw</computeroutput>&#xA0;: spécifiie
168 un mot de passe pour les paramètres</para>
169 </listitem>
170 <listitem>
171 <para><computeroutput>--settingspwfile</computeroutput>&#xA0;: spécifie
172 un fichier contenant le mot de passe des paramètres</para>
173 </listitem>
174 </itemizedlist>
175 Le mot de passe des paramètres est utilisé pour certains paramètres ayant
176 besoin d'être stockés et chiffrés pour des raisons de sécurité. Pour le moment,
177 le seul paramètre chiffré est l'initateur secret iSCSI (voir
178 <xref linkend="vboxmanage-storageattach" /> pour les détails). Tant
179 qu'aucun mot de passe des paramètres n'a été spécifié, ces informations
180 sont stockées en <emphasis role="bold">texte brut</emphasis>. Après avoir
181 utilisé l'option <computeroutput>--settingspw|--settingspwfile</computeroutput>
182 une fois, il faut toujours l'utiliser, sans quoi le paramètre chiffré ne peut pas
183 être chiffré.
184 </para>
185 </sect1>
186
187 <sect1 id="vboxmanage-list">
188 <title>VBoxManage list</title>
189
190 <para>La commande <computeroutput>list</computeroutput> donne des
191 informations pertinentes sur votre système et sur les paramètres actuels de
192 VirtualBox.</para>
193
194 <para>Les sous-commandes suivantes sont disponibles avec
195 <computeroutput>VBoxManage list</computeroutput>&#xA0;: <itemizedlist>
196 <listitem>
197 <para><computeroutput>vms</computeroutput> liste toutes les machines
198 virtuelles actuellement enregistrées avec VirtualBox. Par défaut, elle
199 affiche une liste compacte aavec le nom et l'UUID de chaque VM&#xA0;;
200 si vous spécifiez en plus <computeroutput>--long</computeroutput> ou
201 <computeroutput>-l</computeroutput>, cela affichera une liste détaillée
202 comme avec la commande<computeroutput>showvminfo</computeroutput> (voir
203 ci-dessous).</para>
204 </listitem>
205
206 <listitem>
207 <para><computeroutput>runningvms</computeroutput> liste toutes les
208 machines virtuelles actuellement en fonction avec leurs identifiants
209 uniques (UUIDs) sous la même forme qu'avec
210 <computeroutput>vms</computeroutput>.</para>
211 </listitem>
212
213 <listitem>
214 <para><computeroutput>ostypes</computeroutput> liste les systèmes
215 d'exploitation invités connus aujourd'hui de VirtualBox, ainsi que
216 les identifiants utilisés pour s'y référer avec la commande
217 <computeroutput>modifyvm</computeroutput>.</para>
218 </listitem>
219
220 <listitem>
221 <para><computeroutput>hostdvds</computeroutput>,
222 <computeroutput>hostfloppies</computeroutput>, listent respectivement
223 les lecteurs DVD, amovibles, les interfaces réseaux bridgées et
224 host-only sur l'hôte, ainsi que le nom utilisé pour y accéder depuis
225 VirtualBox.</para>
226 </listitem>
227
228 <listitem>
229 <para><computeroutput>bridgedifs</computeroutput>,
230 <computeroutput>hostonlyifs</computeroutput> aet
231 <computeroutput>dhcpservers</computeroutput>, listent respectivement
232 les interfaces réseaux bridgées, host-only et les serveurs DHCP disponibles
233 sur l'hôte. Merci de voir <xref
234 linkend="networkingdetails" /> pour les détails à leur sujet.</para>
235 </listitem>
236
237 <listitem>
238 <para><computeroutput>hostinfo</computeroutput> affiche des informations
239 sur le système hôte telles que les processeurs, la taille de la mémoire
240 et la version du système d'exploitation.</para>
241 </listitem>
242
243 <listitem>
244 <para><computeroutput>hostcpuids</computeroutput> affiche les paramètres
245 CPUID aux processeurs de l'hôte. Cela peut servir à une analyse plus
246 fine des possibilités de virtualisation de l'hôte.</para>
247 </listitem>
248
249 <listitem>
250 <para><computeroutput>hddbackends</computeroutput> liste les fondations
251 de disque virtuel connues de VirtualBox. Pour chaque format (tels que
252 VDI, VMDK ou RAW), ceci liste les possibilités de la fondation et sa
253 configuration.</para>
254 </listitem>
255
256 <listitem>
257 <para><computeroutput>hdds</computeroutput>,
258 <computeroutput>dvds</computeroutput> et
259 <computeroutput>floppies</computeroutput> vous donnent des informations
260 sur les images de disque virtuel actuellement utilisées par VirtualBox,
261 y compris leurs paramètres, leurs identifiants uniques (UUIDs)
262 associés par VirtualBox et tous leurs fichiers associés. C'est l'équivalent
263 ligne de commandes du gestionnaire de médias virtuels&#xA0;; voir <xref
264 linkend="vdis" />.</para>
265 </listitem>
266
267 <listitem>
268 <para><computeroutput>usbhost</computeroutput> donne des informations
269 sur les périphériques USB attachés à l'hôte, en particulier des
270 informations utiles pour construire des filtres USB et s'ils sont actuellement
271 utilisés par l'hôte.</para>
272 </listitem>
273
274 <listitem>
275 <para><computeroutput>usbfilters</computeroutput> liste les filtres USB
276 globaux enregistrés avec VirtualBox -- c'est-à-dire les filtres des
277 périphériques accessibles à toutes les machinc( virtuelles -- et
278 il affiche les paramètres du filtre.</para>
279 </listitem>
280
281 <listitem>
282 <para><computeroutput>systemproperties</computeroutput> affiche des
283 paramètres globaux de VirtualBox, tels que la RAM minimum et maximum
284 de l'invité et la taille du disque dur virtuel, les paramètres du
285 dossier et la bibliothèque d'authentification actuellement utilisée.</para>
286 </listitem>
287
288 <listitem>
289 <para><computeroutput>extpacks</computeroutput> affiche les packs
290 d'extension de VirtualBox actuellement installés&#xA0;; voir <xref
291 linkend="intro-installing" /> et <xref
292 linkend="vboxmanage-extpack" /> pour plus d'informations.</para>
293 </listitem>
294 </itemizedlist></para>
295 </sect1>
296
297 <sect1 id="vboxmanage-showvminfo">
298 <title>VBoxManage showvminfo</title>
299
300 <para>La commande <computeroutput>showvminfo</computeroutput> affiche
301 des informations sur une machine en particulier. Ce sont les mêmes
302 informations qu'afficherait <computeroutput>VBoxManage list vms --long</computeroutput>
303 pour toutes les machines virtuelles.</para>
304
305 <para>Vous aurez des informations ressemblant à ce qui suit&#xA0;:</para>
306
307 <para><screen>$ VBoxManage showvminfo "Windows XP"
308VirtualBox Command Line Management Interface Version $VBOX_VERSION_MAJOR.$VBOX_VERSION_MINOR.$VBOX_VERSION_BUILD
309(C) 2005-$VBOX_C_YEAR $VBOX_VENDOR
310All rights reserved.
311
312Name: Windows XP
313Guest OS: Other/Unknown
314UUID: 1bf3464d-57c6-4d49-92a9-a5cc3816b7e7
315Config file: /home/nomutilisateur/.config/VirtualBox/Machines/Windows XP/Windows XP.xml
316Memory size: 512MB
317VRAM size: 12MB
318Number of CPUs: 2
319Synthetic Cpu: off
320Boot menu mode: message and menu
321Boot Device (1): DVD
322Boot Device (2): HardDisk
323Boot Device (3): Not Assigned
324Boot Device (4): Not Assigned
325ACPI: on
326IOAPIC: on
327PAE: on
328Time offset: 0 ms
329Hardw. virt.ext: on
330Nested Paging: on
331VT-x VPID: off
332State: powered off (since 2009-10-20T14:52:19.000000000)
333Monitor count: 1
3343D Acceleration: off
3352D Video Acceleration: off
336Teleporter Enabled: off
337Teleporter Port: 0
338Teleporter Address:
339Teleporter Password:
340Storage Controller (0): IDE Controller
341Storage Controller Type (0): PIIX4
342Storage Controller (1): Floppy Controller 1
343Storage Controller Type (1): I82078
344IDE Controller (0, 0): /home/user/windows.vdi (UUID: 46f6e53a-4557-460a-9b95-68b0f17d744b)
345IDE Controller (0, 1): /home/user/openbsd-cd46.iso (UUID: 4335e162-59d3-4512-91d5-b63e94eebe0b)
346Floppy Controller 1 (0, 0): /home/user/floppy.img (UUID: 62ac6ccb-df36-42f2-972e-22f836368137)
347NIC 1: disabled
348NIC 2: disabled
349NIC 3: disabled
350NIC 4: disabled
351NIC 5: disabled
352NIC 6: disabled
353NIC 7: disabled
354NIC 8: disabled
355UART 1: disabled
356UART 2: disabled
357Audio: disabled (Driver: Unknown)
358Clipboard Mode: Bidirectional
359VRDE: disabled
360USB: disabled
361
362USB Device Filters:
363&lt;none&gt;
364
365Shared folders:
366&lt;none&gt;
367
368Statistics update: disabled</screen></para>
369 </sect1>
370
371 <sect1 id="vboxmanage-registervm">
372 <title>VBoxManage registervm / unregistervm</title>
373
374 <para>La commande <computeroutput>registervm</computeroutput> vous permet
375 d'importer la définition d'une machine virtuelle dans VirtualBox via
376 un fichier XML. La machine ne doit pas entrer en conflit avec une autre déjà
377 enregistrée dans VirtualBox et elle ne peut pas avoir de disques durs ou
378 amovibles attachés. Il est recommandé de mettre le fichier de définition
379 dans le répertoire des machines avant de l'enregistrer.<note>
380 <para>Lors de la création d'une nouvelle machine virtuelle avec
381 <computeroutput>VBoxManage createvm</computeroutput> (voir ci-dessous),
382 vous pouvez spécifier directement l'option
383 <computeroutput>--register</computeroutput> pour éviter de devoir
384 l'enregistrer séparément.</para>
385 </note></para>
386
387 <para>La commande <computeroutput>unregistervm</computeroutput> désenregistre
388 une machine virtuelle. Si vous spécifiez également
389 <computeroutput>--delete</computeroutput>, les fichiers suivants seront
390 eux aussi automatiquement effacés&#xA0;:<orderedlist>
391 <listitem>
392 <para>tous les fichiers images de disque dur, y compris les fichiers de
393 différenciation, utilisés par la machine et non partagés avec d'autres
394 machines&#xA0;;</para>
395 </listitem>
396
397 <listitem>
398 <para>les fichiers de l'état sauvegardé créés par la machine s'il y en
399 a (un si la machine était en état "sauvegardé" et un pour chaque
400 instantané en ligne)&#xA0;;</para>
401 </listitem>
402
403 <listitem>
404 <para>le fichier XML de la machine et ses sauvegardes&#xA0;;</para>
405 </listitem>
406
407 <listitem>
408 <para>les fichiers journaux de la machine s'il y en a&#xA0;;</para>
409 </listitem>
410
411 <listitem>
412 <para>le répertoire de la machine s'il est vide après l'effacement de
413 tout ce qui précède.</para>
414 </listitem>
415 </orderedlist></para>
416 </sect1>
417
418 <sect1 id="vboxmanage-createvm">
419 <title>VBoxManage createvm</title>
420
421 <para>Cette commande crée un nouveau fichier de définition de machine virtuelle
422 XML.</para>
423
424 <para>Le paramètre <computeroutput>--name &lt;name&gt;</computeroutput> est
425 requis et doit spécifier le nom de la machine. Ce nom étant utilisé par
426 défaut pour nommer le fichier des paramètres (avec l'extension
427 <computeroutput>.xml</computeroutput>) et le dossier machine (un sous-dossier
428 du dossier <computeroutput>.config/VirtualBox/Machines</computeroutput>), il doit
429 respecter les exigences de votre système d'exploitation hôte en matière de
430 spécifications d'un nom de fichier. Si vous renommez plus tard la VM, le
431 nom du fichier et du dossier seront modifiés automatiquement.</para>
432
433 <para>Néanmoins, si vous utilisez l'option <computeroutput>--basefolder
434 &lt;path&gt;</computeroutput>, le dossier de la machine sera appelé
435 <computeroutput>&lt;path&gt;</computeroutput>. Dans ce cas, les noms du
436 fichier et du dossier ne seront pas modifiés si la machine virtuelle est
437 renommée.</para>
438
439 <para>Par défaut, cette commande ne fait que créer le fichier XML,
440 sans enregistrer automatiquement la VM avec votre installation de
441 VirtualBox. Pour enregistrer instantanément la VM, utilisez l'option
442 <computeroutput>--register</computeroutput>, ou lancez
443 <computeroutput>VBoxManage registervm</computeroutput> séparément a posteriori.</para>
444 </sect1>
445
446 <sect1 id="vboxmanage-modifyvm">
447 <title>VBoxManage modifyvm</title>
448
449 <para>Cette commande modifie les propriétés d'une machine virtuelle enregistrée
450 et non en fonction. La plupart des propriétés disponibles avec cette commande
451 correspondent aux paramètres de la VM affichés dans l'interface graphique de
452 VirtualBox dans la boîte de dialogue "Paramètres" de chaque VM&#xA0;;
453 celles-ci ont été décrites en
454 <xref linkend="BasicConcepts" />. Néanmoins, certains des paramètres les plus
455 avancés ne sont disponibles que via l'interface
456 <computeroutput>VBoxManage</computeroutput>.</para>
457
458 <para>Ces commandes exigent que la machine soit éteinte (ni
459 en fonction ni en état "sauvegardé"). Certains paramètres de la machine
460 peuvent être aussi modifiés pendant qu'une machine est en fonction&#xA0;;
461 ces paramètres auront alors une sous-commande correspondante avec la sous-commande
462 <computeroutput>VBoxManage controlvm</computeroutput> (voir <xref linkend="vboxmanage-controlvm" />).</para>
463
464 <sect2>
465 <title>Paramètres généraux</title>
466
467 <para>Les paramètres généraux suivants sont disponibles via
468 <computeroutput>VBoxManage modifyvm</computeroutput>&#xA0;:<itemizedlist>
469 <listitem>
470 <para><computeroutput>--name &lt;nom&gt;</computeroutput>&#xA0;: Ceci
471 modifie le nom de la VM et renomme éventuellement les fichiers internes
472 virtuels, comme décrit avec <computeroutput>VBoxManage
473 createvm</computeroutput> ci-dessus.</para>
474 </listitem>
475
476 <listitem>
477 <para><computeroutput>--ostype &lt;ostype&gt;</computeroutput>&#xA0;:
478 Ceci spécifie le système d'exploitation supposé fonctionner dans la
479 VM. Pour en apprendre davantage sur les différents identifiants
480 utilisables, utilisez <computeroutput>VBoxManage list
481 ostypes</computeroutput>.</para>
482 </listitem>
483
484 <listitem>
485 <para><computeroutput>--memory
486 &lt;taillemémoire&gt;</computeroutput>&#xA0;: Ceci définit la quantité
487 de RAM, en Mo, que devrait s'affecter à elle-même la machine virtuelle
488 sur l'hîte. Voir les remarques au <xref linkend="gui-createvm" /> pour
489 plus d'informations.</para>
490 </listitem>
491
492 <listitem>
493 <para><computeroutput>--vram &lt;taillevram&gt;</computeroutput>&#xA0;:
494 Ceci définit la quantité de RAM de la carte graphique. Voir
495 <xref linkend="settings-display" /> pour des détails.</para>
496 </listitem>
497
498 <listitem>
499 <para><computeroutput>--acpi on|off</computeroutput>&#xA0;;
500 <computeroutput>--ioapic on|off</computeroutput>&#xA0;: Ces deux éléments
501 déterminent si la VM devrait supporter respectivement l'ACPI et
502 l'APIC I/O&#xA0;; voir <xref linkend="settings-motherboard" /> pour
503 des détails.</para>
504 </listitem>
505
506 <listitem>
507 <para><computeroutput>--hardwareuuid
508 &lt;uuid&gt;</computeroutput>&#xA0;: L'UUID présentée à l'invité via
509 les tables mémoire (DMI/SMBIOS), les propriétés matérielles
510 et invité. Par défaut, c'est le même que l'uuid de la VM. Utile quand
511 vous clonez une VM. La téléportation en tient compte automatiquement.</para>
512 </listitem>
513
514 <listitem>
515 <para><computeroutput>--cpus &lt;nombreprocesseur&gt;</computeroutput>&#xA0;:
516 Ceci définit le nombre de processeurs virtuels de la machine virtuelle
517 (voir <xref linkend="settings-processor" />). Si le branchement
518 à chaud des processaurs est activé (voir ci-dessous), ceci définit
519 le nombre <emphasis>maximum</emphasis> de processeurs virtuels
520 qu'on peut brancher dans les machines virtuelles.</para>
521 </listitem>
522
523 <listitem>
524 <para><computeroutput>--rtcuseutc on|off</computeroutput>&#xA0;: Cette
525 option fait tourner l'horloge en temps réel (RTC) en temps UTC (voir
526 <xref linkend="settings-motherboard" />).</para>
527 </listitem>
528
529 <listitem>
530 <para><computeroutput>--cpuhotplug on|off</computeroutput>&#xA0;: Ceci
531 active le branchement à chaud du processeur. Quand vous l'activez,
532 les processeurs virtuels peuvent être ajoutés et supprimés d'une
533 machine virtuelle pendant qu'elle est en fonction. Voir
534 <xref linkend="cpuhotplug" /> pour plus d'informations.</para>
535 </listitem>
536
537 <listitem>
538 <para><computeroutput>--plugcpu|unplugcpu
539 &lt;id&gt;</computeroutput>&#xA0;: Si vous avez activé le branchement
540 des processeurs à chaud (voir ci-dessus), ceci ajoute un processeur
541 virtuel aux machines virtuelles (ou en supprime un). <computeroutput>&lt;id&gt;</computeroutput>
542 spécifie l'index du processeur virtuel à ajouter ou supprimer et doit
543 être un numéro entre 0 et le nombre maximum de processeurs configurés
544 avec l'option <computeroutput>--cpus</computeroutput>. Le processeur
545 0 ne peut jamais être supprimé.</para>
546 </listitem>
547
548 <listitem>
549 <para><computeroutput>--cpuexecutioncap
550 &lt;1-100&gt;</computeroutput>&#xA0;: Ce paramètre contrôle le nombre
551 de temps processeur utilisable par un processeur. La valeur 50 implique
552 qu'un seul processeur virtuel peut utiliser jusqu'à 50% d'un seul
553 processeur de l'hôte.</para>
554 </listitem>
555
556 <listitem>
557 <para><computeroutput>--pae on|off</computeroutput>&#xA0;: Ceci active/désactive
558 la PAE (voir <xref
559 linkend="settings-processor" />).</para>
560 </listitem>
561
562 <listitem>
563 <para><computeroutput>--longmode on|off</computeroutput> : Ceci
564 active/désactive le mode long (voir <xref
565 linkend="settings-processor" />).</para>
566 </listitem>
567
568 <listitem>
569 <para><computeroutput>--synthcpu on|off</computeroutput>&#xA0;: Ce
570 paramètre détermine si VirtualBox présente ou non un processeur
571 synthétique à l'invité pour permettre une migration en direct entre
572 les systèmes hôtes qui diffèrent de manière significative.</para>
573 </listitem>
574
575 <listitem>
576 <para><computeroutput>--hpet on|off</computeroutput>&#xA0;: Ceci active/désactive
577 un High Precision Event Timer (HPET) qui peut remplacer les timers
578 du système primitif. C'est désactivé par défaut. Remarquez que Windows
579 ne supporte un HPET qu'à partir de Vista.</para>
580 </listitem>
581
582 <listitem>
583 <para><computeroutput>--hwvirtex on|off</computeroutput>&#xA0;: Ceci
584 active ou désactive l'utilisation des extensions du matériel de
585 virtualisation (Intel VT-x ou AMD-V) dans le processeur de votre système
586 hôte&#xA0;; voir <xref linkend="hwvirt" />.</para>
587 </listitem>
588
589 <listitem>
590 <para><computeroutput>--triplefaultreset on|off</computeroutput> : ce
591 paramètre permet de relancer l'invité au lieu de récupérer une Guru Meditation. Certains invités échouent par une triple erreur lors de la réinitialisation
592 du processeur, donc on peut parfois souhaiter ce comportement. Cela
593 ne fonctionne que sur les invités non SMP.</para>
594 </listitem>
595 <listitem>
596 <para><computeroutput>--nestedpaging on|off</computeroutput>&#xA0;: Si
597 la virtualisation matérielle est activée, ce paramètre supplémentaire
598 active ou désactive l'utilisation de la fonction de pagination nested
599 du processeur de votre système hôte&#xA0;; voir <xref
600 linkend="hwvirt" />.</para>
601 </listitem>
602
603 <listitem>
604 <para><computeroutput>--largepages on|off</computeroutput>&#xA0;: Si
605 la virtualisation matérielle <emphasis>et</emphasis> la pagination
606 nested sont activées, pour Intel VT-x seulement, vous pouvez obtenir un
607 gain de performances jusqu'à 5% en activant ce paramètre. Il fait
608 utiliser à l'hyperviseur les grandes pages pour réduire l'utilisation du
609 TLB et l'overhead.</para>
610 </listitem>
611
612 <listitem>
613 <para><computeroutput>--vtxvpid on|off</computeroutput>&#xA0;: Si
614 la virtualisation matérielle est activée, pour Intel VT-x seulement,
615 ce paramètre supplémentaire active ou désactive l'utilisation de la
616 fonction TLB taggçe (VPID) du processeur de votre système hôte&#xA0;;
617 voir see <xref linkend="hwvirt" />.</para>
618 </listitem>
619
620 <listitem>
621 <para><computeroutput>--vtxux on|off</computeroutput> : Si vous avez
622 activé la virtualisation matérielle, seulement pour VT-x d'Intel, ce
623 paramètre active ou désactive l'utilisation de la fonction mode invité
624 sans restriction pour faire tourner votre invité.</para>
625 </listitem>
626 <listitem>
627 <para><computeroutput>--accelerate3d on|off</computeroutput>&#xA0;:
628 Ceci active, si vous avez installé les suppléments invité, la disponibilité
629 de l'accélération 3D&#xA0;; voir <xref
630 linkend="guestadd-3d" />.</para>
631 </listitem>
632
633 <listitem>
634 <para>Vous pouvez influencer le logo du BIOS affiché quand une machine
635 virtuelle démarre avec un certain nombre de paramçtres. Par défaut,
636 un logo VirtualBox est affiché.</para>
637
638 <para>Avec <computeroutput>--bioslogofadein
639 on|off</computeroutput> et <computeroutput>--bioslogofadeout
640 on|off</computeroutput>, you pouvez déterminer si le logo devrait
641 fade in and out.</para>
642
643 <para>Avec <computeroutput>--bioslogodisplaytime
644 &lt;msec&gt;</computeroutput> vous pouvez définir la durée d'affichage
645 du logo en millisecondes.</para>
646
647 <para>Avec <computeroutput>--bioslogoimagepath
648 &lt;cheminimage&gt;</computeroutput> vous pouvez, si vous le souhaitez,
649 remplacer l'image affichée par votre propre logo. L'image doit être
650 un fichier BMP décompressé 256 couleurs avec des informations sur
651 la zone des couleurs (au format Windows 3.0). La taille de l'image
652 ne doit pas excéder 640 x 480.</para>
653 </listitem>
654
655 <listitem>
656 <para><computeroutput>--biosbootmenu
657 disabled|menuonly|messageandmenu</computeroutput>&#xA0;: Ceci
658 spécifie si le BIOS permet à l'utilisateur de sélectionner un périphérique
659 de démarrage temporaire. <computeroutput>menuonly</computeroutput>
660 supprime le message, mais l'utilisateur peut encore appuyer sur F12
661 pour sélectionner un périphérique de démarrage temporaire.</para>
662 </listitem>
663
664 <listitem>
665 <para><computeroutput>--nicbootprio&lt;1-N&gt;
666 &lt;priorité&gt;</computeroutput>&#xA0;: Ceci spécifie l'ordre dans
667 lequel les NICs sont essayés pour démarrer par le réseau (en utilisant
668 PXE). La priorité est un entier entre 0 à 4. La priorité 1 est la
669 plus élevée, la priorité 4 est la plus faible. La priorité 0, qui
670 est celle par défaut sauf autrement spécifié, est la plus faible.
671 </para>
672 <para>Remarquez que cette option n'a d'effet que quand le démarrage
673 Intel PXE ROM est utilisé.
674 </para>
675 </listitem>
676
677 <listitem>
678 <para><computeroutput>--boot&lt;1-4&gt;
679 none|floppy|dvd|disk|net</computeroutput>&#xA0;: Ceci spécifie l'ordre
680 d'amorçage pour la machine virtuelle. Il y a quatre "slots", auxquels
681 essaiera d'accéder la VM de 1 à 4, et pour chacun d'eux, vous pouvez
682 définir un périphérique sur lequel la VM devrait essayer de démarrer.</para>
683 </listitem>
684
685 <listitem>
686 <para><computeroutput>--snapshotfolder
687 default|&lt;path&gt;</computeroutput>&#xA0;: Ceci vous permet de
688 spécifier le dossier dans lequel seront stockés les instantanés d'une
689 machine virtuelle.</para>
690 </listitem>
691
692 <listitem>
693 <para><computeroutput>--firmware efi|bios</computeroutput>&#xA0;:
694 Spécifie le firmware utilisé pour démarrer une
695 machine virtuelle en particulier&#xA0;: EFI ou BIOS. N'utilisez EFI
696 que si vous comprenez bien ce que vous faites.</para>
697 </listitem>
698
699 <listitem>
700 <para><computeroutput>--guestmemoryballoon
701 &lt;taille&gt;</computeroutput> définit la taille par défaut de la
702 mémoire du ballon de l'invité c'est-à-dire la mémoire affectée
703 par les suppléments invité de VirtualBox à partir du szstème d'exploitation
704 invité et rendue à l'hyperviseur pour être réutilisée par d'autres
705 machines virtuelles. &lt;taille&gt; doit être spécifiée en mégaoctets.
706 La taille par défaut est de 0 mégaoctets. Pour les
707 détails, voir <xref linkend="guestadd-balloon" />.</para>
708 </listitem>
709 <listitem>
710 <para><computeroutput>--lptmode&lt;1-N&gt;
711 &lt;Périphérique&gt;</computeroutput>
712 Spécifie le nom du périphérique du port parallèle utilisé par la
713 fonction Pert parallèle. Utilisez ceci <emphasis>avant</emphasis>
714 <computeroutput>--lpt</computeroutput>. Cette fonction est spécifique
715 au système d'exploitation.</para>
716 </listitem>
717
718 <listitem>
719 <para><computeroutput>--lpt&lt;1-N&gt;
720 &lt;base E/S&gt; &lt;IRQ&gt;</computeroutput> Spécifie l'adresse
721 E/S du port parallèle et le numéro IRQ utilisés par la fonction
722 Port parallèle. Utilisez ceci <emphasis>après</emphasis>
723 <computeroutput>--lptmod</computeroutput>. L'adresse de base
724 E/S et le numéro IRQ sont les valeurs vues par l'invité, c'est-à-dire
725 les valeurs disponibles dans le gestionnaire de périphériques de
726 l'invité.</para>
727 </listitem>
728
729 <listitem>
730 <para><computeroutput>--defaultfrontend
731 default|&lt;nom&gt;</computeroutput>&#xA0;: Ceci vous permet de
732 spécifier l'interface par défaut qui sera utilisée au démarrage de
733 cette VM&#xA0; voir
734 <xref linkend="vboxmanage-startvm" /> pour des détails.</para>
735 </listitem>
736 </itemizedlist></para>
737 </sect2>
738
739 <sect2>
740 <title>Paramètres réseaux</title>
741
742 <para>Les paramètres réseaux suivants sont disponibles avec
743 <computeroutput>VBoxManage modifyvm</computeroutput>. Avec tous ces paramètres,
744 le numéro décimal suivant directement le nom de l'option ("1-N" dans la
745 in liste ci-dessous) spécifie l'adaptateur réseau virtuel dont vous
746 modifiez les paramètres.<itemizedlist>
747 <listitem>
748 <para><computeroutput>--nic&lt;1-N&gt;
749 none|null|nat|bridged|intnet|hostonly|generic
750 </computeroutput>&#xA0;: Avec cela, vous pouvez définir, pour chacune
751 des cartes réseaux virtuelles de la VM, le type de réseau qui devrait
752 être disponible. Ils peuvent ne pas être présents
753 (<computeroutput>none</computeroutput>), non connectés à l'hôte
754 (<computeroutput>null</computeroutput>), utiliser le network
755 address translation (<computeroutput>nat</computeroutput>),
756 le réseau bridgé (<computeroutput>bridged</computeroutput>) ou
757 communiquer avec d'autres machines virtuelles en utilisant le réseau
758 internal (<computeroutput>intnet</computeroutput>), le réseau
759 host-only (<computeroutput>hostonly</computeroutput>), ou accéder
760 à des sous-modes rarement utilisés (<computeroutput>generic</computeroutput>).
761 Ces options correspondent aux modes décrits en détail au <xref
762 linkend="networkingmodes" />.</para>
763 </listitem>
764
765 <listitem>
766 <para><computeroutput>--nictype&lt;1-N&gt;
767 Am79C970A|Am79C973|82540EM|82543GC|82545EM|virtio</computeroutput>&#xA0;:
768 Cela vous permet, pour chacune des cartes réseaux virtuelles de la VM, de
769 spécifier le matériel réseau que VirtualBox présente à l'invité&#xA0;;
770 voir <xref linkend="nichardware" />.</para>
771 </listitem>
772
773 <listitem>
774 <para><computeroutput>--cableconnected&lt;1-N&gt;
775 on|off</computeroutput>&#xA0;: Cela vous permet de déconnecter
776 temporairement une interface réseau virtuelle comme si vous débranchiez un
777 câble réseau d'une vraie carte réseau. Cela pourrait être utile pour
778 reparamétrer certains composants logiciels dans la VM.</para>
779 </listitem>
780
781 <listitem>
782 <para>Avec l'option "nictrace", vous pouvez éventuellement tracer
783 le trafic réseau en l'envoyant vers un fichier pour faire du débogage.</para>
784
785 <para>Avec <computeroutput>--nictrace&lt;1-N&gt;
786 on|off</computeroutput>, vous pouvez activer un traçage réseau pour
787 des cartes réseaux en particulier.</para>
788
789 <para>Si vous l'activez, vous devez spécifier avec
790 <computeroutput>--nictracefile&lt;1-N&gt;
791 &lt;nomfichier&gt;</computeroutput> le fichier où devrait être
792 journalisée la trace.</para>
793 </listitem>
794
795 <listitem>
796 <para><computeroutput>--bridgeadapter&lt;1-N&gt;
797 none|&lt;nompériphérique&gt;</computeroutput>&#xA0;: Si le réseau
798 bridgé est activé pour une carte réseau virtuelle (voir l'option
799 <computeroutput>--nic</computeroutput> ci-dessus&#xA0;; sinon ce
800 paramètre n'a aucun effet),, utilisez cette option pour spécifier
801 l'interface de l'hôte qu'utilisera l'interface réseau virtuelle
802 donnée. Pour des détails, merci de voir <xref linkend="network_bridged" />.</para>
803 </listitem>
804
805 <listitem>
806 <para><computeroutput>--hostonlyadapter&lt;1-N&gt;
807 none|&lt;nompériphérique&gt;</computeroutput>&#xA0;: Si le réseau
808 host-only a été activé pour une carte réseau virtuelle (voir l'option
809 --nic ci-dessus&#xA0;; sinon ce paramètre n'a aucun effet), utilisez
810 cette option spécifier l'interface réseau host-only qu'utilisera
811 l'interface réseau donnée. Pour des détails, merci de voir <xref
812 linkend="network_hostonly" />.</para>
813 </listitem>
814
815 <listitem>
816 <para><computeroutput>--intnet&lt;1-N&gt;
817 network</computeroutput>&#xA0;: Si le réseau interne a été activé
818 pour une carte réseau virtuelle (voir l'option
819 <computeroutput>--nic</computeroutput> ci-dessus&#xA0;; sinon ce
820 paramètre n'a aucun effet), utilisez cette option pour spécifier le
821 nom du réseau interne (voir <xref
822 linkend="network_internal" />).</para>
823 </listitem>
824
825 <listitem>
826 <para><computeroutput>--macaddress&lt;1-N&gt;
827 auto|&lt;mac&gt;</computeroutput>&#xA0;: Avec cette option,
828 vous pouvez définir l'adresse MAC de la carte réseau virtuelle.
829 Normalement, chaque carte réseau virtuel se voit affecter une adresse
830 aléatoire par VirtualBox Lors de la création de la VM.</para>
831 </listitem>
832
833 <listitem>
834 <para><computeroutput>--nicgenericdrv&lt;1-N&gt;
835 &lt;pilote fondation&gt;</computeroutput>&#xA0;: Si le réseau
836 générique a été activée pour une carte réseau virtuelle (voir l'option
837 <computeroutput>--nic</computeroutput> ci-dessus&#xA0;; sinon ce paramètre
838 n'a aucun effet), ce mode vous permet d'accéder à des sous-modes
839 réseaux rarement utilisés, tels que le réseau VDE ou le tunnel UDP.
840 </para>
841 </listitem>
842
843 <listitem>
844 <para><computeroutput>--nicproperty&lt;1-N&gt;
845 &lt;nomparam&gt;="paramvaleur"</computeroutput>&#xA0;:
846 Cette option, associée avec "nicgenericdrv", vous permet de
847 passer des paramètres aux fondations réseaux rarement utilisées.</para><para>
848 Ces paramètres sont des fondations spécifiques au moteur et sont
849 différentes entre les pilotes de la foncation du tunnel UDP et du
850 VDE. Par exemple,merci de voir <xref linkend="network_udp_tunnel" />.
851 </para>
852 </listitem>
853 </itemizedlist></para>
854
855 <sect3>
856 <title>Paramètres du réseau NAT.</title>
857
858 <para>Les paramètres de réseau NAT suivants sont disponibles via
859 <computeroutput>VBoxManage modifyvm</computeroutput>. Avec tous ces
860 paramètres, le numéro décimale suivant le nom de l'option ("1-N"
861 dans la liste ci-dessous) spécifie l'adaptateur réseau virtuel que
862 devrait modifier ces paramètres.<itemizedlist>
863 <listitem>
864 <para><computeroutput>--natpf&lt;1-N&gt;
865 [&lt;nom&gt;],tcp|udp,[&lt;hostip&gt;],&lt;porthôte&gt;,[&lt;ipinvité&gt;],
866 &lt;portinvité&gt;</computeroutput>&#xA0;: Cette option définit
867 une règle de redirection de port NAT (merci de voir <xref linkend="natforward" />
868 pour des détails).</para>
869 </listitem>
870
871 <listitem>
872 <para><computeroutput>--natpf&lt;1-N&gt; delete
873 &lt;nom&gt;</computeroutput>&#xA0;: Cette option supprime une règle
874 de redirection de port NAT (merci de voir <xref linkend="natforward" />
875 pour les détails).</para>
876 </listitem>
877
878 <listitem>
879 <para><computeroutput>--nattftpprefix&lt;1-N&gt;
880 &lt;préfixe&gt;</computeroutput>&#xA0;: Cette option définit un
881 préfixe pour le serveur TFTP intégré, à savoir là où se trouve le
882 fichier de démarrage (merci de voir <xref linkend="nat-tftp" /> and <xref
883 linkend="nat-adv-tftp" /> pour les détails).</para>
884 </listitem>
885
886 <listitem>
887 <para><computeroutput>--nattftpfile&lt;1-N&gt;
888 &lt;fichierdémarrage&gt;</computeroutput>&#xA0;: Cette option
889 définit le fichier de démarrage TFT (merci de voir <xref linkend="nat-adv-tftp" />
890 pour des détails).</para>
891 </listitem>
892
893 <listitem>
894 <para><computeroutput>--nattftpserver&lt;1-N&gt;
895 &lt;serveurtftp&gt;</computeroutput>&#xA0;: Cette option définit
896 l'adresse du serveur TFTP sur lequel démarrer (voir <xref
897 linkend="nat-adv-tftp" /> pour les détails).</para>
898 </listitem>
899
900 <listitem>
901 <para><computeroutput>--natdnspassdomain&lt;1-N&gt;
902 on|off</computeroutput>&#xA0;: Cette option spécifie si le serveur
903 DHCP passe le nom de domaine pour la résolution du nom du réseau.</para>
904 </listitem>
905
906 <listitem>
907 <para><computeroutput>--natdnsproxy&lt;1-N&gt;
908 on|off</computeroutput>&#xA0;: Cette option fait faire du proxy au
909 moteur NAT pour toutes les requêtes DNS de l'invité adressées au serveur DNS
910 de l'hôte (merci de voir <xref linkend="nat-adv-dns" /> pour des
911 détails).</para>
912 </listitem>
913
914 <listitem>
915 <para><computeroutput>--natdnshostresolver&lt;1-N&gt;
916 on|off</computeroutput>&#xA0;: Cette option fait utiliser par le
917 moteur NAT le mécanismes de résolveur de l'hôte pour gérer les
918 requêtes DNS (merci de voir <xref linkend="nat-adv-dns" /> pour les détails).</para>
919 </listitem>
920
921 <listitem>
922 <para><computeroutput>--natnatsettings&lt;1-N&gt;
923 [&lt;mtu&gt;],[&lt;socksnd&gt;],[&lt;sockrcv&gt;],[&lt;tcpsnd&gt;],
924 [&lt;tcprcv&gt;]</computeroutput>&#xA0;: Cette option contrôle
925 plusieurs paramètres NAT (merci de voir <xref linkend="nat-adv-settings" />
926 pour les détails).</para>
927 </listitem>
928
929 <listitem>
930 <para><computeroutput>--nataliasmode&lt;1-N&gt;
931 default|[log],[proxyonly],[sameports]</computeroutput>&#xA0;: Cette
932 option définit le comportement du c&#x153;ur du moteur NAT&#xA0;:
933 log - active la journalisation, proxyonly - switch les modes d'alias
934 pour rendre NAT transparent, sameports renforce le moteur NAT pour
935 envoyer des paquets via le même port qu'ils arrivent, default -
936 désactive tous les modes mentionnés ci-dessus. (merci de voir <xref
937 linkend="nat-adv-alias" /> pour des détails).</para>
938 </listitem>
939 </itemizedlist></para>
940 </sect3>
941 </sect2>
942
943 <sect2 id="vboxmanage-modifyvm-other">
944 <title>Options du port série, du son, du presse-papier et de l'USB</title>
945
946 <para>Les autres paramètres matériels suivants sont disponibles avec
947 <computeroutput>VBoxManage modifyvm</computeroutput>&#xA0;:<itemizedlist>
948 <listitem>
949 <para><computeroutput>--uart&lt;1-N&gt; off|&lt;I/O base&gt;
950 &lt;IRQ&gt;</computeroutput>&#xA0;: Avec cette option, vous pouvez
951 configurer les ports série virtuels de la VM (voir <xref
952 linkend="serialports" /> pour une introduction.</para>
953 </listitem>
954
955 <listitem>
956 <para><computeroutput>--uartmode&lt;1-N&gt;
957 &lt;arg&gt;</computeroutput>&#xA0;: Ce paramètre contrôle la façon
958 dont VirtualBox se connecte à un port série virtuel donné (on la
959 configurait jadis avec l'option
960 <computeroutput>--uartX</computeroutput>, voir ci-dessus) sur l'hôte
961 sur lequel fonctionne la machine virtuelle. Comme décrit en détail
962 au <xref linkend="serialports" />, pour chaque port, vous pouvez
963 spécifier <computeroutput>&lt;arg&gt;</computeroutput> comme une des
964 options suivantes&#xA0;:<itemizedlist>
965 <listitem>
966 <para><computeroutput>disconnected</computeroutput>&#xA0;: Même
967 si le port série apparaît dans l'invité, il ne sert à rien --
968 comme un vrai port COM sans câble.</para>
969 </listitem>
970
971 <listitem>
972 <para><computeroutput>server
973 &lt;pipename&gt;</computeroutput>&#xA0;: Sur un hôte Windows,
974 ceci dit à VirtualBox de créer un tuyau nommé sur l'hôte,
975 appelé <computeroutput>&lt;pipename&gt;</computeroutput> et de
976 connecter le port série virtuel dessus. Remarquez que Windows
977 exige que le nom d'un tuyau nommé commence par
978 <computeroutput>\\.\pipe\</computeroutput>.</para>
979
980 <para>Sur un hôte Linux, plutôt qu'un tuyau nommé, une
981 socket de domaine local est utilisée.</para>
982 </listitem>
983
984 <listitem>
985 <para><computeroutput>client
986 &lt;pipename&gt;</computeroutput>&#xA0;: Ceci agit comme
987 <computeroutput>server ...</computeroutput>, sauf que le tuyau
988 (ou la socket de domaine local) n'est pas créée par VirtualBox,
989 mais est supposée déjà exister.</para>
990 </listitem>
991
992 <listitem>
993 <para><computeroutput>&lt;devicename&gt;</computeroutput>&#xA0;:
994 Si, au lieu de celui ci-dessus, le nom du périphérique du port
995 série matériel de l'hôte est spécifié, le port série virtuel est
996 connecté à ce port matériel. Sur un hôte Windows, le nom du
997 périphérique sera un port COM tel que
998 <computeroutput>COM1</computeroutput>&#xA0;; sur un hôte Linux,
999 le nom du périphérique ressemblera à
1000 <computeroutput>/dev/ttyS0</computeroutput>. Cela vous permet
1001 de "brancher" un vrai port série à une machine virtuelle.</para>
1002 </listitem>
1003 </itemizedlist></para>
1004 </listitem>
1005
1006 <listitem>
1007 <para><computeroutput>--audio none|null|oss</computeroutput>&#xA0;:
1008 Avec cette option, vous pouvez définir si la VM supporte le son.</para>
1009 </listitem>
1010
1011 <listitem>
1012 <para><computeroutput>--clipboard
1013 disabled|hosttoguest|guesttohost|bidirectional</computeroutput>&#xA0;:
1014 Avec ce paramètre, vous pouvez sélectionner si le presse-papier du
1015 système d'exploitation invité doit être partagé avec l'hôte&#xA0;; voir
1016 <xref linkend="generalsettings" />. Cela exige que les suppléments
1017 invité soient installés dans la machine virtuelle.</para>
1018 </listitem>
1019
1020 <listitem>
1021 <para><computeroutput>--monitorcount
1022 &lt;nombre&gt;</computeroutput>&#xA0;: Cela active le support multi-monitoeurs&#xA0;;
1023 voir <xref linkend="settings-display" />.</para>
1024 </listitem>
1025
1026 <listitem>
1027 <para><computeroutput>--usb on|off</computeroutput>&#xA0;: Cette
1028 option active ou désactive le contrôleur virtuel USB de la VM&#xA0;; voir
1029 <xref linkend="settings-usb" /> pour les détails.</para>
1030 </listitem>
1031
1032 <listitem>
1033 <para><computeroutput>--usbehci on|off</computeroutput>&#xA0;: Cette
1034 option active ou désactive le contrôleur USB 2.0 virtuel de la VM&#xA0;;
1035 voir <xref linkend="settings-usb" /> pour des détails.</para>
1036 </listitem>
1037 </itemizedlist></para>
1038 </sect2>
1039
1040 <sect2 id="vboxmanage-modifyvm-vrde">
1041 <title>Paramètres de la machine distante</title>
1042
1043 <para>Les paramètres suivants concernant le comportement de la machine
1044 distante sont disponibles avec <computeroutput>VBoxManage
1045 modifyvm</computeroutput>&#xA0;:<itemizedlist>
1046 <listitem>
1047 <para><computeroutput>--vrde on|off</computeroutput>&#xA0;: Avec
1048 l'interface graphique de VirtualBox, ceci active ou désactive le serveur
1049 VirtualBox remote desktop extension (VRDE). Remarquez que si vous
1050 utilisez <computeroutput>VBoxHeadless</computeroutput> (voir
1051 <xref linkend="vboxheadless" />), VRDE est activé par défaut.</para>
1052 </listitem>
1053
1054 <listitem>
1055 <para><computeroutput>--vrdeport
1056 default|&lt;ports&gt;</computeroutput>&#xA0;: Un port ou une plage
1057 deports que le serveur VRDE peut sonder&#xA0;; "default" ou "0"
1058 signifient le port 3389, le port RDP standard. Vous pouvez spécifier
1059 une liste de ports ou de plages de ports séparée par des virgules.
1060 Utilisez un tiret entre de numéros de ports pour spécifier une plage.
1061 Le serveur VRDE sondera <emphasis role="bold">un</emphasis> des
1062 ports disponibles dans la liste spécifiée. Une seule machine peut utiliser
1063 un port donné en même temps. Par exemple, l'option <computeroutput> --vrdeport
1064 5000,5010-5012</computeroutput> dira au serveur de sonder un des ports
1065 suivants&#xA0;: 5000, 5010, 5011 ou 5012.</para>
1066 </listitem>
1067
1068 <listitem>
1069 <para><computeroutput>--vrdeaddress &lt;adresse IP
1070 &gt;</computeroutput>&#xA0;: L'adresse IP de l'interface réseau de
1071 l'hôte que sondera le serveur VRDE. Si vous la spécifiez, leserveur
1072 n'acceptra les connexions que sur l'interface de l'hôte spécifiée.</para>
1073 <para>On peut utiliser ce paramètre pour indiquer si le serveur
1074 VRDP devrait accepter des donnexions IPv4, IPv6 ou les deux :
1075 <itemizedlist>
1076 <listitem>
1077 <para>IPv4 seulement : <computeroutput>--vrdeaddress "0.0.0.0"
1078 </computeroutput></para>
1079 </listitem>
1080 <listitem>
1081 <para>IPv6 seulement : <computeroutput>--vrdeaddress "::"
1082 </computeroutput></para>
1083 </listitem>
1084 <listitem>
1085 <para>IPv6 et IPv4 (par défaut) : <computeroutput>--vrdeaddress ""
1086 </computeroutput></para>
1087 </listitem>
1088 </itemizedlist></para>
1089 </listitem>
1090
1091 <listitem>
1092 <para><computeroutput>--vrdeauthtype
1093 null|external|guest</computeroutput>&#xA0;: Cela vous permet de choisir
1094 s'il faut une autorisation et sous quelle forme&#xA0;; voir <xref
1095 linkend="vbox-auth" /> pour des détails.</para>
1096 </listitem>
1097
1098 <listitem>
1099 <para><computeroutput>--vrdemulticon on|off</computeroutput>&#xA0;: Ceci
1100 active la multiconnexions au même serveur VRDE si le serveur supporte
1101 cette fonction ; voir <xref lang=""
1102 linkend="vrde-multiconnection" />.</para>
1103 </listitem>
1104
1105 <listitem>
1106 <para><computeroutput>--vrdereusecon on|off</computeroutput>&#xA0;: Ceci
1107 spécifie le comportement du serveur VRDE quand plusieurs connexions
1108 sont désactivées. Quand on active cette option, le serveur autorisera
1109 un nouveau client à se connecter et il fermera la connexion existante.
1110 Quand cette option est désactivée (c'est le réglage par défaut), une
1111 nouvelle connexion ne sera pas acceptée si un client est déjà connecté
1112 au serveur.</para>
1113 </listitem>
1114
1115 <listitem>
1116 <para><computeroutput>--vrdevideochannel on|off</computeroutput>&#xA0;:
1117 Ceci active la redirection graphique, si elle est supportée par le
1118 serveur VRDE&#xA0;; voir <xref lang="" linkend="vrde-videochannel" />.</para>
1119 </listitem>
1120
1121 <listitem>
1122 <para><computeroutput>--vrdevideochannelquality
1123 &lt;pourcent&gt;</computeroutput>&#xA0;: Définit la qualité de l'image
1124 dans la redirection graphique&#xA0;; voir <xref lang=""
1125 linkend="vrde-videochannel" />.</para>
1126 </listitem>
1127 </itemizedlist></para>
1128 </sect2>
1129
1130 <sect2 id="vboxmanage-modifyvm-teleport">
1131 <title>Paramètres de téléportation</title>
1132
1133 <para>Avec les commandes suivantes pour <computeroutput>VBoxManage
1134 modifyvm</computeroutput>, vous pouvez configurer une machine pour qu'elle
1135 soit une cible de téléportation. Voir <xref linkend="teleporting" /> pour
1136 une introduction détaillée.<itemizedlist>
1137 <listitem>
1138 <para><computeroutput>--teleporter on|off</computeroutput>&#xA0;: Avec
1139 ce paramètre, vous activez ou désactivez l'attente par une machine
1140 d'une requête de téléportation venant du réseau lorsqu'elle est
1141 démarrée. Si elle est activée, quand on démarre la machine, cela ne
1142 démarre pas la machine virtuelle comme cela est normalement le cas,
1143 mais cela attend qu'une requête de téléportation n'arrive à l'adresse
1144 listée avec les deux options suivantes.</para>
1145 </listitem>
1146
1147 <listitem>
1148 <para><computeroutput>--teleporterport
1149 &lt;port&gt;</computeroutput>, <computeroutput>--teleporteraddress
1150 &lt;adresse&gt;</computeroutput>&#xA0;: il faut les utiliser avec
1151 --teleporter et elle dit à une machine virtuelle le port et l'adresse
1152 sur lesquelles elle doit écouter les demandes de téléportation d'une
1153 autre machine virtuelle. <computeroutput>&lt;port&gt;</computeroutput>
1154 peut être n'importe quel numéro de port TCP/IP libre (comme 6000)&#xA0;;
1155 <computeroutput>&lt;adresse&gt;</computeroutput> peut être n'importe
1156 quelle adresse IP ou nom d'hôte et il spécifie une socket TCP/IP
1157 à sonder. Par défaut, c'est "0.0.0.0", ce qui signifie toutes les
1158 adresses.</para>
1159 </listitem>
1160
1161 <listitem>
1162 <para><computeroutput>--teleporterpassword
1163 &lt;mot_de_passe&gt;</computeroutput>&#xA0;: si vous donnez cet
1164 argument facultatif, la requête de téléportation ne réussira que si
1165 la machine source spécifie le même mot de passe que celui donné avec
1166 cette commande.</para>
1167 </listitem>
1168
1169 <listitem>
1170 <para><computeroutput>--teleporterfichier_mot_de_passe
1171 &lt;mot_de_passe&gt;</computeroutput>&#xA0;: si vous donnez cet
1172 argument facultatif, la requête de téléportation ne réussira que si
1173 la machine source spécifie le même mot de passe que celui spécifié
1174 dans le fichier donné avec cette commande. Utilisez
1175 <computeroutput>stdin</computeroutput> pour lire le mot de passe à
1176 partir de l'entrée standard.</para>
1177 </listitem>
1178
1179 <listitem>
1180 <para><computeroutput>--cpuid &lt;leaf&gt; &lt;eax&gt; &lt;ebx&gt;
1181 &lt;ecx&gt; &lt;edx&gt;</computeroutput>&#xA0;: Les utilisateurs
1182 avancés peuvent utiliser cette commande avant une opération de
1183 téléportation pour restreindre les possibilités du processeur virtuel
1184 présenté par VirtualBox au système d'exploitation invité. Il faut
1185 l'exécuter à la fois sur la machine source et cible.
1186 impliquées dans la téléportation et cela modifiera ce que l'invité
1187 verra quand il exécutera l'instruction machine
1188 <computeroutput>CPUID</computeroutput>. Cel pourrait aider les applications
1189 se comportant mal à cause d'un mauvais présupposé sur la présence de
1190 certaines capacités du processeur. La signification des paramètres
1191 dépend do matériel&#xA0;; merci de vous reporter aux manuels des
1192 processeurs AMD ou Intel.</para>
1193 </listitem>
1194 </itemizedlist></para>
1195 </sect2>
1196 </sect1>
1197
1198 <sect1 id="vboxmanage-clonevm">
1199 <title>VBoxManage clonevm</title>
1200
1201 <para>Cette commande crée une copie complète ou liée d'une
1202 machine virtuelle existante.</para>
1203
1204 <para>La sous-commande <computeroutput>clonevm</computeroutput> prend
1205 au moins en argument le nom de la machine virtuelle à cloner. Vous pouvez
1206 utiliser les paramètres supplémentaires suivants pour configurer davantage
1207 la procédure de clonage de la VM&#xA0;:</para>
1208
1209 <itemizedlist>
1210 <listitem>
1211 <para><computeroutput>--snapshot &lt;uuid&gt;|&lt;nom&gt;</computeroutput>&#xA0;:
1212 Sélectionne un instantané spécifique auquel se reporte le processus
1213 de clonage. Par défaut, c'est à l'état courant qu'il se réfère.</para>
1214 </listitem>
1215 <listitem>
1216 <para><computeroutput>--mode machine|machineandchildren|all</computeroutput>&#xA0;:
1217 Sélectionne le mode de clonage. Si
1218 <computeroutput>machine</computeroutput> est sélectionnée (comme par
1219 défaut), l'état actuel de la VM sans instantanés est cloné. En mode
1220 <computeroutput>machineandchildren</computeroutput>, l'instantané
1221 fourni par <computeroutput>--snapshot</computeroutput> et tous les
1222 instantanés fils sont clonés. Si vous
1223 sélectionnez le mode <computeroutput>all</computeroutput>, tous les
1224 instantanés de l'état actuel seront clonés.
1225 </para>
1226 </listitem>
1227 <listitem>
1228 <para><computeroutput>--options link|keepallmacs|keepnatmacs|keepdisknames</computeroutput>&#xA0;:
1229 Permet de peaufiner encore davantage l'opération de clonage.
1230 La première dit de créer un clone lié, ce qui n'est possible que pour
1231 le clonage d'une machine à partir d'un instantané. Les deux options
1232 suivantes permettent de définir la façon dont les adresses MAC de chaque
1233 carte réseau virtuel seront gérées. Elles peuvent être soit réinitialisées
1234 (comme par défaut), soit inchangées
1235 (<computeroutput>keepallmacs</computeroutput>), soit inchangées
1236 quand le type de réseau est NAT
1237 (<computeroutput>keepnatmacs</computeroutput>). Si vous ajoutez
1238 <computeroutput>keepdisknames</computeroutput>, toutes les nouvelles
1239 images de disque dur s'appellent comme celles d'origine, sinon elles
1240 sont renommées.</para>
1241 </listitem>
1242 <listitem>
1243 <para><computeroutput>--name &lt;name&gt;</computeroutput>&#xA0;:
1244 Sélectionne un nouveau nom pour la nouvelle machine virtuelle. Par défaut,
1245 il s'agit de "Nom d'origine Clone".</para>
1246 </listitem>
1247 <listitem>
1248 <para><computeroutput>--basefolder &lt;basefolder&gt;</computeroutput>&#xA0;:
1249 Sélectionne le dossier où devrait être sauvegardée la configuration.</para>
1250 </listitem>
1251 <listitem>
1252 <para><computeroutput>--uuid &lt;uuid&gt;</computeroutput>&#xA0;:
1253 Sélectionne l'UUID de la nouvelle VM. Cette id doit être unique dans
1254 l'instance de VirtualBox où ce clone doit être enregistré. Par défaut,
1255 un nouvel UUID est créé.</para>
1256 </listitem>
1257 <listitem>
1258 <para><computeroutput>--register</computeroutput>&#xA0;:
1259 Enregistre automatiquement le nouveau clone dans l'installation de
1260 VirtualBox. Si vous voulez enregistrer la nouvelle VM plus tard à la
1261 main, voir <xref linkend="vboxmanage-registervm" /> pour les
1262 instructions pour faire cela.</para>
1263 </listitem>
1264 </itemizedlist>
1265 </sect1>
1266
1267 <sect1 id="vboxmanage-import">
1268 <title>VBoxManage import</title>
1269
1270 <para>Cette commande importe un applicatif virtuel au format OVF en copiant
1271 les images de disque virtuelles et en créant les machines virtuelles dans
1272 VirtualBox. Voir
1273 <xref linkend="ovf" /> pour une présentation des applicatifs.</para>
1274
1275 <para>La commande <computeroutput>import</computeroutput> prend comme
1276 argument au moins le chemin d'un fichier OVF en entrée et elle attend que les
1277 images de disque, s'il en faut, soient dans le même répertoire que le fichier
1278 OVF. Beaucoup d'autres options en ligne de commande sont supportées pour
1279 contrôler en détails ce qui est importé et pour modifier les paramètres
1280 d'importation, mais les détails dépendent du contenu du fichier OVF.</para>
1281
1282 <para>Il est donc recommandé de lancer d'abord la sous-commande import avec
1283 l'option <computeroutput>--dry-run</computeroutput> ou
1284 <computeroutput>-n</computeroutput>. Cela affichera alors à l'écran le contenu
1285 d'un applicatif et la façon de l'importer dans VirtualBox, ainsi que
1286 les options facultatives en ligne de commandes pour influencer le comportement
1287 de l'importation.</para>
1288
1289 <para>Par exemple, voilà l'écran qui s'afficherait pour un applicatif modèle
1290 contenant un invité Windows XP&#xA0;:<screen>VBoxManage import WindowsXp.ovf --dry-run
1291Interpreting WindowsXp.ovf...
1292OK.
1293Virtual system 0:
1294 0: Suggested OS type: "WindowsXP"
1295 (change with "--vsys 0 --ostype &lt;type&gt;"; use "list ostypes" to list all)
1296 1: Suggested VM name "Windows XP Professional_1"
1297 (change with "--vsys 0 --nomvm &lt;name&gt;")
1298 3: Number of CPUs: 1
1299 (change with "--vsys 0 --cpus &lt;n&gt;")
1300 4: Guest memory: 956 MB (change with "--vsys 0 --memory &lt;MB&gt;")
1301 5: Sound card (appliance expects "ensoniq1371", can change on import)
1302 (disable with "--vsys 0 --unit 5 --ignore")
1303 6: USB controller
1304 (disable with "--vsys 0 --unit 6 --ignore")
1305 7: Network adapter: orig bridged, config 2, extra type=bridged
1306 8: Floppy
1307 (disable with "--vsys 0 --unit 8 --ignore")
1308 9: SCSI controller, type BusLogic
1309 (change with "--vsys 0 --unit 9 --scsitype {BusLogic|LsiLogic}";
1310 disable with "--vsys 0 --unit 9 --ignore")
131110: IDE controller, type PIIX4
1312 (disable with "--vsys 0 --unit 10 --ignore")
131311: Hard disk image: source image=WindowsXp.vmdk,
1314 target path=/home/user/disks/WindowsXp.vmdk, controller=9;channel=0
1315 (change controller with "--vsys 0 --unit 11 --controller &lt;id&gt;";
1316 disable with "--vsys 0 --unit 11 --ignore")</screen></para>
1317
1318 <para>Comme vous pouvez le voir, les éléments de configuration individuelle
1319 sont numérotés et en fonction de leur type de support, les options en ligne
1320 de commande. La sous-commande import peut être redirigée pour ignorer
1321 de nombreux éléments tels que ceux avec des options
1322 <computeroutput>--vsys X --unit Y --ignore</computeroutput>, où
1323 X est le numéro du système virtuel (zéro sauf s'il y a plusieurs
1324 descriptions de système virtuel dans l'applicatif) et Y le numéro de l'élément,
1325 tel qu'affiché à l'écran.</para>
1326
1327 <para>Dans l'exemple ci-dessus, Item #1 spécifie le nom de la
1328 machine cible dans VirtualBox. Items #9 et #10 spécifient respectivement les
1329 contrôleurs de disque. Item #11 décrit une image de disque dur&#xA0;; dans ce
1330 cas, l'option supplémentaire <computeroutput>--controller</computeroutput>
1331 indique l'élément auquel devrait être connectée l'image de disque, avec le
1332 fichier OVF d'origine par défaut.</para>
1333
1334 <para>Vous pouvez associer plusieurs éléments pour un même système virtuel
1335 derrière une même option <computeroutput>--vsys</computeroutput>. Par exemple,
1336 pour importer une machine comme décrit dans l'OVF mais sans la carte son
1337 ni le contrôleur USB, mais avec l'image de disque connectée au contrôleur IDE
1338 au lieu du contrôleur SCSI, utilisez ceci&#xA0;:<screen>VBoxManage import WindowsXp.ovf
1339 --vsys 0 --unit 5 --ignore --unit 6 --ignore --unit 11 --controller 10</screen></para>
1340 </sect1>
1341
1342 <sect1 id="vboxmanage-export">
1343 <title>VBoxManage export</title>
1344
1345 <para>Cette commande exporte une ou plusieurs machines virtuelles à partir
1346 de VirtualBox vers un applicatif virtuel au format OVF, ce qui inclut la
1347 copie de leurs images de disque virtuel en VMDK compressé. Voir <xref linkend="ovf" />
1348 pour une présentation des applicatifs.</para>
1349
1350 <para>La commande <computeroutput>export</computeroutput> est simple à
1351 utiliser&#xA0;: affichez la machine (ou les machines) que vous voulez
1352 exporter dans un même fichier OVF et spécifiez le fichier OVF cible après
1353 l'option facultative <computeroutput>--output</computeroutput> ou
1354 <computeroutput>-o</computeroutput>. Remarquez que le répertoire du fichier
1355 cible OVF recevra également les images de disques exportés au format VNDK
1356 compressé (quel que soit le format d'origine) et vous devriez leur laisser
1357 assez d'espace disque.</para>
1358
1359 <para>Derrière une simple exportation d'une machine virtuelle donnée, vous
1360 pouvez ajouter diverses informations produit dans le fichier applicatif.
1361 Utilisez <computeroutput>--product</computeroutput>,
1362 <computeroutput>--producturl</computeroutput>,
1363 <computeroutput>--vendor</computeroutput>,
1364 <computeroutput>--vendorurl</computeroutput> et
1365 <computeroutput>--version</computeroutput> pokr spécifier les
1366 informations supplémentaires. Pour des raisons légales, vous pouvez ajouter
1367 un texte de licence ou le contenu d'un fichier de licence en utilisant
1368 respectivement les options <computeroutput>--eula</computeroutput> et
1369 <computeroutput>--eulafile</computeroutput>. Comme avec l'importation
1370 OVF, vous devez utiliser l'option <computeroutput>--vsys X</computeroutput>
1371 pour adresser les options précitées à la bonne
1372 machine virtuelle.</para>
1373
1374 <para>Pour les produits de virtualisation non pleinement compatibles avec
1375 le standard OVF 1.0, vous pouvez activer un mode OVF 0.9 basique avec
1376 l'option <computeroutput>--legacy09</computeroutput>.</para>
1377 </sect1>
1378
1379 <sect1 id="vboxmanage-startvm">
1380 <title>VBoxManage startvm</title>
1381
1382 <para>Cette commande démarre une machine virtuelle qui est en état "Éteinte"
1383 ou "Sauvegardée".</para>
1384
1385 <para>Le paramètre facultatif <computeroutput>--type</computeroutput>
1386 détermine si la machine sera démarrée dans une fenêtre ou si la sortie devrait passer par
1387 <computeroutput>VBoxHeadless</computeroutput>, en activant ou pas VRDE&#xA0;;
1388 voir <xref linkend="vboxheadless" /> pour plus d'informations. La liste
1389 des types peut changer et il n'est pas garanti que tous les types sont
1390 acceptés par la variante d'un produit.</para>
1391
1392 <para>La valeur par défaut, globale ou individuelle à une VM, du type
1393 d'interface d'une VM sera utilisée si vous ne spécifiez pas explicitement
1394 le type. Si aucune n'est définie, c'est la variante GUI qui sera démarrée.</para>
1395 <para>Les valeurs suivantes sont autorisées&#xA0;:</para>
1396
1397 <glosslist>
1398 <glossentry>
1399 <glossterm><computeroutput>gui</computeroutput></glossterm>
1400
1401 <glossdef>
1402 <para>Démarre une VM en affichant une fenêtre graphique. C'est le cas
1403 par défaut.</para>
1404 </glossdef>
1405 </glossentry>
1406
1407 <glossentry>
1408 <glossterm><computeroutput>headless</computeroutput></glossterm>
1409
1410 <glossdef>
1411 <para>Démarre une VM sans fenêtre pour un affichage distant.</para>
1412 </glossdef>
1413 </glossentry>
1414
1415 <glossentry>
1416 <glossterm><computeroutput>sdl</computeroutput></glossterm>
1417
1418 <glossdef>
1419 <para>Démarre une VM avec une GUI minimale et limitée dans ses
1420 fonctionnalités.</para>
1421 </glossdef>
1422 </glossentry>
1423 </glosslist>
1424
1425 <note>
1426 <para>Si vous rencontrez des problèmes en démarrant des machines virtuelles
1427 avec certaines interfaces et s'il n'y a pas d'informations d'erreur
1428 convaincantes, essayez de démarrer les machines virtuelles en lançant
1429 directement leur interface respective, car cela peut donner des informations
1430 supplémentaires sur l'erreur.</para>
1431 </note>
1432 </sect1>
1433
1434 <sect1 id="vboxmanage-controlvm">
1435 <title>VBoxManage controlvm</title>
1436
1437 <para>La sous-commande <computeroutput>controlvm</computeroutput> vous permet
1438 modifier l'état d'une machine virtuelle en fonction. Vous pouvez spécifiar
1439 ce qui suit&#xA0;:</para>
1440
1441 <para><itemizedlist>
1442 <listitem>
1443 <para><computeroutput>VBoxManage controlvm &lt;vm&gt;
1444 pause</computeroutput> met temporairement une machine virtuelle en
1445 attente, sans vraiment changer son état. La fenêtre de la VM sera grisée
1446 pour indiquer que la VM est actuellement en pause. (Cela revient à
1447 sélectionner l'élément "Pause" dans le menu "Machine" de l'interface
1448 graphique.)</para>
1449 </listitem>
1450
1451 <listitem>
1452 <para>Utilisez <computeroutput>VBoxManage controlvm &lt;vm&gt;
1453 resume</computeroutput> pour inverser une commande
1454 <computeroutput>pause</computeroutput> précédente. (Cela revient à
1455 sélectionner l'élément "Reprendre" du menu "Machine" de l'interface
1456 graphique.)</para>
1457 </listitem>
1458
1459 <listitem>
1460 <para><computeroutput>VBoxManage controlvm &lt;vm&gt;
1461 reset</computeroutput> a le même effet sur une machine virtuelle que
1462 l'appui sur le bouton "Reset" d'un vrai ordinateur&#xA0;: un redémarrage
1463 à froid de la machine virtuelle, ce qui redémarrera le système d'exploitation
1464 invité immédiatement. L'état de la VM n'est pas sauvegardé et des
1465 données peuvent être perdues. (Cela revient à sélectionner l'élément
1466 "Réinitialiser" du menu "Machine" de l'interface graphique.)</para>
1467 </listitem>
1468
1469 <listitem>
1470 <para><computeroutput>VBoxManage controlvm &lt;vm&gt;
1471 poweroff</computeroutput> a le même effet sur une machine virtuelle que
1472 de débrancher le câble d'alimentation d'un vrai ordinateur. Là encore,
1473 l'état de la VM n'est pas sauvegardé et il se peut que des données soient
1474 perdues. (Cela revient à sélectionner l'élément "Couper" de l'interface
1475 graphique ou à appuyer sur le bouton Fermer de la fenêtre puis
1476 sélectionner "Couper la machine" dans la boîte de dialogue.)</para>
1477
1478 <para>Après cela, l'état de la VM sera "éteint". À partir de là, vous
1479 pouvez la relancer&#xA0;; voir <xref
1480 linkend="vboxmanage-startvm" />.</para>
1481 </listitem>
1482
1483 <listitem>
1484 <para><computeroutput>VBoxManage controlvm &lt;vm&gt;
1485 savestate</computeroutput> sauvegardera l'état actuel de la VM sur le
1486 disque et arrêtera la VM. (Cela revient à sélectionner l'élément
1487 "Fermer" du menu "Machine" de l'interface graphique ou à appuyer sur
1488 le bouton fermer de la fenêtre et sélectionner "Sauvegarder l'état de
1489 la machine" dans la boîte de dialogue.)</para>
1490
1491 <para>Après cela, l'çtat de la machine sera "Sauveegardé". À partir de
1492 là, vous pouvez la relancer&#xA0;; voir
1493<xref linkend="vboxmanage-startvm" />.</para>
1494 </listitem>
1495
1496 <listitem>
1497 <para><computeroutput>VBoxManage controlvm &lt;vm&gt; teleport
1498 --hostname &lt;nom&gt; --port &lt;port&gt; [--passwordfile
1499 &lt;fichier&gt; | --password &lt;mot_de_passe&gt;]</computeroutput>
1500 passe la machine en source de téléportation et engage une téléportation
1501 sur la cible donnée. Voir <xref linkend="teleporting" /> pour une
1502 présentation. Si vous spécifiez le mot de passe facultatif, il doit
1503 correspondre à celui donné avec la commande
1504 <computeroutput>modifyvm</computeroutput> pour la
1505 machine cible&#xA0;; voir <xref linkend="vboxmanage-modifyvm-teleport" />
1506 pour des détails.</para>
1507 </listitem>
1508 </itemizedlist></para>
1509
1510 <para>Quelques options supplémentaires sont disponibles avec
1511 <computeroutput>controlvm</computeroutput>, ne modifiant pas directement
1512 l'état de la VM en fonction&#xA0;:</para>
1513
1514 <itemizedlist>
1515 <listitem>
1516 <para>L'opération <computeroutput>setlinkstate&lt;1-N&gt;</computeroutput>
1517 connecte ou déconnecte les câbles réseaux virtuels à leurs interfaces
1518 réseaux.</para>
1519 </listitem>
1520
1521 <listitem>
1522 <para><computeroutput>nic&lt;1-N&gt;
1523 null|nat|bridged|intnet|hostonly|generic</computeroutput>&#xA0;: Avec
1524 ceci, vous pouvez définir, pour chaque carte réseau virtuelle de la VM,
1525 le type de réseau qui devrait être disponible. Elles peuvent ne pas être
1526 connectées à l'hôte
1527 (<computeroutput>null</computeroutput>), utiliser network address
1528 translation (<computeroutput>nat</computeroutput>), le résaeau bridgé
1529 (<computeroutput>bridged</computeroutput>) ou communiquer avec d'autres
1530 machines virtuelles en utilisant le réseau interne
1531 (<computeroutput>intnet</computeroutput>) ou host-only
1532 (<computeroutput>hostonly</computeroutput>) ou accéder à des sous-modes
1533 rarement utilisés
1534 (<computeroutput>generic</computeroutput>). Ces options correspondent
1535 aux modes décrits en détails au <xref
1536 linkend="networkingmodes" />.</para>
1537 </listitem>
1538
1539 <listitem>
1540 <para><computeroutput>usbattach</computeroutput> et
1541 <computeroutput>usbdettach</computeroutput> rendent les pçriphériques
1542 USB de l'hôte, à la volée, visibles pour la machine virtuelle sans besoin de
1543 créer des filtres préalablement. Les périphériques USB peuvent être désignés
1544 par leur UUID (identifiant unique) ou leur adresse sur le système hôte.</para>
1545
1546 <para>Vous pouvez utiliser <computeroutput>VBoxManage list
1547 usbhost</computeroutput> pour trouver ces informations.</para>
1548 </listitem>
1549
1550 <listitem>
1551 <para><computeroutput>vrde on|off</computeroutput> vous permet d'activer
1552 ou de désactiver le serveur VRDP s'il est installé.</para>
1553 </listitem>
1554
1555 <listitem>
1556 <para><computeroutput>vrdeport default|&lt;ports&gt;</computeroutput>
1557 modifie le port ou la plage de ports que peut sonder le serveur
1558 VRDP&#xA0;; "default" ou "0" signifient le port 3389, celui standard
1559 pour RDP. Pour des détails, voir la description de l'option
1560 <computeroutput>--vrdeport</computeroutput> au <xref
1561 linkend="vboxmanage-modifyvm-other" />.</para>
1562 </listitem>
1563
1564 <listitem>
1565 <para><computeroutput>setvideomodehint</computeroutput> demande
1566 que le système invité passe dans un mode graphique particulier. Cela exige
1567 l'installation des suppléments invité et ne fonctionner pas pour tous
1568 les systèmes invités.</para>
1569 </listitem>
1570
1571 <listitem>
1572 <para><computeroutput>screenshotpng</computeroutput> prend une impression
1573 écran de l'affichage invité et le sauvegarde au format PNG.</para>
1574 </listitem>
1575
1576 <listitem>
1577 <para>L'opération <computeroutput>setcredentials</computeroutput> est
1578 utilisé pour les identifications distantes dans les invités Windows.
1579 Pour des détails, merci de vous reporter au
1580 <xref linkend="autologon" />.</para>
1581 </listitem>
1582
1583 <listitem>
1584 <para>L'opération <computeroutput>guestmemoryballoon</computeroutput>
1585 modifie la taille du ballon de la mémoire de l'invité, c'est-à-dire la
1586 mémoire affectée par les suppléments invité de VirtualBox au système
1587 d'exploitation invité et rendue à l'hyperviseur pour être réutilisée
1588 par d'autres machines virtuelles. Elle doit être spécifiée en mégaoctets.
1589 Pour des détails, voir <xref linkend="guestadd-balloon" />.</para>
1590 </listitem>
1591
1592 <listitem>
1593 <para><computeroutput>cpuexecutioncap
1594 &lt;1-100&gt;</computeroutput>&#xA0;: Cette opération contrôle la
1595 quantité de temps processeur que peut utiliser un processeur virtuel.
1596 Une valeur de 50 implique qu'un seul processeur virtuel peut utiliser
1597 jusqu'à 50% d'un seul processeur de l'hôte.</para>
1598 </listitem>
1599 </itemizedlist>
1600 </sect1>
1601
1602 <sect1>
1603 <title>VBoxManage discardstate</title>
1604
1605 <para>Cette commande désactive l'état sauvegardé d'une machine virtuelle
1606 qui n'est pas en fonction, ce qui fera redémarrer son système d'exploitation
1607 la prochaine fois que vous démarrerez. Cela revient à débrancher le câble
1608 d'alimentation d'une machine physique et vous devrieu l'éviter si possible.</para>
1609 </sect1>
1610
1611 <sect1>
1612 <title>VBoxManage adoptstate</title>
1613
1614 <para>Si vous avez un fichier d'çtat sauvegardé
1615 (<computeroutput>.sav</computeroutput>), c'est-à-dire séparé de la configuration
1616 de la VM, vous pouvez "adopter" le fichier. Cela passera la VM en état
1617 sauvegardé et quand vous la démarrerez, VirtualBox essaiera de la restaurer
1618 à partir du fichier d'état sauvegardé que vous avez indiqué. Cette commande
1619 ne devrait être utilisée que dans des configurations spéciales.</para>
1620 </sect1>
1621
1622 <sect1>
1623 <title>VBoxManage snapshot</title>
1624
1625 <para>Cette commande est utilisée pour contrôler les instantanés en ligne de
1626 commande. Un instantané consiste en une copie complète des paramètres de la
1627 machine virtuelle, copiés à un moment où l'instantané a été pris, et éventuellement
1628 un fichier d'état sauvegardé de la machine virtuelle si l'instantané a été
1629 pris alors que la machine était en fonction. Après qu'un instantné a été pris,
1630 VirtualBox cre un disque dur de différenciatin pour chaque disque dur normal
1631 associé à la machine pour que, quand on restaure un instantané, les disques durs
1632 virtuels de la machine virtuelle puissent être rapidement réinitialisés en
1633 reabandonnant simplement les fichiers de différenciation.</para>
1634
1635 <para>L'opération <computeroutput>take</computeroutput> prend un instantané de
1636 l'état actuel de la machne viruelle. Vous devez fournir un nom pour l'instantané
1637 et vous pouvez éventuellement entrer une description. Le nouvel instantané est
1638 inséré à l'arborescence des instantanés comme un fichier de l'instantané
1639 actuel et il devient le nouvel instantané actuel. Le paramètre
1640 <computeroutput>--description</computeroutput> permet de décrire
1641 l'instantané. Si vous spécifiez <computeroutput>--live</computeroutput>,
1642 la VM ne s'arrêtera pas pendant la créqation de l'instantané.</para>
1643
1644 <para>L'opération <computeroutput>delete</computeroutput> efface un
1645 instantané (spécifié par son nom ou son UUID). Cela peut être long à se
1646 terminer car les images de différenciation associées à l'instantané pourraient
1647 devoir être synchronisées avec leurs images de différenciation filles.</para>
1648
1649 <para>L'opération <computeroutput>restore</computeroutput> restaurera l'instantané
1650 donné (spécifié par son nom ou son UUID) en réinitialisant les paramètres
1651 de la machine virtuelle et l'état actuel à ceux de l'instantané. L'état
1652 actuel précédent de la machine sera perdu. Après cela, l'instantané donné
1653 devient le nouvel instantané "actuel" pour que les instantanés consécutifs
1654 s'insèrent sous l'instantané à partir duquel on a restauré.</para>
1655
1656 <para>L'opération <computeroutput>restorecurrent</computeroutput> est un
1657 raccourci pour restaurer l'instantané actuel (donc l'instantané d'où provient
1658 l'état actuel). Cette sous-commande revient à utiliser la sous-commande
1659 "restore" avec le nom ou l'UUID de l'instantané actuel, sauf qu'elle évite
1660 l'étape supplémentaire de déterminer ce nom ou cet UUID.</para>
1661
1662 <para>Avec l'opération <computeroutput>edit</computeroutput>, vous pouvez
1663 modifier le nom ou la description d'un instantané existant.</para>
1664
1665 <para>Avec l'opération <computeroutput>showvminfo</computeroutput>, vous
1666 pouvez voir les paramètres de la machine virtuelle stockées dans un instantané
1667 existant.</para>
1668 </sect1>
1669
1670 <sect1 id="vboxmanage-closemedium">
1671 <title>VBoxManage closemedium</title>
1672
1673 <para>Cette commande supprime un fichier image de disque dur, de DVD ou
1674 disquette, d'un registre de médias VirtualBox.<footnote>
1675 <para>Avant VirtualBox 4.0, il fallait appeler VBoxManage
1676 openmedium avant de pouvoir attacher à média à une machine virtuelle&#xA0;;
1677 cet appel "enregistrait" le média avec le registre des médias global de
1678 VirtualBox. Avec VirtualBox 4.0, ce n'est plus nécessaire&#xA0;; les
1679 médias sont ajoutés aux registres des médias automatiquement. L'appel
1680 "closemedium" a cependant été conservé pour permettre de supprimer
1681 explicitement un média du registre.</para>
1682 </footnote></para>
1683
1684 <para>Éventuellement, vous pouvez demander que l'image seit effacée. Vous aurez
1685 les retours circonstanciés selon lesquels la suppression a échoué, mais l'image
1686 ne sera pas enregistrée.</para>
1687 </sect1>
1688
1689 <sect1 id="vboxmanage-storageattach">
1690 <title>VBoxManage storageattach</title>
1691
1692 <para>Cette commande attache/modifie/supprime un média de stockage connecté
1693 à un contrôleur de stockage précédemment ajouté avec la commande
1694 <computeroutput>storagectl</computeroutput> command (voir la section précédente).
1695 La syntaxe est ainsi&#xA0;:</para>
1696
1697 <screen>VBoxManage storageattach &lt;uuid|nomvm&gt;
1698 --storagectl &lt;name&gt;
1699 [--port &lt;number&gt;]
1700 [--device &lt;number&gt;]
1701 [--type dvddrive|hdd|fdd]
1702 [--medium none|emptydrive|
1703 &lt;uuid&gt;|&lt;filename&gt;|host:&lt;drive&gt;|iscsi]
1704 [--mtype normal|writethrough|immutable|shareable]
1705 [--comment &lt;text&gt;]
1706 [--setuuid &lt;uuid&gt;]
1707 [--setparentuuid &lt;uuid&gt;]
1708 [--passthrough on|off]
1709 [--tempeject on|off]
1710 [--nonrotational on|off]
1711 [--discard on|off]
1712 [--bandwidthgroup name|none]
1713 [--forceunmount]
1714 [--server &lt;name&gt;|&lt;ip&gt;]
1715 [--target &lt;target&gt;]
1716 [--tport &lt;port&gt;]
1717 [--lun &lt;lun&gt;]
1718 [--encodedlun &lt;lun&gt;]
1719 [--username &lt;username&gt;]
1720 [--password &lt;password&gt;]
1721 [--initiator &lt;initiator&gt;]
1722 [--intnet]</screen>
1723
1724 <para>Un certain nombre de paramètres sont requis classiquement&#xA0;; ceux
1725 à la fin de la liste ne sont requis que pour les cibles iSCSI (voir ci-dessous).</para>
1726
1727 <para>Les paramètres classiques sont&#xA0;:<glosslist>
1728 <glossentry>
1729 <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
1730
1731 <glossdef>
1732 <para>Le nom ou l'UUID de la VM. Obligatoire.</para>
1733 </glossdef>
1734 </glossentry>
1735
1736 <glossentry>
1737 <glossterm><computeroutput>storagectl</computeroutput></glossterm>
1738
1739 <glossdef>
1740 <para>Nom du contrôleur de stockage. Obligatoire. Vous pouvez obtenir
1741 la liste des contrôleurs de stockage actuellement attachés à une VM
1742 avec <computeroutput>VBoxManage showvminfo</computeroutput>&#xA0;; voir
1743 <xref linkend="vboxmanage-showvminfo" />.</para>
1744 </glossdef>
1745 </glossentry>
1746
1747 <glossentry>
1748 <glossterm>port</glossterm>
1749
1750 <glossdef>
1751 <para>Le numéro du port du contrôleur de stockage qui doit être
1752 modifié. Obligatoire, sauf si le contrôleur de stockage n'a qu'un
1753 seul port.</para>
1754 </glossdef>
1755 </glossentry>
1756
1757 <glossentry>
1758 <glossterm>device</glossterm>
1759
1760 <glossdef>
1761 <para>Le numéro du périphérique du port à modifier. Obligatoire,
1762 sauf si le contrôleur de stockage n'a qu'un périphérique par port.</para>
1763 </glossdef>
1764 </glossentry>
1765
1766 <glossentry>
1767 <glossterm>type</glossterm>
1768
1769 <glossdef>
1770 <para>Définit le type de lecteur auquel doit être
1771 attaché/détaché/modifié un média. On ne peut se passer de cet
1772 argument que si le type de média peut être déterminé par le média
1773 donné avec l'argument <computeroutput>--medium</computeroutput> argument ou
1774 à partir de précédents rattachements de médias</para>
1775 </glossdef>
1776 </glossentry>
1777
1778 <glossentry>
1779 <glossterm>medium</glossterm>
1780
1781 <glossdef>
1782 <para>Spécifie ce qu'il faut attacher. Les valeurs suivantes sont
1783 supportées&#xA0;:<itemizedlist>
1784 <listitem>
1785 <para>"none"&#xA0;: Tout périphérique existant serait supprimé du
1786 slot donné.</para>
1787 </listitem>
1788
1789 <listitem>
1790 <para>"emptydrive"&#xA0;: Pour un lecteur amovible ou de DVD
1791 virtuel, cela fait se comporter le périphérique comme un lecteur
1792 amovible dans lequel on n'a inséré aucun média.</para>
1793 </listitem>
1794
1795 <listitem>
1796 <para>"additions"&#xA0;: Seulement pour un lecteur DVD virtuel,
1797 ceci connecte l'image des <emphasis>Suppléments invité de
1798 VirtualBox</emphasis> au slot de périphérique donné.</para>
1799 </listitem>
1800
1801 <listitem>
1802 <para>Si vous spécifiez un UUID, il doit s'agir de l'UUID d'un
1803 média de stockage déjà connu de VirtualBox (par exemple car il
1804 a été attaché à une autre machine virtuelle). Voir
1805 <xref linkend="vboxmanage-list" /> pour la façon de lister
1806 les médias connus. Ce média est alors attaché au slot du
1807 périphérique donné.</para>
1808 </listitem>
1809
1810 <listitem>
1811 <para>Si vous spécifiez un nom de fichier, il doit s'agir du
1812 chemin complet vers une image de disque existante (ISO, RAW, VDI, VMDK
1813 ou autre), qui est donc attaché au slot du périphérique donné.</para>
1814 </listitem>
1815
1816 <listitem>
1817 <para>"host:&lt;lecteur&gt;": Pour un lecteur amovible ou de DVD
1818 virtuel seulement, ceci connecte le slot du périphérique donné
1819 au lecteur amovible ou de DVD spécifié sur l'ordinateur hôte.</para>
1820 </listitem>
1821
1822 <listitem>
1823 <para>"iscsi"&#xA0;: Pour les disques durs virtuels seulement,
1824 cela permet de spécifier une cible iSCSI. Dans ce cas, vous
1825 devez donner davantage de paramètres&#xA0;; voir ci-dessous.</para>
1826 </listitem>
1827 </itemizedlist></para>
1828
1829 <para>Certaines modifications ci-dessus, en particulier concernant
1830 les médias amovibles (disquettes ou CDs/DVDs), peuvent prendre effet
1831 pendant que la VM est en fonction. Les autres (changement de périphérique
1832 ou dans les slots des disques durs) exigent que la VM soit éteinte.</para>
1833 </glossdef>
1834 </glossentry>
1835
1836 <glossentry>
1837 <glossterm>mtype</glossterm>
1838
1839 <glossdef>
1840 <para>Définit la façon dont ce média se comporte vis-à-vis des
1841 instantanés et des opérations d'écriture. Voir <xref linkend="hdimagewrites" />
1842 pour des détails.</para>
1843 </glossdef>
1844 </glossentry>
1845
1846 <glossentry>
1847 <glossterm>comment</glossterm>
1848
1849 <glossdef>
1850 <para>Une description que vous souhaitez stocker avec ce média (facultative&#xA0;;
1851 par exemple pour une cible iSCSI, "Gros serveur de stockage de l'étage
1852 inférieur"). C'est purement descriptif et facultatif pour que le
1853 média fonctionne correctement.</para>
1854 </glossdef>
1855 </glossentry>
1856
1857 <glossentry>
1858 <glossterm>setuuid, setparentuuid</glossterm>
1859
1860 <glossdef>
1861 <para>Modifie l'UUID ou l'UUID parent d'un média avant de l'attacher
1862 à une VM. C'est une option pour experts. Une utilisation impropre
1863 peut rendre le média inutilisable ou donner des configurations de VM
1864 cassées si une autre VM se réfère déjà au même média. La variante
1865 la plus fréquemment utilisée est <code>--setuuid ""</code>, qui
1866 affecte un nouvel UUID (aléatoire) à une image. Cela sert à résoudre
1867 des erreurs d'UUID dupliqués si on a dupliqué une image par les
1868 outils de copie de fichiers..</para>
1869 </glossdef>
1870 </glossentry>
1871
1872 <glossentry>
1873 <glossterm>passthrough</glossterm>
1874
1875 <glossdef>
1876 <para>Seulement pour un lecteur DVD virtuel, vous pouvez activer
1877 le support de gravure sur DVD (actuellement expérimental&#xA0;; voir
1878 <xref linkend="storage-cds" />).</para>
1879 </glossdef>
1880 </glossentry>
1881
1882 <glossentry>
1883 <glossterm>tempeject</glossterm>
1884
1885 <glossdef>
1886 <para>Seulement pour un lecteur DVD virtuel, vous pouvez configurer
1887 le comportement pour avoir l'éjection du média synchrnmiùe avec l'invité.
1888 Si vous l'activez, l'éjection n'a qu'un effet temporaire. Si vous
1889 éteignez puis redémarrez la VM, le média configuré au départ sera
1890 toujours dans le lecteur.</para>
1891 </glossdef>
1892 </glossentry>
1893
1894 <glossentry>
1895 <glossterm>nonrotational</glossterm>
1896
1897 <glossdef>
1898 <para>Ce paramètre permet d'activer le drapeau non-rotational pour
1899 les disques durs virtuels. Certains invités (comme Windows 7+) gèrent
1900 de tels disques comme des SSDs et ne fragmentent pas de tels médias.</para>
1901 </glossdef>
1902 </glossentry>
1903
1904 <glossentry>
1905 <glossterm>bandwidthgroup</glossterm>
1906
1907 <glossdef>
1908 <para>Définit le groupe de bande passante à utiliser pour le
1909 périphérique donné&#xA0;; voir <xref linkend="storage-bandwidth-limit" />.</para>
1910 </glossdef>
1911 </glossentry>
1912
1913 <glossentry>
1914 <glossterm>forceunmount</glossterm>
1915
1916 <glossdef>
1917 <para>Seulement pour un lecteur DVD ou amovible virtuel, cela démonte
1918 de force le DVD/CD/disquette ou monte un nouveau DVD/CD/disquette
1919 même si celui précédent est verrouillé en lecture par l'invité.
1920 De nouveau, voir <xref linkend="storage-cds" /> pour des détails.</para>
1921 </glossdef>
1922 </glossentry>
1923 </glosslist></para>
1924
1925 <para>Quand on utilise "iscsi" avec le paramètre
1926 <computeroutput>--medium</computeroutput> pour le support iSCSI --
1927 see <xref linkend="storage-iscsi" /> --, vous pouvez ou devez utiliser
1928 des paramètres supplémentaires&#xA0;:<glosslist>
1929 <glossentry>
1930 <glossterm>server</glossterm>
1931
1932 <glossdef>
1933 <para>Le nom de l'hôte ou l'adresse IP de la cible iSCSI&#xA0;;
1934 requis.</para>
1935 </glossdef>
1936 </glossentry>
1937
1938 <glossentry>
1939 <glossterm>target</glossterm>
1940
1941 <glossdef>
1942 <para>La chaîne du nom de la cible. Il est déterminé par la cible iSCSI
1943 et il est utilisé pour identifier la ressource de stockage&#xA0;;
1944 requis.</para>
1945 </glossdef>
1946 </glossentry>
1947
1948 <glossentry>
1949 <glossterm>tport</glossterm>
1950
1951 <glossdef>
1952 <para>Numéro de port TCP/IP du service iSCSI sur la cible (facultatif).</para>
1953 </glossdef>
1954 </glossentry>
1955
1956 <glossentry>
1957 <glossterm>lun</glossterm>
1958
1959 <glossdef>
1960 <para>Numéro d'unité logique de la ressource cible (facultatif).
1961 Souvent, cette valeur vaut zéro.</para>
1962 </glossdef>
1963 </glossentry>
1964
1965 <glossentry>
1966 <glossterm>username, password</glossterm>
1967
1968 <glossdef>
1969 <para>Nom d'utilisateur et mot de passe (initiator secret) pour
1970 l'authentification sur la cible si nécessaire (facultatif).<note>
1971 <para>Le nom d'utilisateur et le mot de passe sont stockés sans
1972 chiffrement (donc en clair) dans le fichier XML de configuration
1973 de la VM si vous ne fournissez aucun paramètre de mot de passe.
1974 Quand vous spécifiez pour la première fois un paramètre de mot de passe,
1975 le mot de passe est stocké et chiffré.</para>
1976 </note></para>
1977 </glossdef>
1978 </glossentry>
1979
1980 <glossentry>
1981 <glossterm>intnet</glossterm>
1982
1983 <glossdef>
1984 <para>Si vous le spécifiez, connecte à la cible iSCSI via le réseau
1985 interne. Cela nécessite une configuration supplémentaire décrite au
1986 <xref linkend="iscsi-intnet" />.</para>
1987 </glossdef>
1988 </glossentry>
1989 </glosslist></para>
1990 </sect1>
1991
1992 <sect1 id="vboxmanage-storagectl">
1993 <title>VBoxManage storagectl</title>
1994
1995 <para>Cette commande attache/modifie/supprime un contrôleur de stockage.
1996 Après elle, on peut attacher des médias virtuels au contrôleur avec la
1997 commande <computeroutput>storageattach</computeroutput> (voir la prochaine
1998 section).</para>
1999
2000 <para>La syntaxe est comme suit&#xA0;:</para>
2001
2002 <screen>VBoxManage storagectl &lt;uuid|nomvm&gt;
2003 --name &lt;nom&gt;
2004 [--add &lt;ide/sata/scsi/floppy&gt;]
2005 [--controller &lt;LsiLogic|LSILogicSAS|BusLogic|
2006 IntelAhci|PIIX3|PIIX4|ICH6|I82078&gt;]
2007 [--sataportcount &lt;1-30&gt;]
2008 [--hostiocache on|off]
2009 [--bootable on|off]
2010 [--remove]</screen>
2011
2012 <para>où les paramètres signifient&#xA0;: <glosslist>
2013 <glossentry>
2014 <glossterm>uuid|nomvm</glossterm>
2015
2016 <glossdef>
2017 <para>Nom ou UUID de la VM. Obligatoire.</para>
2018 </glossdef>
2019 </glossentry>
2020
2021 <glossentry>
2022 <glossterm>nom</glossterm>
2023
2024 <glossdef>
2025 <para>Nom du contrôleur de stockage. Obligatoire.</para>
2026 </glossdef>
2027 </glossentry>
2028
2029 <glossentry>
2030 <glossterm>add</glossterm>
2031
2032 <glossdef>
2033 <para>Définit le type de bus système auquel doit être connecté le
2034 contrôleur de stockage.</para>
2035 </glossdef>
2036 </glossentry>
2037
2038 <glossentry>
2039 <glossterm>controller</glossterm>
2040
2041 <glossdef>
2042 <para>Permet de choisir le type de chipset à émuler pour le
2043 contrôleur de stockage donné.</para>
2044 </glossdef>
2045 </glossentry>
2046
2047 <glossentry>
2048 <glossterm>sataportcount</glossterm>
2049
2050 <glossdef>
2051 <para>Ceci détermine le nombre de ports que le contrôleur SATA
2052 devrait supporter.</para>
2053 </glossdef>
2054 </glossentry>
2055
2056 <glossentry>
2057 <glossterm>hostiocache</glossterm>
2058
2059 <glossdef>
2060 <para>Configure l'utilisation du cache E/S de l'hîte pour toutes les
2061 images de disque attachées à ce contrôleur de stockage. Pour des détails,
2062 merci de voir <xref
2063 linkend="iocaching" />.</para>
2064 </glossdef>
2065 </glossentry>
2066
2067 <glossentry>
2068 <glossterm>bootable</glossterm>
2069
2070 <glossdef>
2071 <para>Sélectionne si ce contrôleur est amorçable.</para>
2072 </glossdef>
2073 </glossentry>
2074
2075 <glossentry>
2076 <glossterm>remove</glossterm>
2077
2078 <glossdef>
2079 <para>Supprime le contrôleur de stockage de la config de la VM.</para>
2080 </glossdef>
2081 </glossentry>
2082 </glosslist></para>
2083 </sect1>
2084
2085 <sect1>
2086 <title>VBoxManage bandwidthctl</title>
2087
2088 <para>Cette commande crée/efface/modifie/affiche les groupes de bande
2089 passante de la machine virtuelle donnée&#xA0;:<screen>VBoxManage bandwidthctl &lt;uuid|nomvm&gt;
2090 add &lt;nom&gt; --type disk|network --limit &lt;megabytes per second&gt;[k|m|g|K|M|G] |
2091 set &lt;nom&gt; --limit &lt;megabytes per second&gt;[k|m|g|K|M|G] |
2092 remove &lt;nom&gt; |
2093 list [--machinereadable]</screen></para>
2094
2095 <para>Les sous-commandes suivantes sont disponibles&#xA0;:<itemizedlist>
2096 <listitem>
2097 <para><computeroutput>add</computeroutput>, crée un nouveau groupe de
2098 dande passante d'un type doné.</para>
2099 </listitem>
2100 <listitem>
2101 <para><computeroutput>set</computeroutput>, modifie la limite d'un groupe
2102 de bande passante existante.</para>
2103 </listitem>
2104 <listitem>
2105 <para><computeroutput>remove</computeroutput>, détruit un groupe de
2106 bande passante.</para>
2107 </listitem>
2108 <listitem>
2109 <para><computeroutput>list</computeroutput>, affiche tous les groupes
2110 de bande passante définis pour la VM donnée.</para>
2111 </listitem>
2112 </itemizedlist>
2113 </para>
2114 <para>Les paramètres signifient&#xA0;:<glosslist>
2115 <glossentry>
2116 <glossterm>uuid|nomvm</glossterm>
2117
2118 <glossdef>
2119 <para>Le nom ou l'UUID de la VM. Obligatoire.</para>
2120 </glossdef>
2121 </glossentry>
2122
2123 <glossentry>
2124 <glossterm>nom</glossterm>
2125
2126 <glossdef>
2127 <para>Nom du groupe de bande passante. Obligatoire.</para>
2128 </glossdef>
2129 </glossentry>
2130
2131 <glossentry>
2132 <glossterm>type</glossterm>
2133
2134 <glossdef>
2135 <para>Type de groupe de bande passante. Obligatoire. Deux types sont
2136 supportés&#xA0;: <computeroutput>disk</computeroutput> et
2137 <computeroutput>network</computeroutput>. Voir
2138 <xref linkend="storage-bandwidth-limit" /> ou
2139 <xref linkend="network_bandwidth_limit" /> pour une description d'un
2140 type particulier.</para>
2141 </glossdef>
2142 </glossentry>
2143
2144 <glossentry>
2145 <glossterm>limit</glossterm>
2146
2147 <glossdef>
2148 <para>Spécifie la limite du groupe donné. On peut le modifier pendant
2149 que la VM est en fonction. L'unité par défaut est en mégaoctet par
2150 seconde. Vous pouvez modifier l'unité en spécifiant un des
2151 suffixes suivants&#xA0;: <computeroutput>k</computeroutput> pour
2152 kilobits/s, <computeroutput>m</computeroutput> pour mégabits/s,
2153 <computeroutput>g</computeroutput> pour gigabits/s,
2154 <computeroutput>K</computeroutput> pour kilo octets/s,
2155 <computeroutput>M</computeroutput> pour méga octets/s,
2156 <computeroutput>G</computeroutput> pour giga octets/s.</para>
2157 </glossdef>
2158 </glossentry>
2159 </glosslist>
2160 <note>
2161 <para>Les limites de bande passante du réseau ne s'appliquent qu'au
2162 trafic émis par les machines virtuelles. Le trafic reçu par les VMs est
2163 illimité.</para>
2164 </note>
2165 <note>
2166 <para>Pour supprimer un groupe de bande passante, il ne doit être référencé
2167 sur aucun disque ou adaptateur d'une VM en fonction.</para>
2168 </note>
2169 </para>
2170 </sect1>
2171
2172 <sect1>
2173 <title>VBoxManage showhdinfo</title>
2174
2175 <para>Cette commande affiche des informations sur une image de disque
2176 virtuelle, en particulier sa taille sur le disque, son type et les machines
2177 virtuelles qui l'utilisent.<note>
2178 <para>Pour être compatible avec des versions plus anciennes de VirtualBox
2179 la commande "showvdiinfo" est également supportée et associée en
2180 interne à la commande "showhdinfo".</para>
2181 </note></para>
2182 <para>L'image de disque doit être spécifiée soit par son UUID (si le média
2183 est enregistré), soit par le nom du fichier. Les images enregistrées peuvent
2184 être listées par
2185 <computeroutput>VBoxManage list hdds</computeroutput> (voir <xref linkend="vboxmanage-list" />
2186 pour plus d'informations). Un nom de fichier doit être spécifié en tant
2187 que chemin valide, soit absolu soit relatif en partant du répertoire
2188 actuel.</para>
2189 </sect1>
2190
2191 <sect1 id="vboxmanage-createvdi">
2192 <title>VBoxManage createhd</title>
2193
2194 <para>Cette commande crée une nouvelle de disque dur virtuel. La
2195 syntaxe est comme suit&#xA0;:</para>
2196
2197 <screen>VBoxManage createhd --filename &lt;nomfichier&gt;
2198 --size &lt;mégaoctets&gt;
2199 [--format VDI|VMDK|VHD] (par défaut : VDI)
2200 [--variant Standard,Fixed,Split2G,Stream,ESX]</screen>
2201
2202 <para>où les paramètres signifient&#xA0;:<glosslist>
2203 <glossentry>
2204 <glossterm><computeroutput>nomfichier</computeroutput></glossterm>
2205
2206 <glossdef>
2207 <para>Permet de choisir un nom de fichier. Obligatoire.</para>
2208 </glossdef>
2209 </glossentry>
2210
2211 <glossentry>
2212 <glossterm><computeroutput>mégaoctets</computeroutput></glossterm>
2213
2214 <glossdef>
2215 <para>Permet de définir la capacité de l'image, en MiO.
2216 Obligatoire.</para>
2217 </glossdef>
2218 </glossentry>
2219
2220 <glossentry>
2221 <glossterm><computeroutput>format</computeroutput></glossterm>
2222
2223 <glossdef>
2224 <para>Permet de choisir un format de fichier pour le fichier
2225 de sortie, différent du format du fichier d'entrée.</para>
2226 </glossdef>
2227 </glossentry>
2228
2229 <glossentry>
2230 <glossterm><computeroutput>variant</computeroutput></glossterm>
2231
2232 <glossdef>
2233 <para>Permet de choisir une variante du format de fichier pour le
2234 fichier de sortie. C'est une liste de drapeaux séparée par des virgules.
2235 Toutes les combinaisons ne sont pas supportées, spécifier des
2236 drapeaux incohérents donne un message d'erreur.</para>
2237 </glossdef>
2238 </glossentry>
2239 </glosslist> <note>
2240 <para>Pour être compatible avec d'anciennes versions de VirtualBox, la
2241 commande "createvdi" est également supportée et associée en interne avec
2242 la commande "createhd".</para>
2243 </note></para>
2244 </sect1>
2245
2246 <sect1 id="vboxmanage-modifyvdi">
2247 <title>VBoxManage modifyhd</title>
2248
2249 <para>Avec la commande <computeroutput>modifyhd</computeroutput>, vous pouvez
2250 modifier les caractéristiques d'une image de disque après l'avoir
2251 créé&#xA0;:<screen>VBoxManage modifyhd &lt;uuid&gt;|&lt;nomfichier&gt;
2252 [--type normal|writethrough|immutable|shareable|
2253 readonly|multiattach]
2254 [--autoreset on|off]
2255 [--compact]
2256 [--resize &lt;megabytes&gt;|--resizebyte &lt;octets&gt;]</screen><note>
2257 <para>Malgré le "hd" du nom de la sous-commande, la commande fonctionne
2258 avec toutes les images de disque et pas seulement les disques durs. Pour
2259 être compatible avec les anciennes versions de VirtualBox, la commande
2260 "modifyvdi" est également supportée et a été associée en interne à la
2261 commande"modifyhd".</para>
2262 </note></para>
2263
2264 <para>L'image de disque doit être spécifiée soit par son UUID (si le média
2265 est enregistré), soit par le nom du fichier. Les images enregistrées peuvent
2266 être listées par
2267 <computeroutput>VBoxManage list hdds</computeroutput> (voir <xref linkend="vboxmanage-list" />
2268 pour plus d'informations). Un nom de fichier doit être spécifié en tant
2269 que chemin valide, soit absolu soit relatif en partant du répertoire
2270 actuel.</para>
2271 <para>Les options suivantes sont disponibles&#xA0;:<itemizedlist>
2272 <listitem>
2273 <para>Avec l'argument <computeroutput>--type</computeroutput>, vous
2274 pouvez modifier le type d'une image existante entre le mode normal,
2275 immuable, write-through et autres modes&#xA0;; voir <xref
2276 linkend="hdimagewrites" /> pour des détails.</para>
2277 </listitem>
2278
2279 <listitem>
2280 <para>Pour les disques durs immuables seulement (de différenciation),
2281 l'option <computeroutput>--autoreset on|off</computeroutput> détermine
2282 si le disque est automatiquement réinitialisé à chaque démarrage de
2283 la VM (de nouveau, voir <xref linkend="hdimagewrites" />). Par défaut,
2284 c'est actif.</para>
2285 </listitem>
2286
2287 <listitem>
2288 <para>L'option <computeroutput>--compact</computeroutput>,
2289 peut être utilisée pour compresser des images de disque (à savoir
2290 supprimer des blocs qui ne contiennent que des zéros). Cela réallègera
2291 une image à taille dynamique&#xA0;; cela réduira la taille
2292 <emphasis>physique</emphasis> de l'image sans changer la taille logique
2293 du disque virtuel. La compression fonctionne aussi bien pour les images
2294 de base que celles de différenciation créées dans un instantané.</para>
2295
2296 <para>Pour que l'opération soit efficace, il faut d'abord libérer de
2297 l'espace dans le système invité en y mettant des zéros via le logiciel
2298 adapté. Pour les invités Windows, vous pouvez utiliser l'outil
2299 <computeroutput>sdelete</computeroutput> de Microsoft.
2300 Exécutez <computeroutput>sdelete -z</computeroutput> dans l'invité pour
2301 mettre des zéros dans l'espace libre avant de compresser l'image de
2302 disque virtuel. Pour Linux, utilisez l'outil
2303 <code>zerofree</code> qui supporte les systèmes de fichiers s ext2/ext3.
2304 Pour les invités Mac OS X, utilisez utilisez la fonction <emphasis>Supprimer l'espace libre</emphasis> de
2305 <emphasis>l'outil de disque</emphasis> intégré. Utilisez-y
2306 <emphasis>Zero Out Data</emphasis>.</para>
2307
2308 <para>Remarquez que la compression n'est actuellement disponible que
2309 pour les images VDI. Vous pouvez obtenir la même chose en mettant des
2310 zéros sur les blocs libres et clonant le disque vers un autre format
2311 dynamique. Vous pouvez utiliser ce contournement jusqu'à ce que la
2312 compression soit supportée pour les autres formats de disque que VDI.</para>
2313 </listitem>
2314
2315 <listitem>
2316 <para>L'option <computeroutput>--resize x</computeroutput> (où x est
2317 le nouvel espace total désiré en <emphasis role="bold">mégaoctets</emphasis>)
2318 vous permet de modifier la capacité d'une image existante&#xA0;; ceci
2319 ajuste la taille <emphasis>logique</emphasis> d'un disque virtuel sans
2320 beaucoup changer la taille physiqu.<footnote>
2321 <para>Le redimensionnement d'images a été ajouté à VirtualBox 4.0.</para>
2322 </footnote> Cela ne fonctionne actuellement que pour les formats
2323 VDI et VHD et pour les variantse, à taille dynamique, et vous ne
2324 pouvez l'utiliser que pour augmenter (ou réviser) la capacité.
2325 Par exemple, si vous avez créé au départ un disque de 10G à présent
2326 plein, vous pouvez utiliser la commande <computeroutput>--resize 15360</computeroutput>
2327 pour passer la capacité à 15G (15,360Mo) sans devoir créer une nouvelle
2328 image et y copier toutes les données à partir d'un e machine virtuelle.
2329 Cependant, remarquez que cela ne change que la capacité du lecteur&#xA0;;
2330 vous devrez ensuite, en général, utiliser un outil de gestion des
2331 partitions dans l'invité pour ajuster la partition principale et
2332 remplir le lecteur.</para><para>L'option <computeroutput>--resizebyte x</computeroutput>
2333 fait presque la même chose mait x est exprimé en octets au lieu de
2334 mégaoctets.</para>
2335 </listitem>
2336 </itemizedlist></para>
2337 </sect1>
2338
2339 <sect1 id="vboxmanage-clonevdi">
2340 <title>VBoxManage clonehd</title>
2341
2342 <para>Cette commande duplique une image de disque dur virtuel enregistrée
2343 vers un nouveau fichier image ayant un nouvel identifiant unique (UUID). La
2344 nouvelle image peut être transférée vers un autre système hôte ou réimportée
2345 dans VirtualBox en utilisant le gestionnaire de médias virtuels&#xA0;; voir
2346 <xref linkend="vdis" /> et <xref linkend="cloningvdis" />. La syntaxe est
2347 comme suit&#xA0;:</para>
2348
2349 <screen>VBoxManage clonehd &lt;uuid&gt;|&lt;nomfichier&gt; &lt;outputfile&gt;
2350 [--format VDI|VMDK|VHD|RAW|&lt;other&gt;]
2351 [--variant Standard,Fixed,Split2G,Stream,ESX]
2352 [--existing]</screen>
2353
2354 <para>L'image de disque à cloner et celle cible doivent être spécifiées
2355 soit par leur UUID (si le média
2356 est enregistré), soit par leur nom du fichier. Les images enregistrées peuvent
2357 être listées par
2358 <computeroutput>VBoxManage list hdds</computeroutput> (voir <xref linkend="vboxmanage-list" />
2359 pour plus d'informations). Un nom de fichier doit être spécifié en tant
2360 que chemin valide, soit absolu soit relatif en partant du répertoire
2361 actuel.</para>
2362 <para>Les options suivantes sont disponibles&#xA0;:<glosslist>
2363 <glossentry>
2364 <glossterm><computeroutput>--format</computeroutput></glossterm>
2365
2366 <glossdef>
2367 <para>Permet de choisir un format de fichier pour le fichier de
2368 sortie, autre que celui du fichier d'entrée.</para>
2369 </glossdef>
2370 </glossentry>
2371
2372 <glossentry>
2373 <glossterm><computeroutput>--variant</computeroutput></glossterm>
2374
2375 <glossdef>
2376 <para>Permet de choisir une variante de format de fichier pour le
2377 fichier de sortie. C'est une liste de drapeaux séparée par des virgules.
2378 Toutes les combinaisons ne sont pas supportées, spécifier des
2379 drapeaux incohérents donne un message d'erreur.</para>
2380 </glossdef>
2381 </glossentry>
2382
2383 <glossentry>
2384 <glossterm><computeroutput>--existing</computeroutput></glossterm>
2385
2386 <glossdef>
2387 <para>Effectue le clonage sur un média de destination existant. Seule
2388 la partie du média source convenant au média de destination est copiée.
2389 Cela signifie que si le média de destination est plus petit que
2390 la source, seule une partie en est copiée, et si le média de
2391 destination est plus gros que la source, le reste de l'espace du
2392 média de destination reste inchangé.</para>
2393 </glossdef>
2394 </glossentry>
2395 </glosslist> <note>
2396 <para>Pour être compatible avec les anciennes versions de VirtualBox,
2397 la commande "clonevdi" est également supportée et elle a été associée
2398 en interne à la commande "clonehd".</para>
2399 </note></para>
2400 </sect1>
2401
2402 <sect1>
2403 <title>VBoxManage convertfromraw</title>
2404
2405 <para>Cette commande convertit une image de disque brute en fichier VirtualBox Disk Image
2406 (VDI). La syntaxe est la suivante&#xA0;:</para>
2407
2408 <screen>VBoxManage convertfromraw &lt;filename&gt; &lt;outputfile&gt;
2409 [--format VDI|VMDK|VHD]
2410 [--variant Standard,Fixed,Split2G,Stream,ESX]
2411 [--uuid &lt;uuid&gt;]
2412VBoxManage convertfromraw stdin &lt;fichiersortie&gt; &lt;octets&gt;
2413 [--format VDI|VMDK|VHD]
2414 [--variant Standard,Fixed,Split2G,Stream,ESX]
2415 [--uuid &lt;uuid&gt;]</screen>
2416
2417 <para>où les paramètres signifient&#xA0;:<glosslist>
2418 <glossentry>
2419 <glossterm><computeroutput>--bytes</computeroutput></glossterm>
2420
2421 <glossdef>
2422 <para>La taille du fichier image, en octets, fournie en entrée.</para>
2423 </glossdef>
2424 </glossentry>
2425
2426 <glossentry>
2427 <glossterm><computeroutput>--format</computeroutput></glossterm>
2428
2429 <glossdef>
2430 <para>Sélectionnez le format de l'image de disque à créer. Par
2431 défaut, c'est VDI.</para>
2432 </glossdef>
2433 </glossentry>
2434
2435 <glossentry>
2436 <glossterm><computeroutput>--variant</computeroutput></glossterm>
2437
2438 <glossdef>
2439 <para>Permet de choisir une variante de format de fichier pour le
2440 fichier en sortie. C'est une liste de drapeaux séparée par des
2441 virgules. Toutes les combinaisons ne sont pas supportées, spécifier
2442 des drapeaux incohérents donne un message d'erreur.</para>
2443 </glossdef>
2444 </glossentry>
2445
2446 <glossentry>
2447 <glossterm><computeroutput>--uuid</computeroutput></glossterm>
2448
2449 <glossdef>
2450 <para>Permet de spécifier l'UUID ou le fichier de sortie.</para>
2451 </glossdef>
2452 </glossentry>
2453 </glosslist> La deuxième forme oblige VBoxManage à lire le contenu de
2454 l'image de disque à partir de l'entrée standard (utile pour utiliser
2455 cette commande en ligne).</para>
2456
2457 <para><note>
2458 <para>Pour être compatible avec d'anciennes versions de VirtualBox,
2459 la commande "convertdd" est aussi supportée et elle est associée en interne
2460 à la commande "convertfromraw".</para>
2461 </note></para>
2462 </sect1>
2463
2464 <sect1>
2465 <title>VBoxManage getextradata/setextradata</title>
2466
2467 <para>Ces commandes vous permet d'attacher et de récupérer des chaînes de
2468 données dans une machine virtuelle ou à une configuration de VirtualBox (en
2469 spécifiant <computeroutput>global</computeroutput> au lieu d'un nom de machine
2470 virtuelle). Vous pouvez spécifier une clé (comme chaîne de texte) pour
2471 associer les données que vous pourrez récupérer plus tard. Par exemple&#xA0;:</para>
2472
2473 <screen>VBoxManage setextradata Fedora5 installdate 2006.01.01
2474VBoxManage setextradata SUSE10 installdate 2006.02.02</screen>
2475
2476 <para>associerait la chaîne "2006.01.01" à la clé installdate pour la
2477 the machine virtuelle Fedora5, et "2006.02.02" pour la machine SUSE10. Vous
2478 pourriez récupçrer l'information comme suit&#xA0;:</para>
2479
2480 <screen>VBoxManage getextradata Fedora5 installdate</screen>
2481
2482 <para>qui renverrait</para>
2483
2484 <screen>VirtualBox Command Line Management Interface Version $VBOX_VERSION_MAJOR.$VBOX_VERSION_MINOR.$VBOX_VERSION_BUILD
2485(C) 2005-$VBOX_C_YEAR $VBOX_VENDOR
2486All rights reserved.
2487
2488Value: 2006.01.01</screen>
2489 <para>To remove a key, the <computeroutput>setextradata</computeroutput>
2490 command must be run without specifying data (only the key), for example:
2491 </para>
2492
2493 <screen>VBoxManage setextradata Fedora5 installdate</screen>
2494
2495 </sect1>
2496
2497 <sect1 id="vboxmanage-setproperty">
2498 <title>VBoxManage setproperty</title>
2499
2500 <para>Cette commande est utilisée pour modifier des paramètres globaux
2501 qui modifient toute l'installation de VirtualBox. Certains d'entr eux
2502 correspondent aux paramètres de la boîte de dialogue "Paramètres globaux" de
2503 l'interface graphique. Les propriétés suivantes sont disponibles&#xA0;:<glosslist>
2504 <glossentry>
2505 <glossterm><computeroutput>machinefolder</computeroutput></glossterm>
2506
2507 <glossdef>
2508 <para>Ceci spécifie le dossier par défaut dans lequel sont
2509 stockées les définitions de la machine virtuelle&#xA0;; voir <xref linkend="vboxconfigdata" /> pour les détails.</para>
2510 </glossdef>
2511 </glossentry>
2512
2513 <glossentry>
2514 <glossterm><computeroutput>hwvirtexclusive</computeroutput></glossterm>
2515 <para>Ceci spécife si VirtualBox utilisera en exclusivité les
2516 extensions de virtualisation matérielle (Intel VT-x ou AMD-V) du
2517 processeur du système hôte ; voir <xref linkend="hwvirt" />. Si
2518 vous souhaitez partager ces extensions avec d'autres hyperviseurs en
2519 fonction en même temps, vous devez désactiver ce paramètre.
2520 Cela a des implications négatives en termes de performance.
2521 </para>
2522 </glossentry>
2523
2524
2525 <glossentry>
2526 <glossterm><computeroutput>vrdeauthlibrary</computeroutput></glossterm>
2527
2528 <glossdef>
2529 <para>Ceci indique la bibliothèque à utiliser quand on a sélectionné
2530 l'authentification "externe" pour une machine virtuelle en particulier&#xA0;;
2531 voir <xref linkend="vbox-auth" /> pour des détails.</para>
2532 </glossdef>
2533 </glossentry>
2534
2535 <glossentry>
2536 <glossterm><computeroutput>websrvauthlibrary</computeroutput></glossterm>
2537
2538 <glossdef>
2539 <para>Ceci spécifie la bibliothèque utilisée par le service web
2540 pour authentifier les utilisateurs. Pour des détails sur le service
2541 web de VirtualBox, merci de vous reporter au manuel de référence SDK
2542 distinct de VirtualBox (voir <xref
2543 linkend="VirtualBoxAPI" />).</para>
2544 </glossdef>
2545 </glossentry>
2546
2547 <glossentry>
2548 <glossterm><computeroutput>vrdeextpack</computeroutput></glossterm>
2549 <glossdef>
2550 <para>Ceci spécifie la bibliothèque qui implémente l'extension Bureau
2551 distant de VirtualBox.</para>
2552 </glossdef>
2553 </glossentry>
2554
2555 <glossentry>
2556 <glossterm><computeroutput>loghistorycount</computeroutput></glossterm>
2557
2558 <glossdef>
2559 <para>Ceci sélectionne le nombre de journaux de VMs (anciens)
2560 conservés.</para>
2561 </glossdef>
2562 </glossentry>
2563
2564 <glossentry>
2565 <glossterm><computeroutput>autostartdbpath</computeroutput></glossterm>
2566
2567 <glossdef>
2568 <para>Ceci sélectionne le chemin vers la base de données autostart.
2569 Voir <xref linkend="autostart" />.</para>
2570 </glossdef>
2571 </glossentry>
2572
2573 <glossentry>
2574 <glossterm><computeroutput>defaultfrontend</computeroutput></glossterm>
2575
2576 <glossdef>
2577 <para>Ceci sélectionne l'interface globale des VMs. Voir
2578 <xref linkend="vboxmanage-startvm" />.</para>
2579 </glossdef>
2580 </glossentry>
2581 </glosslist></para>
2582 </sect1>
2583
2584 <sect1>
2585 <title>VBoxManage usbfilter add/modify/remove</title>
2586
2587 <para>Les commandes <computeroutput>usbfilter</computeroutput> sont utilisées
2588 pour travailler avec des filtres USB dans des machines virtuelles ou avec
2589 des filtres globaux qui concernent tout le paramétrage de VirtualBox. Les
2590 filtres globaux sont appliqués avant les filtres spécifiques aux machines et
2591 ils peuvent être utilisés pour empêcher les périphériques d'être capturés par
2592 une machine virtuelle. Les filtres globaux s'appliquent toujours dans un
2593 ordre particulier, et seul le premier filtre convenant à un périphérique est
2594 appliqué. Par exemple, si le premier filtre global dit de garder (rendre
2595 disponible) une carte mémoire Kingston particulière et le deuxième d'ignorer
2596 tous les périphériques Kingston, cette carte mémoire sera disponible pour
2597 toutes les machines ayant un filtre adéquat mais pas les autres périphériques
2598 Kingston.</para>
2599
2600 <para>Lors de la création d'un filtre USB en utilisant
2601 <computeroutput>usbfilter add</computeroutput>, vous devez fournir trois ou
2602 quatre paramètres obligatoires. L'index spécifie la position du filtre dans
2603 la liste. S'il y a déjà un filtre à cette place, lui-mâme et les suivants
2604 seront déplacés. Sinon, le nouveau filtre sera ajouté à la fin de laliste.
2605 Le paramètre <computeroutput>target</computeroutput> sélectionne la
2606 machine virtuelle à laquelle devrait être attaché le
2607 filtre, sinon utilisez "global" pour l'appliquer à toutes les machines virtuelles.
2608 <computeroutput>name</computeroutput> est le nom du nouveau filtre et
2609 des filtres globaux, <computeroutput>action</computeroutput> autorise les
2610 machines à accéder aux périphériques correspondant à la description du
2611 filtre ("hold") ou ne leur donne pas accès ("ignore"). En outre, vous devriez
2612 spécifier des paramètres de filtrage. Vous pouvez trouver les paramètres des
2613 périphériques attachés à votre système en utilisant <computeroutput>VBoxManage list usbhost</computeroutput>.
2614 Enfin, vous pouvez spécifier si le filtre devrait être actif, et pour les
2615 filtres globaux, s'ils concernent les périphériques locaux, à distance (par
2616 connexion RDP) ou autrement.</para>
2617
2618 <para>Quand vous modifiez un filtre USB en utilisant
2619 <computeroutput>usbfilter modify</computeroutput>, vous devez spécifier le
2620 filtre par index (voir la sortie de
2621 <computeroutput>VBoxManage list usbfilters</computeroutput> pour voir les
2622 indexes des filtres globaux et <computeroutput>VBoxManage
2623 showvminfo</computeroutput> pour voir les indexes des machines individuelles),
2624 et par cible, laquelle est soit une machine virtuelle, soit "global". Les
2625 propriétés modifiables sont les mêmes que pour <computeroutput>usbfilter
2626 add</computeroutput>. Pour supprimer un filtre, utilisez <computeroutput>usbfilter
2627 remove</computeroutput> et spécifiez l'index et la cible.</para>
2628 </sect1>
2629
2630 <sect1 id="vboxmanage-sharedfolder">
2631 <title>VBoxManage sharedfolder add/remove</title>
2632
2633 <para>Cette commande vous permet de partager des dossiers de l'ordinateur hôte
2634 avec les systèmes d'exploitation invités. Pour cela, il faut que les systèmes
2635 invités aient une version installée des Suppléments invité qui supporte cette
2636 fonctionnaalité.</para>
2637
2638 <para>Les dossiers partagés sont décrits en détails au <xref
2639 linkend="sharedfolders" />.</para>
2640 </sect1>
2641
2642 <sect1 id="vboxmanage-guestproperty">
2643 <title>VBoxManage guestproperty</title>
2644
2645 <para>Les commandes "guestproperty" vous permettent de voir ou de définir
2646 les propriétés d'une machine virtuelle en fonction. Merci de voir <xref linkend="guestadd-guestprops" />
2647 pour une présentation. Comme il y est expliqué, les propriétés de l'invité
2648 sont des pairs de chaînes clé/valeur arbitraires qu'on peut changer et lire
2649 depuis l'hôte ou l'invité, donc on peut les utiliser comme des canaux de
2650 communication à faible volume pour des chaînes du moment qu'un invité est
2651 en fonction et a installé les suppléments invité. De plus, un certain nombre
2652 de valeurs dont les clés commencent par "/VirtualBox/" sont automatiquement
2653 définies et maintenues par les suppléments invité.</para>
2654
2655 <para>Les sous-commandes sont disponibles (où
2656 <computeroutput>&lt;vm&gt;</computeroutput>, dans chaque cas, peut être
2657 soit un nom soit un UUID d'une VM, comme pour les autres commandes de
2658 VBoxManage)&#xA0;:<itemizedlist>
2659 <listitem>
2660 <para><computeroutput>enumerate &lt;vm&gt; [--patterns
2661 &lt;pattern&gt;]</computeroutput>&#xA0;: Ceci liste toutes les
2662 propriétés invité disponibles pouq une VM donnée avec leur valeur.
2663 Cette liste sera très limitée si le processus service de l'invité
2664 ne peut pas être contacté, notamment car la VM n'est pa en fonction
2665 ou les suppléments invité ne sont pas installés.</para>
2666
2667 <para>Si vous spécifiez <computeroutput>--patterns
2668 &lt;échantillon&gt;</computeroutput>, il agit comme un filtre pour ne
2669 lister que les propriétés correspondant à l'échantillon donné. L'échantillon
2670 peut contenir les caractères jokers suivants&#xA0;:<itemizedlist>
2671 <listitem>
2672 <para><computeroutput>*</computeroutput> (astérisque)&#xA0;:
2673 représente n'importe quel nombre de caractères&#xA0;; par exemple,
2674 "<computeroutput>/VirtualBox*</computeroutput>" correspondrait
2675 à toutes les propriétés commençant par "/VirtualBox".</para>
2676 </listitem>
2677
2678 <listitem>
2679 <para><computeroutput>?</computeroutput> (point d'interrogation)&#xA0;:
2680 représente un seul caractère de votre choix&#xA0;; par exemple,
2681 "<computeroutput>fo?</computeroutput>" correspondrait à "foo"
2682 et à "for".</para>
2683 </listitem>
2684
2685 <listitem>
2686 <para><computeroutput>|</computeroutput> (symbole pipe)&#xA0;:
2687 peut être utilisé pour spécifier plusieurs échantillons alternatifs&#xA0;;
2688 par exemple, "<computeroutput>s*|t*</computeroutput>" correspondrait
2689 à tout ce qui commence par un "s" ou un "t".</para>
2690 </listitem>
2691 </itemizedlist></para>
2692 </listitem>
2693
2694 <listitem>
2695 <para><computeroutput>get &lt;vm&gt;</computeroutput>&#xA0;: Ceci ne
2696 récupère la valeur que d'une propriété. Si la propriété est introuvable
2697 (par exemple car l'invité n'est pas en fonction), ceci affichera
2698 <screen>No value set!</screen></para>
2699 </listitem>
2700
2701 <listitem>
2702 <para><computeroutput>set &lt;vm&gt; &lt;propriété&gt; [&lt;valeur&gt;
2703 [--flags &lt;drapeaux&gt;]]</computeroutput>&#xA0;: Ceci vous permet
2704 de définir une propriété invité en spécifiant la clé et la valeur.
2705 Si vous ne mettez pas <computeroutput>&lt;valeur&gt;</computeroutput>,
2706 la propriété est effacée. Avec <computeroutput>--flags</computeroutput>,
2707 vous pouvez éventuellement spécifier un comportement supplémentaire
2708 (vous pouvez en combiner plusieurs en les séparant par des virgules)&#xA0;:<itemizedlist>
2709 <listitem>
2710 <para><computeroutput>TRANSIENT</computeroutput>&#xA0;: la
2711 valeur ne sera pas stockée avec les données de la VM quand la
2712 VM exite&#xA0;;</para>
2713 </listitem>
2714
2715 <listitem>
2716 <para><computeroutput>TRANSRESET</computeroutput>&#xA0;: la valeur
2717 sera effacée dès que la VM redémarrera et/ou existera&#xA0;;</para>
2718 </listitem>
2719
2720 <listitem>
2721 <para><computeroutput>RDONLYGUEST</computeroutput>&#xA0;: la
2722 valeur ne peut être modifiée que par l'hôte, l'invité ne
2723 peut que la lire&#xA0;;</para>
2724 </listitem>
2725
2726 <listitem>
2727 <para><computeroutput>RDONLYHOST</computeroutput>&#xA0;: inversement,
2728 cette valeur ne peut être modifiée que par l'invité, l'hôte
2729 ne peut que la lire&#xA0;;</para>
2730 </listitem>
2731
2732 <listitem>
2733 <para><computeroutput>READONLY</computeroutput>&#xA0;: la
2734 combinaison des deux, la valeur ne peut pas être modifiée.</para>
2735 </listitem>
2736 </itemizedlist></para>
2737 </listitem>
2738
2739 <listitem>
2740 <para><computeroutput>wait &lt;vm&gt; &lt;échantillon&gt; --timeout
2741 &lt;timeout&gt;</computeroutput>&#xA0;: Ceci attend une valeur
2742 particulière décrite par "échantillon" à modifier ou effacer ou à
2743 créer. Les règles de l'échantillon sont les mêmes qu'avec la commande
2744 "enumerate" ci-dessus.</para>
2745 </listitem>
2746 <listitem>
2747 <para><computeroutput>delete &lt;vm&gt; &lt;propriété&gt;
2748 </computeroutput>&#xA0;: Efface une propriété invité définie précédemment.</para>
2749 </listitem>
2750 </itemizedlist></para>
2751 </sect1>
2752
2753 <sect1 id="vboxmanage-guestcontrol">
2754 <title>VBoxManage guestcontrol</title>
2755
2756 <para>Les commandes "guestcontrol" vous permettent de contrôler certaines
2757 choses de l'invité à partir de l'hôte. Merci de voir <xref
2758 linkend="guestadd-guestcontrol" /> pour une présentation.</para>
2759
2760 <para>En général, la syntaxe est la suivante&#xA0;:</para>
2761
2762 <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; &lt;commande&gt;</screen>
2763
2764 <para>Les sous-commandes suivantes sont disponibles (où
2765 <computeroutput>&lt;uuid|nomvm&gt;</computeroutput>, dans tous les cas, peut
2766 être le nom ou l'UUID d'une VM comme avec les autres commandes de
2767 VBoxManage)&#xA0;:<itemizedlist>
2768 <listitem>
2769 <para><emphasis role="bold"><computeroutput>execute</computeroutput></emphasis>, qui permet d'exécuter un
2770 programme/script (processus) déjà installé et exécutable sur l'invité.
2771 Cette commande ne fonctionne que pendant qu'une VM est active et en
2772 fonction et sa syntaxe est la suivante&#xA0;:</para>
2773
2774 <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; exec[ute]
2775 --image &lt;chemin du programme&gt; --username &lt;nom&gt;
2776 [--passwordfile &lt;fichier&gt; | --password &lt;mot de passe&gt;]
2777 [--environment "&lt;NOM&gt;=&lt;VALEUR&gt; [&lt;NOM&gt;=&lt;VALEUR&gt;]"]
2778 [--verbose] [--timeout &lt;msec&gt;]
2779 [--wait-exit] [--wait-stdout] [--wait-stderr]
2780 [--dos2unix] [--unix2dos]
2781 -- [[&lt;argument1&gt;] ... [&lt;argumentN&gt;]]</screen>
2782
2783 <para>où les paramètres signifient&#xA0;: <glosslist>
2784 <glossentry>
2785 <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
2786
2787 <glossdef>
2788 <para>Le nom ou l'UUID de la VM. Obligatoire.</para>
2789 </glossdef>
2790 </glossentry>
2791
2792 <glossentry>
2793 <glossterm><computeroutput>--image "&lt;chemin du programme&gt;"</computeroutput></glossterm>
2794
2795 <glossdef>
2796 <para>Chemin absolu et nom du processus à exécuter dans
2797 l'invité, comme <computeroutput>C:\Windows\System32\calc.exe</computeroutput></para>
2798 </glossdef>
2799 </glossentry>
2800
2801 <glossentry>
2802 <glossterm><computeroutput>--username &lt;nom&gt;</computeroutput></glossterm>
2803
2804 <glossdef>
2805 <para>Nom de l'utilisateur sous lequel devrait se lancer le
2806 processus. Cet utilisateur doit exister sur l'OS invité.</para>
2807 </glossdef>
2808 </glossentry>
2809
2810 <glossentry>
2811 <glossterm><computeroutput>--passwordfile &lt;fichier&gt;</computeroutput></glossterm>
2812 <glossterm><computeroutput>--password &lt;motdepasse&gt;</computeroutput></glossterm>
2813
2814 <glossdef>
2815 <para>Mot de passe du compte utilisateur spécifié, à lire dans
2816 le fichier donné. Si vous n'en donnez pas, un mot de passe
2817 vierge est supposé.</para>
2818 </glossdef>
2819 </glossentry>
2820
2821 <glossentry>
2822 <glossterm>--password &lt;mot de passe&gt;</glossterm>
2823
2824 <glossdef>
2825 <para>Mot de passe du compte utilisateur spécifié avec
2826 <computeroutput>--username</computeroutput>. Si vous n'en
2827 donnez pas, un mot de passe vierge est supposé.</para>
2828 </glossdef>
2829 </glossentry>
2830
2831 <glossentry>
2832 <glossterm><computeroutput>--dos2unix</computeroutput></glossterm>
2833
2834 <glossdef>
2835 Convertit les fins de lignes de la sortie des invités DOS/Windows
2836 en fins compatibles UNIX (CR + LF -> LF). Pas encore implémenté.
2837 </glossdef>
2838 </glossentry>
2839
2840 <glossentry>
2841 <glossterm><computeroutput>--environment
2842 "&lt;NOM&gt;=&lt;VALEUR&gt;"</computeroutput></glossterm>
2843
2844 <glossdef>
2845 <para>Une ou plusieurs variables d'environnement à définir ou
2846 dérégler.</para>
2847
2848 <para>Par défaut, le nouveau processus de l'invité sera
2849 créé avec l'environnement standard de l'OS invité. Cette
2850 option permet de modifier cet environnement. Pour définir/modifier
2851 une variable, une paire <computeroutput>NOM=VALEUR</computeroutput> doit
2852 être spécifiée&#xA0;; pour dérégler une certaine variable, le
2853 nom sans valeur doit être défini, par exemple
2854 <computeroutput>NOM=</computeroutput>.</para>
2855
2856 <para>Les arguments contenant des espaces doivent être entourés
2857 de guillemets. Vous pouvez spécifier plus d'un
2858 <computeroutput>--environment</computeroutput> en même temps
2859 pour maintenir vierge la ligne de commande.</para>
2860 </glossdef>
2861 </glossentry>
2862
2863 <glossentry>
2864 <glossterm><computeroutput>--timeout &lt;msec&gt;</computeroutput></glossterm>
2865
2866 <glossdef>
2867 <para>Valeur (ien millisecondes) qui spécifie la durée pendant
2868 laquelle le processus démarré est autorisé à fonctionner et
2869 combien de temps VBoxManage attent une sortie de ce processus.
2870 Si vous ne spécifiez pas de timeout, VBoxManage attendra
2871 jusqu'à ce que le processus démarré se termine ou ce qu'une
2872 erreur ne survienne.</para>
2873 </glossdef>
2874 </glossentry>
2875
2876 <glossentry>
2877 <glossterm><computeroutput>--unix2dos</computeroutput></glossterm>
2878
2879 <glossdef>
2880 Convertit les fins de lignes de la sortie des invités DOS/Windows
2881 en fins compatibles UNIX (CR + LF -> LF). Pas encore implémenté.
2882 </glossdef>
2883 </glossentry>
2884
2885 <glossentry>
2886 <glossterm><computeroutput>--verbose</computeroutput></glossterm>
2887
2888 <glossdef>
2889 <para>Dit à VBoxManage d'être plus verbeux.</para>
2890 </glossdef>
2891 </glossentry>
2892
2893 <glossentry>
2894 <glossterm><computeroutput>--wait-exit</computeroutput></glossterm>
2895
2896 <glossdef>
2897 <para>Attend la fin d'un processus et affiche son code de
2898 sortie avec la raison/les drapeaux de sa fin.</para>
2899 </glossdef>
2900 </glossentry>
2901
2902 <glossentry>
2903 <glossterm><computeroutput>--wait-stdout</computeroutput></glossterm>
2904
2905 <glossdef>
2906 <para>Attend la fin d'un processus et affiche son code de
2907 sortie avec la raison/les drapeaux de sa fin. En attendant,
2908 VBoxManage récupère la sortie du processus sur stdout.</para>
2909 </glossdef>
2910 </glossentry>
2911
2912 <glossentry>
2913 <glossterm><computeroutput>--wait-stderr</computeroutput></glossterm>
2914
2915 <glossdef>
2916 <para>Attend la fin d'un processus et affiche son code de
2917 sortie avec la raison/les drapeaux de sa fin. En attendant,
2918 VBoxManage récupère la sortie du processus sur stderr.</para> </glossdef>
2919 </glossentry>
2920
2921 <glossentry>
2922 <glossterm><computeroutput>[-- [&lt;argument1s&gt;] ... [&lt;argumentNs&gt;]]</computeroutput></glossterm>
2923
2924 <glossdef>
2925 <para>Un ou plusieurs arguments à passer au processus à
2926 exécuter.</para>
2927 <para>Les arguments contenant des espaces doivent être entourés
2928 de guillemets.</para>
2929 </glossdef>
2930 </glossentry>
2931
2932 </glosslist></para>
2933
2934 <para><note>
2935 <para>Sur Windows, il existe certaines limites pour les applications
2936 graphiques&#xA0;; merci de voir <xref linkend="KnownIssues" /> pour
2937 plus d'informations.</para>
2938 </note> Exemples&#xA0;: <screen>VBoxManage --nologo guestcontrol "Ma VM" execute --image "/bin/ls"
2939 --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"
2940 --username foo --passwordfile bar.txt --wait-exit --wait-stdout</screen> Remarquez que
2941 les deux barres obliques inversées du deuxième exemple ne sont requis
2942 que pour les hôtes Unix.</para>
2943
2944 <para><note>
2945 <para>Pour certaines commandes, il faut spécifier le nom d'utilisateur
2946 d'un compte utilisateur existant sur l'invité&#xA0;; les exécutions
2947 anonymes ne sont pas supportées pour des raisons de sécurité.
2948 Néanmoins, le mot de passe d'un compte utilisateur est facultatif
2949 et dépend de la politique et des règles de l'invité. Si vous ne
2950 spécifiez aucun mot de passe pour un nom d'utilisateur donné,
2951 un mot de passe vierge sera utilisé. Sur certains OS comme Windows,
2952 il pe peut qu'il faille ajuster la politique de sécurité pour autoriser
2953 le paramétrage d'un compte utilisateur avec un mot de passe vierge.
2954 En outre, les règles du domaine global pourraient s'appliquer et, donc,
2955 on ne peut pas les modifier.</para>
2956 </note></para>
2957
2958 <para>À partir de VirtualBox 4.1.2 l'exécution d'un processus invité
2959 par défaut se limite à 5 processus invités en même temps. Si un
2960 nouveau processus invité est lancé et dépasserait cette limite, le
2961 plus ancien dans l'invité qui ne s'exécute pas sera désactivé afin de
2962 pouvoir lancer ce nouveau processus. En outre, la récupération de la
2963 sortie de cet ancien processus invité ne sera alors plus possible.
2964 Si les 5 processus invités sont toujours actifs et en fonction, le
2965 démarrage d'un nouveau processus enverra un message d'erreur circonstancié.</para>
2966
2967 <para>Pour augmenter ou diminuer la limite d'exécution des processus
2968 invité, il faut modifier soit la propriété <computeroutput>/VirtualBox/GuestAdd/VBoxService/--control-procs-max-kept</computeroutput>,
2969 soit la ligne de commande ee VBoxService en spécifiant
2970 <computeroutput>--control-procs-max-kept</computeroutput>. Il faut
2971 ensuite redémarrer l'OS invité. Pour gérer un nombre illimité de
2972 processus invités, il faut définir une valeur de <computeroutput>0</computeroutput>
2973 (non recommandé).</para>
2974 </listitem>
2975
2976 <listitem>
2977 <para><emphasis role="bold"><computeroutput>copyto</computeroutput></emphasis>, qui permet de copier
2978 des fichiers de l'hôte vers l'invité (seulement si les suppléments invité
2979 4.0 et supérieur sont installés).</para>
2980
2981 <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; copyto|cp
2982 &lt;source invité&gt; &lt;hôte dest&gt; --username &lt;nom&gt;
2983 [--passwordfile &lt;fichier&gt; | --password &lt;mot de passe&gt;]
2984 [--dryrun] [--follow] [--recursive] [--verbose]</screen>
2985
2986 <para>où les paramètres signifient&#xA0;: <glosslist>
2987 <glossentry>
2988 <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
2989
2990 <glossdef>
2991 <para>L'UUID ou le nom de la VM. Obligatoire.</para>
2992 </glossdef>
2993 </glossentry>
2994
2995 <glossentry>
2996 <glossterm><computeroutput>source sur l'hôte</computeroutput></glossterm>
2997
2998 <glossdef>
2999 <para>Chemin absolu du/des fichier(s) source(s) de l'hôte
3000 sur l'hôte pour copier vers l'invité, comme
3001 <computeroutput>C:\Windows\System32\calc.exe</computeroutput>.
3002 Il peut s'agir d'une expression joker, comme
3003 <computeroutput>C:\Windows\System32\*.dll</computeroutput></para>
3004 </glossdef>
3005 </glossentry>
3006
3007 <glossentry>
3008 <glossterm><computeroutput>destination sur l'invité</computeroutput></glossterm>
3009
3010 <glossdef>
3011 <para>Chemin de destination absolu sur l'invité, comme
3012 <computeroutput>C:\Temp</computeroutput></para>
3013 </glossdef>
3014 </glossentry>
3015
3016 <glossentry>
3017 <glossterm><computeroutput>--username &lt;nom&gt;</computeroutput></glossterm>
3018
3019 <glossdef>
3020 <para>Nom d'utilisateur sous lequel devrait fonctionner le
3021 processus de copie. Cet utilisateur doit exister sur l'OS
3022 invité.</para>
3023 </glossdef>
3024 </glossentry>
3025
3026 <glossentry>
3027 <glossterm><computeroutput>--passwordfile &lt;fichier&gt;</computeroutput></glossterm>
3028
3029 <glossdef>
3030 <para>Mot de passe du compte utilisateur spécifié, à lire dans
3031 le fichier donné. Si vous n'en donnez pas, un mot de passe
3032 vierge est supposé.</para>
3033 </glossdef>
3034 </glossentry>
3035
3036 <glossentry>
3037 <glossterm><computeroutput>--password &lt;mot depasse&gt;</computeroutput></glossterm>
3038
3039 <glossdef>
3040 <para>Mot de passe du compte utilisateur spécifié avec
3041 <computeroutput>--username</computeroutput>. Si vous n'en
3042 donnez pas, un mot de passe vierge est supposé.</para>
3043 </glossdef>
3044 </glossentry>
3045
3046 <glossentry>
3047 <glossterm><computeroutput>--dryrun</computeroutput></glossterm>
3048
3049 <glossdef>
3050 <para>Dit à VBoxManage de ne faire qu'une exécution dry au
3051 lieu de copier vraiment les fichiers dans l'invité.</para>
3052 </glossdef>
3053 </glossentry>
3054
3055 <glossentry>
3056 <glossterm><computeroutput>--follow</computeroutput></glossterm>
3057
3058 <glossdef>
3059 <para>Active le suivi des liens symboliques sur la
3060 source de l'hôte.</para>
3061 </glossdef>
3062 </glossentry>
3063
3064 <glossentry>
3065 <glossterm><computeroutput>--recursive</computeroutput></glossterm>
3066
3067 <glossdef>
3068 <para>Copie récursivement les fichiers/répertoires de la
3069 source spécifiée.</para>
3070 </glossdef>
3071 </glossentry>
3072
3073 <glossentry>
3074 <glossterm><computeroutput>--verbose</computeroutput></glossterm>
3075
3076 <glossdef>
3077 <para>Dit à VBoxManage d'être plus verbeux.</para>
3078 </glossdef>
3079 </glossentry>
3080
3081 <glossentry>
3082 <glossterm><computeroutput>--flags &lt;drapeaux&gt;</computeroutput></glossterm>
3083
3084 <glossdef>
3085 <para>Drapeaux supplémentaires à définir. Ce n'est pas utilisé
3086 pour le moment.</para>
3087 </glossdef>
3088 </glossentry>
3089 </glosslist></para>
3090 </listitem>
3091
3092 <listitem>
3093 <para><emphasis role="bold"><computeroutput>copyfrom</computeroutput></emphasis>,
3094 qui permet de copier
3095 des fichiers de l'invité vers l'hôte (seulement si les suppléments
3096 invité 4.0 et supérieur sont installés). Il prend les mêmes paramètres
3097 que <computeroutput>copyto</computeroutput> ci-dessus.</para>
3098 </listitem>
3099
3100 <listitem>
3101 <para><emphasis role="bold"><computeroutput>createdirectory</computeroutput></emphasis>, qui permet de copier
3102 des fichiers de l'invité vers l'hôte (seulement si les suppléments
3103 invité 4.0 et supérieur sont installés). Il prend les mêmes paramètres
3104 que <computeroutput>copyto</computeroutput> ci-dessus.</para>
3105
3106 <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; createdir[ectory]|mkdir|md
3107 &lt;répertoire invité&gt;... --username &lt;nom&gt;
3108 [--passwordfile &lt;fichier&gt; | --password &lt;mot de passe&gt;]
3109 [--parents] [--mode &lt;mode&gt;] [--verbose]</screen>
3110
3111 <para>où les paramètres signifient&#xA0;: <glosslist>
3112 <glossentry>
3113 <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
3114
3115 <glossdef>
3116 <para>L'UUID ou le nom de la VM. Obligatoire.</para>
3117 </glossdef>
3118 </glossentry>
3119
3120 <glossentry>
3121 <glossterm><computeroutput>répertoire à créer sur l'invité</computeroutput></glossterm>
3122
3123 <glossdef>
3124 <para>Chemin absolu du/des répertoire(s) à créer sur l'invité,
3125 comme <computeroutput>D:\Foo\Bar</computeroutput>. Les répertoires
3126 Parents doivent exister (comme dans cet exemple
3127 <computeroutput>D:\Foo</computeroutput>) si vous ne mettez pas
3128 <computeroutput>--parents</computeroutput>. L'utilisateur
3129 spécifié doit avoir les droits appropriés pour créer le répertoire
3130 spécifié.</para>
3131 </glossdef>
3132 </glossentry>
3133
3134 <glossentry>
3135 <glossterm><computeroutput>--username &lt;nom&gt;</computeroutput></glossterm>
3136
3137 <glossdef>
3138 <para>Nom de l'utilisateur sous lequel devrait fonctionner
3139 le processus de copie. Cet utilisateur doit exister sur l'OS
3140 invité.</para>
3141 </glossdef>
3142 </glossentry>
3143
3144 <glossentry>
3145 <glossterm><computeroutput>--passwordfile &lt;fichier&gt;</computeroutput></glossterm>
3146
3147 <glossdef>
3148 <para>Mot de passe du compte utilisateur spécifié, à lire dans
3149 le fichier donné. Si vous n'en donnez pas, un mot de passe
3150 vierge est supposé.</para> </glossdef>
3151 </glossentry>
3152
3153 <glossentry>
3154 <glossterm><computeroutput>--password &lt;mot de passe&gt;</computeroutput></glossterm>
3155
3156 <glossdef>
3157 <para>Mot de passe du compte utilisateur spécifié avec
3158 <computeroutput>--username</computeroutput>. Si vous n'en
3159 donnez pas, un mot de passe vierge est supposé.</para>
3160 </glossdef>
3161 </glossentry>
3162
3163 <glossentry>
3164 <glossterm><computeroutput>--parents</computeroutput></glossterm>
3165
3166 <glossdef>
3167 <para>Crée aussi les répertoires parent non encore créés
3168 pour le répertoire spécifié, par exemple si le répertoire
3169 <computeroutput>D:\Foo</computeroutput> de
3170 <computeroutput>D:\Foo\Bar</computeroutput> n'existe pas encore,
3171 il sera créé. Si on ne spécifie pas
3172 <computeroutput>--parent</computeroutput>, l'action échouerait.</para>
3173 </glossdef>
3174 </glossentry>
3175
3176 <glossentry>
3177 <glossterm><computeroutput>--mode &lt;mode&gt;</computeroutput></glossterm>
3178
3179 <glossdef>
3180 <para>Définit les droits du répertoire spécifié. Seules des
3181 valeurs octales (comme
3182 <computeroutput>0755</computeroutput>) sont supportées pour l'heure.</para>
3183 </glossdef>
3184 </glossentry>
3185
3186 <glossentry>
3187 <glossterm><computeroutput>--verbose</computeroutput></glossterm>
3188
3189 <glossdef>
3190 <para>Dit à VBoxManage d'être plus verbeux.</para>
3191 </glossdef>
3192 </glossentry>
3193 </glosslist></para>
3194 </listitem>
3195
3196 <listitem>
3197 <para><emphasis role="bold"><computeroutput>createtemporary</computeroutput></emphasis>,
3198 qui permet de copier des fichiers de l'hôte sur l'invité (seulement
3199 si les suppléments invités 4.2 ou supérieur sont installés).</para>
3200
3201 <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; createtemp[orary]|mktemp
3202 &lt;modèle&gt; --username &lt;nom&gt;
3203 [--passwordfile &lt;fichier&gt; | --password &lt;mot_de_passe&gt;]
3204 [--directory] [--secure] [--tmpdir &lt;répertoire&gt;]
3205 [--domain &lt;domaine&gt;] [--mode &lt;mode&gt;] [--verbose]</screen>
3206
3207 <para>où les paramètres signifient&#xA0;: <glosslist>
3208 <glossentry>
3209 <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
3210
3211 <glossdef>
3212 <para>L'UUID ou le nom de la VM. Obligatoire.</para>
3213 </glossdef>
3214 </glossentry>
3215
3216 <glossentry>
3217 <glossterm><computeroutput>modèle</computeroutput></glossterm>
3218
3219 <glossdef>
3220 <para>Un nom de fichier sans chemin et avec au moins trois
3221 caractères 'X' consécutifs ou se terminant par 'X'.</para>
3222 </glossdef>
3223 </glossentry>
3224
3225 <glossentry>
3226 <glossterm><computeroutput>--username &lt;nom&gt;</computeroutput></glossterm>
3227
3228 <glossdef>
3229 <para>Nom de l'utilisateur sous lequel devrait fonctionner
3230 le processus de copie. Cet utilisateur doit exister sur l'OS
3231 invité.</para>
3232 </glossdef>
3233 </glossentry>
3234
3235 <glossentry>
3236 <glossterm><computeroutput>--passwordfile &lt;fichier&gt;</computeroutput></glossterm>
3237
3238 <glossdef>
3239 <para>Mot de passe du compte utilisateur spécifié, à lire dans
3240 le fichier donné. Si vous n'en donnez pas, un mot de passe
3241 vierge est supposé.</para> </glossdef>
3242 </glossentry>
3243
3244 <glossentry>
3245 <glossterm><computeroutput>--password &lt;mot de passe&gt;</computeroutput></glossterm>
3246
3247 <glossdef>
3248 <para>Mot de passe du compte utilisateur spécifié avec
3249 <computeroutput>--username</computeroutput>. Si vous n'en
3250 donnez pas, un mot de passe vierge est supposé.</para>
3251 </glossdef>
3252 </glossentry>
3253
3254 <glossentry>
3255 <glossterm><computeroutput>--directory</computeroutput></glossterm>
3256
3257 <glossdef>
3258 <para>Crée un répertoire temporaire au lieu d'un fichier.</para>
3259 </glossdef>
3260 </glossentry>
3261
3262 <glossentry>
3263 <glossterm><computeroutput>--secure</computeroutput></glossterm>
3264
3265 <glossdef>
3266 <para>
3267 Création sécurisée. Le mode du fichier est
3268 <computeroutput>0755</computeroutput>. Et l'opération
3269 échouera si elle ne peut s'effectuer en sécurité.
3270 </para>
3271 </glossdef>
3272 </glossentry>
3273
3274 <glossentry>
3275 <glossterm><computeroutput>--tmpdir &lt;répertoire&gt;</computeroutput></glossterm>
3276
3277 <glossdef>
3278 <para>
3279 Répertoire où le fichier / répertoire sera cRéé.
3280 Si vous n'en indiquez pas, répertoire temporaire spécifique
3281 'à la plateforme est utilisé.
3282 </para>
3283 </glossdef>
3284 </glossentry>
3285
3286 <glossentry>
3287 <glossterm><computeroutput>--mode &lt;mode&gt;</computeroutput></glossterm>
3288
3289 <glossdef>
3290 <para>Définit les droits du répertoire spécifié. Seules des
3291 valeurs octales (comme
3292 <computeroutput>0755</computeroutput>) sont supportées pour l'heure.</para>
3293 </glossdef>
3294 </glossentry>
3295
3296 <glossentry>
3297 <glossterm><computeroutput>--verbose</computeroutput></glossterm>
3298
3299 <glossdef>
3300 <para>Dit à VBoxManage d'être plus verbeux.</para>
3301 </glossdef>
3302 </glossentry>
3303 </glosslist></para>
3304 </listitem>
3305
3306 <listitem>
3307 <para><emphasis role="bold"><computeroutput>list</computeroutput></emphasis>,
3308 qui présente plusieurs informations de contrôle de l'invité telles
3309 que les sessions et les fichiers ouverts dans l'invité et les processus de l'invité.</para>
3310
3311 <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; list
3312 &lt;all|sessions|processes|files&gt; [--verbose]</screen>
3313
3314 <para>où les paramètres signifient&nbsp;: <glosslist>
3315 <glossentry>
3316 <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
3317 <glossdef>
3318 <para>L'UUID ou le nom de la VM. Obligatoire.</para>
3319 </glossdef>
3320 </glossentry>
3321
3322 <glossentry>
3323 <glossterm><computeroutput>all|sessions|processes|files</computeroutput></glossterm>
3324
3325 <glossdef>
3326 <para>présenter les sessions dans l'invité, les processus de
3327 l'invité, les fichiers dans l'invité ou toutes les informations disponibles.</para>
3328 </glossdef>
3329 </glossentry>
3330
3331 <glossentry>
3332 <glossterm><computeroutput>--verbose</computeroutput></glossterm>
3333
3334 <glossdef>
3335 <para>Dit à VBoxManage d'être plus verbeux.</para>
3336 </glossdef>
3337 </glossentry>
3338 </glosslist></para>
3339 </listitem>
3340
3341 <listitem>
3342 <para><emphasis role="bold"><computeroutput>process kill</computeroutput></emphasis>,
3343 qui termine des processus de l'invité en particulier pour une session
3344 de l'invité, à partir soit l'ID de la session, soit du nom de la
3345 session.</para>
3346
3347 <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; process kill
3348 --session-id &lt;ID&gt;
3349 | --session-name &lt;nom ou modèle&gt;
3350 [--verbose]
3351 &lt;PID&gt; ... &lt;PID n&gt;</screen>
3352
3353 <para>où les paramètres signifient&nbsp;: <glosslist>
3354 <glossentry>
3355 <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
3356
3357 <glossdef>
3358 <para>L'UUID ou le nom de la VM. Obligatoire.</para>
3359 </glossdef>
3360 </glossentry>
3361
3362 <glossentry>
3363 <glossterm><computeroutput>--session-id</computeroutput></glossterm>
3364
3365 <glossdef>
3366 <para>Spécifie la session de l'invité à utiliser par son ID.</para>
3367 </glossdef>
3368 </glossentry>
3369
3370 <glossentry>
3371 <glossterm><computeroutput>--session-name</computeroutput></glossterm>
3372
3373 <glossdef>
3374 <para>Spécifie la session de l'invité à utiliser par son nom.
3375 Vous pouvez spécifier plusieurs sessions en spécifiant les jokers
3376 * ou ?.</para>
3377 </glossdef>
3378 </glossentry>
3379
3380 <glossentry>
3381 <glossterm><computeroutput>--verbose</computeroutput></glossterm>
3382
3383 <glossdef>
3384 <para>Dit à VBoxManage d'être plus verbeux.</para>
3385 </glossdef>
3386 </glossentry>
3387
3388 <glossentry>
3389 <glossterm><computeroutput>&lt;PID&gt; ... &lt;PID n&gt;</computeroutput></glossterm>
3390
3391 <glossdef>
3392 <para>Liste les identifiants des processus (PIDs) à terminer.</para>
3393 </glossdef>
3394 </glossentry>
3395 </glosslist></para>
3396 </listitem>
3397
3398 <listitem>
3399 <para><emphasis role="bold"><computeroutput>[p[s]]kill</computeroutput></emphasis>,
3400 qui termine des processus en particulier dans une session de l'invité,
3401 à partir soit de l'ID de la session, soit de son nom.</para>
3402
3403 <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; process kill
3404 --session-id &lt;ID&gt;
3405 | --session-name &lt;nom ou modèle&gt;
3406 [--verbose]
3407 &lt;PID&gt; ... &lt;PID n&gt;</screen>
3408
3409 <para>où les paramètres signifient&nbsp;: <glosslist>
3410 <glossentry>
3411 <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
3412
3413 <glossdef>
3414 <para>L'UUID ou le nom de la VM. Obligatoire.</para>
3415 </glossdef>
3416 </glossentry>
3417
3418 <glossentry>
3419 <glossterm><computeroutput>--session-id</computeroutput></glossterm>
3420
3421 <glossdef>
3422 <para>Spécifie la session de l'invité à utiliser par son ID.</para>
3423 </glossdef>
3424 </glossentry>
3425
3426 <glossentry>
3427 <glossterm><computeroutput>--session-name</computeroutput></glossterm>
3428
3429 <glossdef>
3430 <para>Spécifie la session de l'invité à utiliser par son nom. Vous
3431 pouvez spécifier plusieurs sessions avec les jokers * ou ?.</para>
3432 </glossdef>
3433
3434 </glossentry>
3435
3436 <glossentry>
3437 <glossterm><computeroutput>--verbose</computeroutput></glossterm>
3438
3439 <glossdef>
3440 <para>Dit à VBoxManage d'être plus verbeux.</para>
3441 </glossdef>
3442 </glossentry>
3443
3444 <glossentry>
3445 <glossterm><computeroutput>&lt;PID&gt; ... &lt;PID n&gt;</computeroutput></glossterm>
3446
3447 <glossdef>
3448 <para>Liste les identifiants des processus (PIDs) à terminer.</para>
3449 </glossdef>
3450 </glossentry>
3451 </glosslist></para>
3452 </listitem>
3453
3454 <listitem>
3455 <para><emphasis role="bold"><computeroutput>session close</computeroutput></emphasis>,
3456 qui ferme des sessions spécifiques de l'invité à partir de l'ID de la
3457 session ou de son nom.</para>
3458
3459 <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; session close
3460 --session-id &lt;ID&gt;
3461 | --session-name &lt;nom ou extrait&gt;
3462 | --all
3463 [--verbose]</screen>
3464
3465 <para>où les paramètres signifient : <glosslist>
3466 <glossentry>
3467 <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
3468
3469 <glossdef>
3470 <para>L'UUID ou le nom de la VM. Obligatoire.</para>
3471 </glossdef>
3472 </glossentry>
3473
3474 <glossentry>
3475 <glossterm><computeroutput>--session-id</computeroutput></glossterm>
3476
3477 <glossdef>
3478 <para>Ferme une session de ;'invité spécifiée par son ID.</para>
3479 </glossdef>
3480 </glossentry>
3481
3482 <glossentry>
3483 <glossterm><computeroutput>--session-name</computeroutput></glossterm>
3484
3485 <glossdef>
3486 <para>Ferme une session de ;'invité spécifiée par son nom. Vous
3487 pouvez fermer plusieurs sessions grâce aux jokers * ou ?.</para>
3488 </glossdef>
3489 </glossentry>
3490
3491 <glossentry>
3492 <glossterm><computeroutput>--all</computeroutput></glossterm>
3493
3494 <glossdef>
3495 <para>Ferme toutes les sessions de l'invité.</para>
3496 </glossdef>
3497 </glossentry>
3498
3499 <glossentry>
3500 <glossterm><computeroutput>--verbose</computeroutput></glossterm>
3501
3502 <glossdef>
3503 <para>Dit à VBoxManage d'être plus verbeux.</para>
3504 </glossdef>
3505 </glossentry>
3506 </glosslist></para>
3507 </listitem>
3508
3509 <listitem>
3510 <para><emphasis role="bold"><computeroutput>stat</computeroutput></emphasis>, qui affiche l'état d'un
3511 fichier ou d'un système de fichiers de l'invité.</para>
3512
3513 <screen>VBoxManage guestcontrol &lt;nomvm&gt;|&lt;uuid&gt; stat
3514 &lt;file&gt;... --username &lt;nom&gt;
3515 [--passwordfile &lt;fichier&gt; | --password &lt;mot de passe&gt;]
3516 [--verbose]</screen>
3517
3518 <para>où les paramètres signifient&#xA0;: <glosslist>
3519 <glossentry>
3520 <glossterm>uuid|nomvm</glossterm>
3521
3522 <glossdef>
3523 <para>L'UUID ou le nom de la VM. Obligatoire.</para>
3524 </glossdef>
3525 </glossentry>
3526
3527 <glossentry>
3528 <glossterm>élément(s) de fichier à vérifier sur l'invité</glossterm>
3529
3530 <glossdef>
3531 <para>Chemin absolu du/des répertoire(s) à vérifier sur l'invité,
3532 comme <computeroutput>/home/foo/a.out</computeroutput>.
3533 L'utilisateur spécifié doit avoir les droits adéquats d'accès
3534 à/aux élément(s) fichier unique(s).</para>
3535 </glossdef>
3536 </glossentry>
3537
3538 <glossentry>
3539 <glossterm>--username &lt;nom&gt;</glossterm>
3540
3541 <glossdef>
3542 <para>Nom de l'utilisateur sous lequel devrait s'exécuter le
3543 processus de copie. L'utilisateur doit exister sur l'OS invité.</para>
3544 </glossdef>
3545 </glossentry>
3546
3547 <glossentry>
3548 <glossterm>--passwordfile &lt;fichier&gt;</glossterm>
3549
3550 <glossdef>
3551 <para>Mot de passe du compte utilisateur spécifié, à lire dans
3552 le fichier donné. Si vous n'en donnez pas, un mot de passe
3553 vierge est supposé.</para>
3554 </glossdef>
3555 </glossentry>
3556
3557 <glossentry>
3558 <glossterm>--password &lt;mot de passe&gt;</glossterm>
3559
3560 <glossdef>
3561 <para>Mot de passe du compte utilisateur spécifié avec
3562 <computeroutput>--username</computeroutput>. Si vous n'en
3563 donnez pas, un mot de passe vierge est supposé.</para>
3564 </glossdef>
3565 </glossentry>
3566
3567 <glossentry>
3568 <glossterm><computeroutput>--verbose</computeroutput></glossterm>
3569
3570 <glossdef>
3571 <para>Dit à VBoxManage d'être plus verbeux.</para>
3572 </glossdef>
3573 </glossentry>
3574 </glosslist></para>
3575 </listitem>
3576
3577 <listitem>
3578 <para><emphasis role="bold"><computeroutput>updateadditions</computeroutput></emphasis>, qui permet de
3579 mettre à jour une version des suppléments invité installée sur l'invité
3580 (sur les suppléments invité installés 4.0 et supérieur).</para>
3581
3582 <screen>VBoxManage guestcontrol &lt;nomvm&gt;|&lt;uuid&gt; updateadditions
3583 [--source "&lt;fichier des suppléments invité .ISO à utiliser&gt;"] [--verbose]
3584 [--wait-start] [-- [&lt;argument1&gt;] ... [&lt;argumentN&gt;]]</screen>
3585
3586 <para>où les paramètres signifient&#xA0;: <glosslist>
3587 <glossentry>
3588 <glossterm>uuid|nomvm</glossterm>
3589
3590 <glossdef>
3591 <para>L'UUID ou le nom de la VM. Obligatoire.</para>
3592 </glossdef>
3593 </glossentry>
3594
3595 <glossentry>
3596 <glossterm>--source "&lt;fichier des suppléments invité .ISO à
3597 utiliser&gt;"</glossterm>
3598
3599 <glossdef>
3600 <para>Chemin complet vers un autre fichier .ISO de suppléments
3601 invité à utiliser pour mettre à jour les suppléments invité.</para>
3602 </glossdef>
3603 </glossentry>
3604
3605 <glossentry>
3606 <glossterm>--verbose</glossterm>
3607
3608 <glossdef>
3609 <para>Dit à VBoxManage d'être plus verbeux.</para>
3610 </glossdef>
3611 </glossentry>
3612
3613 <glossentry>
3614 <glossterm>--wait-start</glossterm>
3615 <glossdef>
3616 <para>Démarre le processus normal de mise à jour et attend
3617 jusqu'à ce que la mise à jour des suppléments invité soit
3618 effectivement démarrée dans l'invité. Cela peut être nécessaire
3619 du fait de l'interaction nécessaire avec l'OS invité pendant
3620 la phase d'installation.</para>
3621 <para>Si vous ne mettez pas ce drapeau, VBoxManage attendra
3622 que toute la mise à jour des suppléments invité s'achève.</para>
3623 </glossdef>
3624 </glossentry>
3625 <glossentry>
3626 <glossterm>[-- [&lt;argument1s&gt;] ... [&lt;argumentNs&gt;]]</glossterm>
3627
3628 <glossdef>
3629. <para>Arguments en ligne de commandes à utiliser avec l'installeur
3630 des suppléments invité. Sert à ajouter des fonctions non
3631 installées précédemment sur l'invité.</para>
3632 <para>Vous devez entourer les arguments contenant des espaces
3633 par des guillemets.</para>
3634 </glossdef>
3635 </glossentry>
3636 </glosslist></para>
3637 </listitem>
3638
3639 <listitem>
3640 <para><emphasis role="bold"><computeroutput>watch</computeroutput></emphasis>,
3641 qui affiche un contrôle de l'activité actuelle de l'invité.</para>
3642
3643 <screen>VBoxManage guestcontrol &lt;uuid|nomvm&gt; watch
3644 [--verbose]</screen>
3645
3646 <para>où les paramètres signifient : <glosslist>
3647 <glossentry>
3648 <glossterm><computeroutput>uuid|nomvm</computeroutput></glossterm>
3649
3650 <glossdef>
3651 <para>L'UUID ou le nom de la VM. Obligatoire.</para>
3652 </glossdef>
3653 </glossentry>
3654
3655 <glossentry>
3656 <glossterm><computeroutput>--verbose</computeroutput></glossterm>
3657
3658 <glossdef>
3659 <para>Dit à VBoxManage d'être plus verbeux.</para>
3660 </glossdef>
3661 </glossentry>
3662 </glosslist></para>
3663 </listitem>
3664 </itemizedlist></para>
3665 </sect1>
3666
3667 <sect1 id="vboxmanage-debugvm">
3668 <title>VBoxManage debugvm</title>
3669
3670 <para>Les commandes "debugvm" sont pour les experts qui veulent jouer avec
3671 les détails exacts de l'exécution d'une machine virtuelle. Comme le débogueur
3672 de la VM décrit au <xref linkend="ts_debugger" />, ces commandes ne sont
3673 utiles que si vous êtes très familier des détails l'architecture d'une VM et
3674 de la façon de déboguer un logiciel.</para>
3675
3676 <para>Les sous-commandes de "debugvm" fonctionnent sur une machine virtuelle
3677 en fonction. Celles suivantes sont disponibles&#xA0;:<itemizedlist>
3678 <listitem>
3679 <para>Avec <computeroutput>dumpguestcore --filename
3680 &lt;nom&gt;</computeroutput>, vous pouvez créer un fichier de renvoi
3681 système de la VM en fonction, qui sera écrit dans le fichier donné.
3682 Ce fichier aura un format ELF c&#x153;ur standard (avec des sections
3683 personnalisées)&#xA0;; voir
3684 <xref linkend="ts_guest-core-format" />.</para>
3685
3686 <para>Cela correspond à la commande
3687 <computeroutput>writecore</computeroutput> du débogueur.
3688 </para>
3689 </listitem>
3690
3691 <listitem>
3692 <para>La commande <computeroutput>info</computeroutput> est utilisée
3693 pour afficher des éléments d'info liés à la VMM, aux émulations de
3694 périphérique et aux pilotes associés. Cette commande prend un ou
3695 deux arguments&#xA0;: le nom de l'élément d'info, éventuellement suivi
3696 d'une chaîne contenant les arguments spécifiques à l'élément d'info.
3697 L'élément d'info <computeroutput>help</computeroutput> fournit une liste
3698 des éléments disponibles et des astuces sur les arguments supplémentaires.</para>
3699
3700 <para>Cela correspond à la commande <computeroutput>info</computeroutput>
3701 du débogueur.</para>
3702 </listitem>
3703
3704 <listitem>
3705 <para>La commande <computeroutput>injectnmi</computeroutput> provoque
3706 une interruption non masquable (<foreignphrase>non-maskable interrupt</foreignphrase>
3707 (NMI) dans l'invité, qui pourrait être utile dans certains scénarios
3708 de débogage. Ce qui se passe exactement dépend du système d'exploitation
3709 invité mais une NMI peut planter tout le système d'exploitation invité.
3710 Ne l'utilisez pas, sauf si vous savez ce que vous faites.</para>
3711 </listitem>
3712
3713 <listitem>
3714 <para>La commande <computeroutput>osdetect</computeroutput> lance
3715 la fonction de (re)-détection du débogueur de VMM du système d'exploitation
3716 de l'invité.</para>
3717
3718 <para>Cela correspond à la commande <computeroutput>detect</computeroutput>
3719 du débogueur.</para>
3720 </listitem>
3721
3722 <listitem>
3723 <para>La commande <computeroutput>osinfo</computeroutput> est utilisée
3724 pour afficher des infos sur le système d'exploitation (OS) détecté par
3725 le débogueur de la VM.</para>
3726 </listitem>
3727
3728 <listitem>
3729 <para>La commande <computeroutput>getregisters</computeroutput> est
3730 utilisée pour afficher le registre du processeur et des périphériques.
3731 La commande prend une liste des registres, chacun ayant une des
3732 formes suivantes&#xA0;:
3733 <itemizedlist>
3734 <listitem><computeroutput>réglage-registre.nom-registre.sous-champ</computeroutput></listitem>
3735 <listitem><computeroutput>réglage-registre.nom-registre</computeroutput></listitem>
3736 <listitem><computeroutput>nom-registre-processeur.sous-champ</computeroutput></listitem>
3737 <listitem><computeroutput>nom-registre-processeur</computeroutput></listitem>
3738 <listitem><computeroutput>all</computeroutput></listitem>
3739 </itemizedlist>
3740 La forme <computeroutput>all</computeroutput> affichera tous les
3741 registres (pas les sous-champs). Les noms des registres sont indifférents
3742 à la casse. Quand vous interrogez un registre du processeur, vous
3743 pouvez ne pas mettre le réglage du registre, il sera sélectionné en
3744 utilisant la valeur de l'option <computeroutput>--cpu</computeroutput>
3745 (0 par dé2ant).
3746 </para>
3747 </listitem>
3748
3749 <listitem>
3750 <para>La commande <computeroutput>setregisters</computeroutput> est
3751 utilisée pour modifier les registres des périphériques et du processeur.
3752 La commande prend une liste d'affectations de registres, chacune ayant
3753 une des formes suivantes&#xA0;:
3754 <itemizedlist>
3755 <listitem><computeroutput>réglage-registre.nom-registre.sous-champ=valeur</computeroutput></listitem>
3756 <listitem><computeroutput>réglage-registre.nom-registre=valeur</computeroutput></listitem>
3757 <listitem><computeroutput>nom-registre-processeur.sous-champ=valeur</computeroutput></listitem>
3758 <listitem><computeroutput>nom-registre-processeur=valeur</computeroutput></listitem>
3759 </itemizedlist>
3760 Le format de la valeur devrait être du même genre que ce qu'affiche
3761 <computeroutput>getregisters</computeroutput>, sauf qu'on peut utiliser
3762 des octets et des décimales au lieu de l'hexadécimal. Le nommage du
3763 registre et le réglage par défaut du registre processeur sont gérés
3764 de la même manière qu'avec la commande
3765 <computeroutput>getregisters</computeroutput>.</para>
3766 </listitem>
3767
3768 <listitem>
3769 <para>La commande <computeroutput>statistics</computeroutput> peut
3770 être utilisée pour afficher des statistiques VMM sur la ligne de
3771 commandes. L'option <computeroutput>--reset</computeroutput> réinitialisera
3772 les statistiques. Les statistiques concernées sont filtrables avec l'option
3773 <computeroutput>--pattern</computeroutput> qui accepte des jokers en style
3774 DOS/NT (<computeroutput>?</computeroutput> et
3775 <computeroutput>*</computeroutput>).</para>
3776 </listitem>
3777 </itemizedlist></para>
3778 </sect1>
3779
3780 <sect1 id="metrics">
3781 <title>VBoxManage metrics</title>
3782
3783 <para>Cette commande supporte la surveillance de l'utilisation des ressources
3784 système. Les ressources sont représentées par différentes métriques associées
3785 au système hôte ou à une VM en particulier. Par exemple, le système hôte a
3786 une métrique <computeroutput>CPU/Load/User</computeroutput> qui affiche le
3787 pourcentage du temps procc!eur passé à tourner en mode utilisateur sur une
3788 période spécifique.</para>
3789
3790 <para>Les données de métrique sont rassemblées et stockées en interne&#xA0;;
3791 vous pouvez les récupérer n'importe quand avec la sous-commande
3792 <computeroutput>VBoxManage metric query</computeroutput>. Les données sont
3793 disponibles tant que le processus en tâche de fond
3794 <computeroutput>VBoxSVC</computeroutput> process is est vivant. Ce processus
3795 ce termine peu après que toutes les VMs et les interfaces ont été fermées.</para>
3796
3797 <para>Par défaut, aucune métrique n'est enregistrée. La récupération de
3798 métriques ne commence pas avant que <computeroutput>VBoxManage metrics setup</computeroutput>
3799 ne soit appelé avec un bon intervalle modèle et que le nombre de métriques
3800 n'a été conservé. On mesure l'intervalle en secondes. Par exemple, pour
3801 activer la récupération des métriques de l'utilisation du processeur et de
3802 la mémoire hôte toutes les secondes, en gardant les 5 échantillons les plus
3803 actuels, vous pouvez utiliser la commande suivante&#xA0;:</para>
3804
3805 <screen>VBoxManage metrics setup --period 1 --samples 5 host CPU/Load,RAM/Usage</screen>
3806
3807 <para>Le recueil de métriques ne peut être activé que sur des VMs démarrées.
3808 Les données et les paramètres de récupération d'une VM en particulier disparaîtront
3809 dès que vous éteindrez la VM. Utilisez la sous-commande
3810 <computeroutput>VBoxManage metrics list
3811 </computeroutput> pour voir les métriques actuellement disponibles. Vous
3812 pouvez aussi utiliser l'option <computeroutput>--list</computeroutput> avec
3813 une sous-commande modifiant les paramètres de métrique pour chercher les
3814 métriques concernées.</para>
3815
3816 <para>Remarquez que la sous-commande <computeroutput>VBoxManage metrics
3817 setup</computeroutput> désactive tous les échantillons qui peuvent avoir été
3818 recueillis pour un jeu d'objets et de métriques spécifique.</para>
3819
3820 <para>Pour activer ou désactiver la récupération des métriques sans perdre
3821 les données, vous pouvez utiliser les sous-commandes
3822 <computeroutput>VBoxManage metrics enable</computeroutput> et
3823 <computeroutput>VBoxManage metrics disable</computeroutput>. Remarquez que
3824 ces sous-commandes attendent en paramètres des métriques, pas des sous-métriques,
3825 comme <code>CPU/Load</code> ou <code>RAM/Usage</code>. En d'autres termes,
3826 l'activation de <code>CPU/Load/User</code> tout en désactivant <code>CPU/Load/Kernel</code>
3827 n'est pas supporté.</para>
3828
3829 <para>L'hôte et les VMs ont différents ensembles de métriques associées.
3830 Vous pouvez lister les métriques disponibles avec
3831 <computeroutput>VBoxManage metrics
3832 list</computeroutput> subcommand.</para>
3833
3834 <para>Un nom de métrique complet peut inclure une fonction d'agrégat. Le
3835 nom prend la forme suivante&#xA0;:
3836 <computeroutput>Catégorie/Métrique[/SousMétrique][:aggrégé]</computeroutput>.
3837 Par exemple, <computeroutput>RAM/Usage/Free:min</computeroutput> signifie la
3838 quantité minimum de mémoire disponible parmi toutes les données en mémoire
3839 s, cela s'applique à l'objet hôte.</para>
3840
3841 <para>Les sous-commandes peuvent s'appliquer à tous les objets et les
3842 métriques ou se limiter à un objet et/ou une liste de métriques. Si vous
3843 ne donnez aucun objet ni métrique en paramètres, les sous-commandes s'appliqueront
3844 à toutes les métriques disponibles de tous les objets. Vous pouvez utiliser
3845 une astérisque ("<computeroutput>*</computeroutput>") pour spécifier explicitement
3846 que la commande devrait s'appliquer à tous les objets ou à toutes les métriques.
3847 Utilisez "host" en nom d'objet pour limiter la cible de la commande aux
3848 métriques relatives à l'hôte. Pour limiter la cible à un sous-ensemble de métriques,
3849 utilisez une liste de noms séparés par des virgules.</para>
3850
3851 <para>Par exemple, pour interroger les données de métriques sur le temps
3852 passé par le processeur en modes utilisateur et noyau, sur la machine virtuelle
3853 nommée "test", vous pouvez utiliser la commande suivante&#xA0;:</para>
3854
3855 <screen>VBoxManage metrics query test CPU/Load/User,CPU/Load/Kernel</screen>
3856
3857 <para>La liste suivante résume les sous-commandes disponibles&#xA0;:</para>
3858
3859 <glosslist>
3860 <glossentry>
3861 <glossterm>list</glossterm>
3862
3863 <glossdef>
3864 <para>Cette sous-commande affiche les paramètres des métriques
3865 existant actuellement. Remarquez que les métriques spécifiques à la VM
3866 ne sont disponibles que quand une VM en particulier
3867 est en fonction.</para>
3868 </glossdef>
3869 </glossentry>
3870
3871 <glossentry>
3872 <glossterm>setup</glossterm>
3873
3874 <glossdef>
3875 <para>Cette sous-commande définit l''intervalle entre deux prises
3876 d'échantillons des données de métriques et le nombre d'échantillons gardés
3877 en interne. Les données mémorisées sont disponibles en affichage avec
3878 la sous-commande <code>query</code>. L'option <computeroutput>--list
3879 </computeroutput> affiche les métriques qui ont été modifiées dans le
3880 résultat de l'exécution de la commande.</para>
3881 </glossdef>
3882 </glossentry>
3883
3884 <glossentry>
3885 <glossterm>enable</glossterm>
3886
3887 <glossdef>
3888 <para>Cette sous-commande "réactive le recueil de données après qu'il
3889 a été arrêTé avec la sous-commande <code>disable</code>. Remarquez que
3890 la spécification de sous-métriques comme paramètres n'activera pas les
3891 métriques sous-jacentes. Utilisez
3892 <computeroutput>--list</computeroutput> pour savoir si la commande a
3893 fait ce que vous aviez prévu.</para>
3894 </glossdef>
3895 </glossentry>
3896
3897 <glossentry>
3898 <glossterm>disable</glossterm>
3899
3900 <glossdef>
3901 <para>Cette sous-commande "suspends" le recueil des données sans
3902 changer les paramètres de récupération ni altérer les données recueillies.
3903 Remarquez que la spécification de sous-métriques en paramètres ne
3904 désactivera pas les métriques sous-jacentes. Utilisez
3905 <computeroutput>--list</computeroutput> pour voir si la commande a fait
3906 ce que vous aviez prévu.</para>
3907 </glossdef>
3908 </glossentry>
3909
3910 <glossentry>
3911 <glossterm>query</glossterm>
3912
3913 <glossdef>
3914 <para>Cette sous-commande récupère et affiche les données de métriques
3915 mémorisées.<note>
3916 <para>La sous-commande <code>query</code> subcommand ne supprime
3917 pas ni ne remet à 0 les données mémorisées. Si vous interrogez
3918 assez souvent, vous verrez la durée d'évacuation graduelle des
3919 échantillons par les nouveaux échantillons.</para>
3920 </note></para>
3921 </glossdef>
3922 </glossentry>
3923
3924 <glossentry>
3925 <glossterm>collect</glossterm>
3926
3927 <glossdef>
3928 <para>Cette sous-commande définit l'intervalle entre la prise de deux
3929 échantillons de données de métrique et le nombre d'échantillons mémorisés
3930 en interne. Les données recueillies s'affichent périodiquement jusqu'à
3931 ce que vous appuyiez sur Ctrl-C, sauf si vous spécifiez l'option
3932 <computeroutput>--detach</computeroutput>. Avec l'option
3933 <computeroutput>--detach</computeroutput>, cette sous-commande agit de
3934 la même façon que <code>setup</code>. L'option <computeroutput>--list</computeroutput>
3935 affiche les métriques correspondant au filtre spécifié.</para>
3936 </glossdef>
3937 </glossentry>
3938 </glosslist>
3939 </sect1>
3940
3941 <sect1>
3942 <title>VBoxManage hostonlyif</title>
3943
3944 <para>Avec "hostonlyif", vous pouvez changer la configuration de l'IP d'une
3945 interface réseau host-only. Pour une description du réseau host-only, merci
3946 de vous reporter au <xref linkend="network_hostonly" />. Chaque interface
3947 host-only par un nom et peut soit utiliser le serveur DHCP interne, soit
3948 voir son adresse IP configurée à la main (IP4 et IP6).</para>
3949 </sect1>
3950
3951 <sect1 id="vboxmanage-dhcpserver">
3952 <title>VBoxManage dhcpserver</title>
3953
3954 <para>Les commandes de "dhcpserver" vous permettent de contrôler le serveur
3955 DHCP construit dans VirtualBox. Vous pourriez trouver cela utile si vous
3956 utilisez le réseau interne ou host-only. (En théorie, vous pouvez
3957 l'activer aussi pour un réseu bridgé, mais cela provoquera probablement des
3958 conflits avec d'autres serveurs DHCP de votre réseau physique.)</para>
3959
3960 <para>Utilisez les options suivantes de la ligne de commandes&#xA0;:<itemizedlist>
3961 <listitem>
3962 <para>Si vous utilisez le réseau interne pour l'adaptateur réseau
3963 virtuel d'une machine virtuelle, utilisez <computeroutput>VBoxManage dhcpserver add
3964 --netname &lt;nom_réseau&gt;</computeroutput>, où
3965 <computeroutput>&lt;nom_réseau&gt;</computeroutput> est le même nom
3966 de réseau que celui que vous avez utilisé avec
3967 <computeroutput>VBoxManage modifyvm
3968 &lt;nomvm&gt; --intnet&lt;X&gt;
3969 &lt;nom_réseau&gt;</computeroutput>.</para>
3970 </listitem>
3971
3972 <listitem>
3973 <para>Si vous utilisez le réseau interne pour l'adaptateur réseau
3974 virtuel d'une machine virtuelle, utilisez plutôt <computeroutput>VBoxManage dhcpserver add
3975 --ifname &lt;hostonly_if_name&gt;</computeroutput>, où
3976 <computeroutput>&lt;hostonly_if_name&gt;</computeroutput> est le même
3977 nom de l'interface host-only que vous avez utilisé avec
3978 <computeroutput>VBoxManage modifyvm &lt;nomvm&gt;
3979 --hostonlyadapter&lt;X&gt;
3980 &lt;hostonly_if_name&gt;</computeroutput>.</para>
3981
3982 <para>Vous pouvez aussi utiliser l'option --netname comme avec les
3983 réseaux internes si vous connaissez le nom du réseau host-only&#xA0;;
3984 vous pouvez voir les noms avecc <computeroutput>VBoxManage list
3985 hostonlyifs</computeroutput> (voir <xref linkend="vboxmanage-list" />
3986 ci-dessus).</para>
3987 </listitem>
3988 </itemizedlist></para>
3989
3990 <para>Les paramètres suivants supplémentaires sont requis quand vous ajoutez
3991 un serveur DHCP pour la première fois&#xA0;:<itemizedlist>
3992 <listitem>
3993 <para>Avec <computeroutput>--ip</computeroutput>, spécifiez l'adresse
3994 IP du serveur DHCP lui-même.</para>
3995 </listitem>
3996
3997 <listitem>
3998 <para>Avec <computeroutput>--netmask</computeroutput>, spécifiez
3999 le masque du réseau.</para>
4000 </listitem>
4001
4002 <listitem>
4003 <para>Avec <computeroutput>--lowerip</computeroutput> aet
4004 <computeroutput>--upperip</computeroutput>, vous pouvez spécifier
4005 respectivement l'adresse la plus basse et la plus haute que le serveur
4006 DHCP attribuera aux clients.</para>
4007 </listitem>
4008 </itemizedlist></para>
4009
4010 <para>Enfin, vous devez spécifier<computeroutput>--enable</computeroutput>,
4011 sinon le serveur DHCP sera créé en état désactivé, ce qui ne fera rien.</para>
4012
4013 <para>Après cela, VirtualBox démarrera automatiquement le serveu DHCP pour
4014 le réseau nterne ou host-only donné dès que la première machine virtuelle utilisant
4015 ce réseau sera démarrée.</para>
4016
4017 <para>Inversement, utilisez <computeroutput>VBoxManage dhcpserver
4018 remove</computeroutput> avec <computeroutput>--netname
4019 &lt;nom_réseau&gt;</computeroutput> ou <computeroutput>--ifname
4020 &lt;hostonly_if_name&gt;</computeroutput> pour supprimer le serveur DHCP,
4021 de nouveau pour le réseau interne ou host-only donné.</para>
4022
4023 <para>Pour modifier les paramètres d'un serveurDHCP créé précédemment avec
4024 <computeroutput>VBoxManage dhcpserver add</computeroutput>, vous pouvez
4025 utiliser
4026 <computeroutput>VBoxManage dhcpserver modify</computeroutput> pour une
4027 interface réseau interne ou host-only donnée.</para>
4028 </sect1>
4029
4030 <sect1 id="vboxmanage-extpack">
4031 <title>VBoxManage extpack</title>
4032
4033 <para>La commande "extpack" vous permet d'ajouter ou de supprimer des packs
4034 d'extension de VirtualBox comme décrit au <xref
4035 linkend="intro-installing" />.<itemizedlist>
4036 <listitem>
4037 <para>Pour ajouter un nouveau pack d'extension, utilisez <computeroutput>VBoxManage
4038 extpack install &lt;.vbox-extpack&gt;</computeroutput>. Cette commande
4039 échouera si une version plus ancienne du même pack d'extension est
4040 déjà installée. Vous pouvez utiliser le paramètre optionnel
4041 <computeroutput>--replace</computeroutput> pour désinstaller l'ancien
4042 paquet avant d'installer le nouveau paquet..</para>
4043 </listitem>
4044
4045 <listitem>
4046 <para>Pour supprimer un pack d'extension précédemment installé, utilisez
4047 <computeroutput>VBoxManage extpack uninstall
4048 &lt;nom&gt;</computeroutput>. Vous pouvez utiliser
4049 <computeroutput>VBoxManage list extpacks</computeroutput> tpour
4050 afficher les noms des pack d'extensions actuellement installés&#xA0;;
4051 merci de voir aussi <xref linkend="vboxmanage-list" />. Vous pouvez
4052 utiliser le paramètre optionnel <computeroutput>--force</computeroutput>
4053 pour surpasser le refus de se désinstaller d'un pack d'extension.</para>
4054 </listitem>
4055
4056 <listitem>
4057 <para>La commande <computeroutput>VBoxManage extpack
4058 cleanup</computeroutput> peut être utilisée pour supprimer temporairement
4059 les fichiers et les répertoires qui peuvent avoir été laissés après
4060 l'échec d'une précédente commande d'installation ou de désinstallation.</para>
4061 </listitem>
4062 </itemizedlist></para>
4063 <para>Les commandes suivantes montrent des exemples d'une liste des packs
4064 d'extension et de la manière d'en supprimer un&#xA0;:<screen>
4065$ VBoxManage list extpacks
4066pack d'extensions: 1
4067Pack no. 0: Oracle VM VirtualBox pack d'extension
4068Version: 4.1.12
4069Revision: 77218
4070Edition:
4071Description: USB 2.0 Host Controller, VirtualBox RDP, PXE ROM with E1000 support.
4072VRDE Module: VBoxVRDP
4073Usable: true
4074Why unusable:
4075$ VBoxManage extpack uninstall "Oracle VM VirtualBox pack d'extension"
40760%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%
4077Successfully uninstalled "Oracle VM VirtualBox pack d'extension".</screen></para>
4078 </sect1>
4079</chapter>
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette