user_VBoxManage.xml@ 58268

Last change on this file since 58268 was 56556, checked in by vboxsync, 9 years ago
manual/Makefile.kmk,*: Replaced fancy SED r <VBoxManage-dumpopts-output-file> command with xi:include in user_VBoxManage.xml.
File size: 200.9 KB

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

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

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

Download in other formats: