user_VBoxManage.xml@ 48112

Last change on this file since 48112 was 47722, checked in by vboxsync, 11 years ago
doc/manual: updated the French translation, thank you Jean-Philippe Mengual!
File size: 186.8 KB

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

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

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

Download in other formats: