user_VBoxManage.xml@ 68349

最後變更在這個檔案從68349是 68349,由 vboxsync 提交於 7 年前
doc/manual/FR: fix all docbook XML validity errors in the user_*.xml files. Most were missing/incorrectly placed <para> tags, but there were several severe structural issues, too. This was done over 2 years ago with the ENglish version.
檔案大小: 201.0 KB

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

注意: 瀏覽 TracBrowser 來幫助您使用儲存庫瀏覽器

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

以其他格式下載: