user_VBoxManage.xml@ 56541

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

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

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

以其他格式下載: