user_VBoxManage.xml@ 51284

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

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

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

Download in other formats: