user_VBoxManage.xml@ 54201

Last change on this file since 54201 was 52034, checked in by vboxsync, 10 years ago
doc/manual: updated the French translation. Thank you Jean-Philippe Mengual.
File size: 200.8 KB

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

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

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

Download in other formats: