user_VBoxManage.xml@ 47141

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

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

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

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

Download in other formats: