user_VBoxManage.xml@ 48223

Last change on this file since 48223 was 48223, checked in by vboxsync, 11 years ago
doc/manual: updated French translation. Thank you Jean-Philippe MENGUAL.
File size: 187.8 KB

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

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

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

Download in other formats: