user_VBoxManage.xml@ 44638

Last change on this file since 44638 was 44638, checked in by vboxsync, 12 years ago
doc: major update to French user manual - thank you Jean-Philippe Mengual!
File size: 170.1 KB

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

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

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

Download in other formats: