user_VBoxManage.xml@ 46092

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

Note: See TracBrowser for help on using the repository browser.

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

Download in other formats: