user_VBoxManage.xml@ 49891

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

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

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

Download in other formats: