user_VBoxManage.xml@ 44928

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

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

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

Download in other formats: