user_VBoxManage.xml@ 46770

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

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

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

Download in other formats: