user_VBoxManage.xml@ 49154

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

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

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

Download in other formats: