| Nom |
Description |
| --accelerate2dvideo on|off |
Ce paramètre permet d'activer ou désactiver l'accélération vidéo 2D si les suppléments invité sont installés. |
| --accelerate3d on|off |
Ce paramètre permet d'activer ou désactiver l'accélération matérielle 3D si les suppléments invité sont installés. |
| --acpi on|off |
Ce paramètre permet de déterminer si la machine virtuelle prend en charge ACPI. |
| --apic on|off |
Ce paramètre permet d'activer et de désactiver l'entrée/sortie APIC. Avec l'entrée/sortie APIC, les systèmes d'exploitation peuvent utiliser plus de 16 demandes d'interruption (IRQ) évitant ainsi le partage d'IRQ pour une fiabilité améliorée. Ce paramètre est activé par défaut. |
| --biosapic x2apic|apic|disabled |
Ce paramètre permet d'indiquer le niveau APIC du micrologiciel à utiliser. Les options sont : x2apic, apic ou disabled (pas d'apic ou x2apic) respectivement. Notez que si x2apic est spécifié et que x2APIC n'est pas pris en charge par le VCPU, biosapic passe à apic, s'il est pris en charge. Sinon, biosapic passe à désactivé. De même, si apic est spécifié et que APIC n'est pas pris en charge, une rétrogradation vers des résultats désactivés. |
| --biosbootmenu disabled|menuonly|messageandmenu |
Ce paramètre permet d'indiquer si le BIOS offre la possibilité à l'utilisateur de sélectionner un périphérique de démarrage temporaire. L'option menuonly supprime le message, mais l'utilisateur peut toujours appuyer sur F12 pour sélectionner un périphérique de démarrage temporaire. |
| --biospxedebug on|off |
Ce paramètre permet d'activer ou de désactiver la sortie de débogage supplémentaire lors de l'utilisation de la ROM de démarrage Intel PXE. La sortie est écrite dans le fichier journal de bord des versions. |
| --biossystemtimeoffset ms |
Ce paramètre permet d'indiquer un décalage horaire fixe, en millisecondes, de l'invité par rapport à l'heure de l'hôte. Si le décalage est positif, l'heure de l'invité est antérieure à l'heure de l'hôte. |
| --boot1-4 none|floppy|dvd|disk|net |
Ce paramètre permet d'indiquer l'ordre de démarrage de la machine virtuelle. Il existe quatre emplacements auxquels la machine virtuelle tentera d'accéder de 1 à 4, et pour chacun desquels vous pouvez définir un périphérique à partir duquel la machine virtuelle doit tenter de démarrer. |
| --chipset piix3|ich9 |
Ce paramètre permet d'indiquer l'ensemble de puce à émuler. Par défaut, VirtualBox émule un ensemble de puces Intel PIIX3. Il n'y a généralement aucune raison de changer le paramètre par défaut, sauf si cela est nécessaire pour assouplir certaines de ses contraintes. |
| --cpuexecutioncap 1-100 |
Ce paramètre permet de contrôler le temps processeur qu'un processeur virtuel peut utiliser. Une valeur de 50 implique qu'un seul processeur virtuel peut utiliser jusqu'à 50% d'un seul processeur hôte. |
| --cpuhotplug on|off |
Ce paramètre permet d'activer le branchement à chaud du processeur. Lorsqu'elle est activée, les processeurs virtuels peuvent être ajoutés et supprimés d'une machine virtuelle pendant son exécution. |
| --cpu-profile host|intel 80[86|286|386] |
Ce paramètre permet d'activer la spécification d'un profil pour l'émulation du processeur invité. Spécifiez soit un basé sur le processeur du système hôte (hôte), soit un d'un certain nombre d'anciennes micro-architectures Intel : 8086, 80286, 80386. |
| --cpus cpucount |
Ce paramètre permet de définir le nombre de microprocesseur virtuels pour la machine virtuelle. Si le branchement à chaud du processeur est activé, il définit alors le nombre maximal de processeurs virtuels pouvant être connectés aux machines virtuelles. |
| --defaultfrontend default|name |
Ce paramètre permet d'indiquer l'interface par défaut à utiliser lors du démarrage de cette machine virtuelle. |
| --description desc
| Ce paramètre permet de modifier la description de la machine virtuelle, étant un moyen d'enregistrer les détails de la machine virtuelle d'une manière significative pour l'utilisateur. L'interface graphique interprète le formatage HTML, la ligne de commande autorise des chaînes de caractères arbitraires contenant potentiellement plusieurs lignes. |
| --firmware bios|efi|efi32|efi64 |
Ce paramètre permet d'indiquer que le micrologiciel à utiliser pour démarrer la machine virtuelle. Les options disponibles sont : BIOS ou l'une des options EFI: efi, efi32 ou efi64. Utilisez les options EFI avec précaution. |
| --graphicscontroller none|vboxvga|vmsvga|vboxsvga |
Ce paramètre permet d'indiquer l'utilisation d'un contrôleur graphique, avec une option pour choisir un type spécifique. |
| --groups group, ... |
Ce paramètre permet de modifier l'appartenance au groupe d'une machine virtuelle. Les groupes commencent toujours par un/et peuvent être imbriqués. Par défaut, les machines virtuelles sont dans le groupe /. |
| --guestmemoryballoon size |
Ce paramètre permet de définir la taille par défaut de la bulle de mémoire d'invité. Il s'agit de la mémoire allouée par les suppléments invité VirtualBox à partir du système d'exploitation invité et renvoyée à l'hyperviseur pour être réutilisée par d'autres machines virtuelles. Le paramètre size doit être spécifié en mégaoctets. La taille par défaut est de 0 mégaoctets. |
| --hardwareuuid uuid |
Ce paramètre permet d'indiquer l'UUID présenté à l'invité via les tables de mémoire (DMI / SMBIOS), le matériel et les propriétés d'invité. Par défaut, c'est le même que l'UUID de la machine virtuelle. Ce paramètre est utile lors du clonage d'une machine virtuelle. La téléportation s'en charge automatiquement. |
| --hpet on|off |
Ce paramètre permet d'activer et de désactiver une minuterie d'événements de haute précision (HPET) pouvant remplacer les minuteries système héritées. Ceci est désactivé par défaut. Notez que Windows prend en charge un HPET uniquement à partir de Windows Vista. |
| --hwvirtex on|off |
Ce paramètre permet d'activer et désactiver l'utilisation d'extensions de virtualisation matérielle, telles que Intel VT-x ou AMD-V, dans le processeur de votre système hôte. |
| --iconfile filename |
Ce paramètre permet d'indiquer le chemin absolu sur le système de fichiers hôte de l'icône VirtualBox à afficher dans la machine virtuelle. |
| --ioapic on|off |
Ce paramètre permet de déterminer si la machine virtuelle prend en charge les entrées/sorties APIC. |
| --largepages on|off |
Ce paramètre permet d'améliorer les performances jusqu'à 5% si la virtualisation matérielle et la pagination imbriquée sont activées, pour Intel VT-x uniquement. Il oblige l'hyperviseur à utiliser de grandes pages pour réduire l'utilisation et la surcharge de TLB. |
| --longmode on|off |
Ce paramètre permet d'activer et de désactiver le mode long. |
| --memory memorysize |
Ce paramètre permet de définir la quantité de RAM, en Mo, que la machine virtuelle doit s'allouer à partir de l'hôte. |
| --name name |
Ce paramètre permet de modifier le nom de la machine virtuelle et peut être utilisé pour renommer les fichiers de la machine virtuelle interne. |
| --nested-hw-virt on|off |
Ce paramètre permet d'activer ou désactiver le relais des fonctionnalités de virtualisation matérielle vers l'invité si la virtualisation matérielle est activée. |
| --nestedpaging on|off |
Ce paramètre permet d'activer ou de désactiver l'utilisation de la fonction de pagination imbriquée dans le processeur de votre système hôte, si la virtualisation matérielle est activée. |
| --ostype ostype |
Ce paramètre permet d'indiquer le système d'exploitation invité censé s'exécuter dans la machine virtuelle. |
| --pae on|off |
Ce paramètre permet d'activer et désactiver PAE. |
| --pagefusion on|off |
Ce paramètre permet d'activer et désactiver la fonction de fusion de page. La fusion de page est désactivée par défaut. La fonction Page Fusion minimise la duplication de mémoire entre les machines virtuelles avec des configurations similaires s'exécutant sur le même hôte. |
| --paravirtdebug keyword=value [,keyword=value ...] |
Ce paramètre permet d'indiquer les options de débogage spécifiques au fournisseur de paravirtualisation configuré pour cette machine virtuelle. |
| --paravirtprovider none|default|legacy|minimal|hyperv|kvm |
Ce paramètre permet d'indiquer l'interface de paravirtualisation à fournir au système d'exploitation invité. Spécifier aucun désactive explicitement l'exposition de toute interface de paravirtualisation. L'option par défaut sélectionne une interface appropriée lors du démarrage de la machine virtuelle, en fonction du type de système d'exploitation invité. Il s'agit de l'option par défaut choisie lors de la création de nouvelles machines virtuelles. L'option héritée est utilisée pour les machines virtuelles ayant été créées avec les anciennes versions de VirtualBox et de choisir une interface de paravirtualisation lors du démarrage de la machine virtuelle avec VirtualBox 5.0 et plus récent. Le fournisseur minimal est obligatoire pour les invités Mac OS X. Le kvm et hyperv sont respectivement recommandés pour les invités Linux et Windows. |
| --pciattach host-PCI-address |
Ce paramètre permet d'attacher un contrôleur réseau PCI spécifié sur l'hôte à un bus PCI spécifié sur l'invité. |
| --pcidetach host-PCI-address |
Ce paramètre permet de détacher un contrôleur réseau PCI spécifié sur l'hôte du bus PCI connecté sur l'invité. |
| --plugcpu|unplugcpu id |
Ce paramètre permet d'ajouter ou de supprimer un processeur virtuel sur la machine virtuelle si le branchement à chaud du processeur est activé, Le paramètre id spécifie l'index du processeur virtuel à ajouter ou supprimer et doit être un nombre compris entre 0 et le nombre maximum de processeurs configurés avec l'option --cpus. Le CPU 0 ne peut jamais être supprimé. |
| --rtcuseutc on|off |
Ce paramètre permet de fixer l'horloge en temps réel (RTC) pour qu'elle fonctionne en heure UTC. |
| --snapshotfolder default|path |
Ce paramètre permet d'indiquer le dossier dans lequel les instantanés sont conservés pour une machine virtuelle. |
| --spec-ctrl on|off |
Ce paramètre permet d'activer et de désactiver l'exposition des interfaces de contrôle de spéculation à l'invité, à condition qu'elles soient disponibles sur l'hôte. En fonction du processeur hôte et de la charge de travail, l'activation du contrôle de spéculation peut réduire considérablement les performances. |
| --system-uuid-le on|off |
Ce paramètre permet d'activer ou désactiver la représentation de l'UUID du système sous forme de petit-boutiste. La valeur par défaut est activée pour les nouvelles machines virtuelles. Pour les anciennes machines virtuelles, le paramètre est désactivé pour conserver le contenu de la table DMI / SMBIOS inchangé, ce qui peut être important pour l'activation de la licence Windows. |
| --triplefaultreset on|off |
Ce paramètre permet de réinitialiser l'invité au lieu de déclencher une Guru Meditation. Certains invités soulèvent un triple défaut pour réinitialiser le processeur, c'est donc parfois le comportement souhaité. Fonctionne uniquement pour les invités non-SMP. |
| --vm-process-priority default|flat|low|normal|high |
Ce paramètre permet d'indiquer le schéma de priorité du processus de machine virtuelle à utiliser lors du démarrage de cette machine virtuelle et pendant l'exécution de la machine virtuelle. |
| --vram vramsize |
Ce paramètre permet de définir la quantité de RAM que la carte graphique virtuelle doit avoir. |
| --vtxvpid on|off |
Ce paramètre permet d'activer ou désactiver l'utilisation de la fonction TLB balisée (VPID) dans le processeur de votre système hôte si la virtualisation matérielle est activée, pour Intel VT-x uniquement. |
| --vtxux on|off |
Ce paramètre permet d'activer ou désactiver l'utilisation de la fonction de mode invité sans restriction pour exécuter votre invité si la virtualisation matérielle est activée, pour Intel VT-x uniquement. |
| --x2apic on|off |
Ce paramètre permet d'activer et désactiver la prise en charge de CPU x2APIC. La prise en charge de CPU x2APIC permet aux systèmes d'exploitation de fonctionner plus efficacement sur des configurations à grand nombre de coeurs et optimise la distribution d'interruptions dans les environnements virtualisés. Ce paramètre est activé par défaut. Désactivez ce paramètre lorsque vous utilisez des systèmes d'exploitation hôte ou invité incompatibles avec la prise en charge de x2APIC. |
| --nic1-N none|null|nat|natnetwork|bridged|intnet|hostonly|generic |
Ce paramètre permet de configurer le type de réseau pour chacune des cartes réseau virtuelles de la machine virtuelle. Les options sont: absent (none), non connecté à l'hôte (null), utiliser la traduction d'adresses réseau (nat), utiliser le nouveau moteur de traduction d'adresses réseau (natnetwork), un réseau ponté (ponté) ou utiliser un réseau interne (intnet) , mise en réseau hôte uniquement (hostonly) ou accès aux sous-modes rarement utilisés (generic). |
| --nictype1-N Am79C970A|Am79C973|Am79C970|82540EM|82543GC|82545EM|virtio |
Ce paramètre permet de spécifier le matériel réseau que VirtualBox présente à l'invité pour une carte réseau virtuelle de la machine virtuelle spécifiée. |
| --cableconnected1-N on|off |
Ce paramètre permet de déconnecter temporairement une interface réseau virtuelle, comme si un câble réseau avait été tiré d'une vraie carte réseau. Il peut être utile, par exemple pour réinitialiser certains composantes logiciels de la machine virtuelle. |
| --nicproperty1-N paramname="paramvalue" |
Ce paramètre permet de transmettre des paramètres à des applications dorsales réseau rarement utilisés. Ces paramètres sont spécifiques au moteur d'arrière-plan et sont différents entre le tunnel UDP et les pilotes d'arrière-plan VDE. |
| --nicspeed1-N kbps |
Ce paramètre permet d'indiquer le débit en Ko/s. Ce paramètre n'a un effet que si la mise en réseau générique a été activée pour une carte réseau virtuelle particulière. Voir l'option --nic. Ce mode permet d'accéder à des sous-modes de mise en réseau rarement utilisés, tels que le réseau VDE ou le tunnel UDP. |
| --nicbootprio1-N priority |
Ce paramètre permet d'indiquer l'ordre dans lequel les cartes réseau sont essayées pour le démarrage sur le réseau, à l'aide de PXE. La priorité est un entier compris entre 0 et 4. La priorité 1 est la plus élevée, la priorité 4 est basse. La priorité 0, étant la valeur par défaut, sauf indication contraire, est la plus basse. Notez que cette option n'a d'effet que lorsque la ROM de démarrage Intel PXE est utilisée. |
| --nicpromisc1-N deny|allow-vms|allow-all |
Ce paramètre permet de spécifier le mode de gestion du mode promiscuité pour la carte réseau virtuelle de la machine virtuelle spécifiée. Ce paramètre n'est pertinent que pour les réseaux pontés. Voici les valeurs : |
| allow-all |
Cette valeur permet de supprimer complètement cette restriction. |
| allow-vms |
Cette valeur permet de masquer tout le trafic hôte de la machine virtuelle, mais permet à la machine virtuelle de voir le trafic vers et depuis d'autres machines virtuelles. |
| deny |
Cette valeur permet de masquer tout trafic non destiné à la machine virtuelle. Ce paramètre est la valeur par défaut. |
| --nicbandwidthgroup1-N none|name |
Ce paramètre permet d'ajouter et de supprimer une affectation d'un groupe de bande passante pour l'interface réseau virtuelle spécifiée. Spécifier aucun supprime toute affectation de groupe de bande passante actuelle de l'interface réseau virtuelle spécifiée. La spécification de name ajoute une affectation d'un groupe de bande passante à l'interface réseau virtuelle spécifiée. |
| --bridgeadapter1-N none|devicename |
Ce paramètre permet d'indiquer qu'il n'a d'effet que si la mise en réseau pontée a été activée pour une carte réseau virtuelle. Voir l'option --nic. Utilisez cette option pour spécifier quelle interface hôte l'interface réseau virtuelle donnée utilisera. |
| --hostonlyadapter1-N none|devicename |
Ce paramètre n'a d'effet que si la mise en réseau de l'hôte uniquement a été activée pour une carte réseau virtuelle. Voir l'option --nic. Utilisez cette option pour spécifier l'interface réseau hôte uniquement utilisée par l'interface réseau virtuelle donnée. |
| --intnet1-N |
Ce paramètre n'a d'effet que si la mise en réseau interne a été activée pour une carte réseau virtuelle. Voir l'option --nic. Utilisez cette option pour spécifier le nom du réseau interne. |
| --nat-network1-N network name |
Ce paramètre permet d'indiquer que le nom du réseau NAT auquel cet adaptateur est connecté. Ce paramètre est optionnel. Si le type de réseau est défini sur natnetwork et non sur nat. |
| --nicgenericdrv1-N backend driver |
Ce paramètre permet permet d'accéder à des sous-modes de mise en réseau rarement utilisés, tels que le réseau VDE ou le tunnel UDP. Ce paramètre N'a d'effet que si la mise en réseau générique a été activée pour une carte réseau virtuelle. Voir l'option --nic. |
| --macaddress1-N auto|mac |
Ce paramètre permet de fixer l'adresse MAC d'un adaptateur réseau particulier sur la machine virtuelle. Normalement, chaque carte réseau se voit attribuer une adresse aléatoire par VirtualBox lors de la création de la machine virtuelle. |
| --natnet1-N network|default |
Ce paramètre permet d'indiquer l'intervalle d'adresses IP à utiliser pour ce réseau si le type de réseau est défini sur nat et non sur natnetwork. |
| --natpf1-N [name],tcp|udp,[hostip],hostport,[guestip], guestport |
Ce paramètre permet de définir une règle de transfert de port NAT. |
| --natpf1-N delete name |
Ce paramètre permet de supprimer une règle de transfert de port NAT. |
| --nattftpprefix1-N prefix |
Ce paramètre permet de définir un préfixe pour le serveur TFTP intégré. Par exemple, où se trouve le fichier de démarrage. |
| --nattftpfile1-N bootfile |
Ce paramètre permet de définir le fichier de démarrage TFT. |
| --nattftpserver1-N tftpserver |
Ce paramètre permet de définir l'adresse du serveur TFTP à partir de laquelle démarrer. |
| --nattbindip1-N ip; |
Ce paramètre permet d'indiquer le moteur NAT de VirtualBox acheminant normalement les paquets TCP/IP via l'interface par défaut attribuée par la pile TCP/IP de l'hôte. Utilisez ce paramètre pour indiquer au moteur NAT de se lier à une adresse IP spécifiée à la place. |
| --natdnspassdomain1-N on|off |
Ce paramètre permet d'indiquer si le serveur DHCP intégré transmet le nom de domaine pour la résolution de nom de réseau. |
| --natdnsproxy1-N on|off |
Ce paramètre permet de rendre le moteur NAT de proxy toutes les requêtes DNS invité aux serveurs DNS de l'hôte. |
| --natdnshostresolver1-N on|off |
Ce paramètre permet au moteur NAT d'utiliser les mécanismes de résolution de l'hôte pour gérer les requêtes DNS. |
| --natsettings1-N [mtu],[socksnd],[sockrcv],[tcpsnd], [tcprcv] |
Ce paramètre permet de contrôler plusieurs paramètres NAT. |
| --nataliasmode1-N default|[log],[proxyonly],[sameports] |
Ce paramètre permet de définir le comportement du noyau du moteur NAT : |
| default |
Cette valeur permet de désactiver tous les modes d'aliasing. |
| log |
Cette valeur permet d'activer le journal de bord. |
| proxyonly |
Cette valeur permet de désactiver le mode d'aliasing et rend NAT transparent. |
| sameports |
Cette valeur permet de forcer le moteur NAT à envoyer les paquets via le même port d'origine. |
| --mouse ps2|usb|usbtablet|usbmultitouch |
Ce paramètre permet d'indiquer le mode de la souris à utiliser dans la machine virtuelle. Les options disponibles sont : ps2, usb, usbtablet, usbmultitouch. |
| --keyboard ps2|usb |
Ce paramètre permet d'indiquer le mode du clavier à utiliser dans la machine virtuelle. Les options disponibles sont : ps2, usb. |
| --uart1-N off|I-O-base IRQ |
Ce paramètre permet de configurer les ports série virtuels pour la machine virtuelle. |
| --uartmode1-N arg |
Ce paramètre permet de contrôler la manière dont VirtualBox connecte un port série virtuel donné, configuré avec le paramètre --uartX, à l'hôte sur lequel la machine virtuelle s'exécute. Pour chacun de ces ports, vous pouvez spécifier arg comme l'une des options suivantes : |
| disconnected |
Cet option permet de déconnecter un port. Même si le port série est montré à l'invité, il n'a pas d'autre extrémité. C'est comme un vrai port COM sans câble. |
| server pipename |
Cet option permet, sur un hôte Windows, d'indiquer à VirtualBox de créer un canal nommé sur l'hôte nommé pipename et de lui connecter le périphérique série virtuel. Notez que Windows exige que le nom d'un canal nommé commence par \\.\pipe\. Sur un hôte Linux, au lieu d'un tube nommé, une socket de domaine local est utilisée. |
| client pipename |
Cet option permet de fonctionner comme pour le serveur, sauf que le canal, ou socket de domaine local, n'est pas créé par VirtualBox mais est supposé exister déjà. |
| tcpserver port |
Cet option permet de créer un socket TCP sur l'hôte avec «TCP port» et y connecter le périphérique série virtuel. Notez que les systèmes de type UNIX nécessitent des ports supérieurs à 1024 pour les utilisateurs normaux. |
| tcpclient hostname:port |
Cet option permet de le faire fonctionner comme pour tcpserver, sauf que le socket TCP n'est pas créé par VirtualBox, mais est supposé exister déjà. |
| file file |
Cet option permet de rediriger la sortie du port série vers un fichier brut file spécifié par son chemin absolu sur le système de fichiers hôte. |
| devicename |
Cet option permet d'indiquer le nom du périphérique. Si, au lieu des options ci-dessus, le nom de périphérique d'un port série matériel physique de l'hôte est spécifié, le port série virtuel est connecté à ce port matériel. Sur un hôte Windows, le nom du périphérique sera un port COM tel que COM1. Sur un hôte Linux, le nom du périphérique sera /dev/ttyS0 ou similaire. Il vous permet de connecter un vrai port série à une machine virtuelle. |
| --uarttype 1-N 16450|16550A|16750 |
Ce paramètre permet de configurer le type UART pour un port série virtuel. Le type UART par défaut est 16550A. |
| --lptmode1-N Device |
Ce paramètre permet d'indiquer le nom de périphérique du port parallèle que la fonction de port parallèle utilisera. Utilisez ce paramètre avant --lpt. Cette fonctionnalité dépend du système d'exploitation hôte. Pour les hôtes Windows, utilisez un nom de périphérique tel que lpt1. Sur les hôtes Linux, utilisez un nom de périphérique tel que /dev/lp0. |
| --lpt1-N I-O-base IRQ |
Ce paramètre permet d'indiquer l'adresse d'entrée/sortie du port parallèle et le numéro d'IRQ que la fonction de port parallèle utilisera. Optionnel. Utilisez ceci après --lptmod. L'adresse de base d'entrée/sortie et l'IRQ sont les valeurs que voit l'invité. Par exemple, les valeurs disponibles sous le Device Manager invité. |
| --audio none|null|dsound|oss|alsa|pulse|coreaudio |
Ce paramètre permet d'indiquer si la machine virtuelle doit avoir une prise en charge audio et, le cas échéant, de quel type. La liste des types audio pris en charge dépend de l'hôte et peut être déterminée avec VBoxManage modifyvm. |
| --audiocontroller ac97|hda|sb16 |
Ce paramètre permet d'indiquer le contrôleur audio à utiliser avec la machine virtuelle. |
| --audiocodec stac9700|ad1980|stac9221|sb16 |
Ce paramètre permet d'indiquer le codec audio à utiliser avec la machine virtuelle. |
| --audioin on |
Ce paramètre permet d'indiquer si la capture audio à partir de l'hôte est activée (on) ou désactivée. |
| --audioout on |
Ce paramètre permet d'indiquer si la lecture audio de l'invité est activée (on) ou désactivée. |
| --clipboard-mode disabled|hosttoguest|guesttohost|bidirectional |
Ce paramètre permet de configurer la manière dont le presse-papiers du système d'exploitation invité ou hôte doit être partagé avec l'hôte ou l'invité. Ce paramètre nécessite que les suppléments invité soient installés sur la machine virtuelle. |
| --clipboard-file-transfers enabled|disabled |
Ce paramètre permet d'indiquer si les transferts de fichiers du presse-papiers sont autorisés ou non entre les systèmes d'exploitation hôte et invité. |
| --draganddrop disabled|hosttoguest|guesttohost|bidirectional |
Ce paramètre permet d'indiquer le mode glisser-déposer à utiliser entre l'hôte et la machine virtuelle. Il nécessite que les suppléments invité soient installés sur la machine virtuelle. |
| --monitorcount count |
Ce paramètre permet d'activer la prise en charge de plusieurs moniteurs. |
| --usb on|off |
Ce paramètre permet d'activer et désactiver le contrôleur USB virtuel de la machine virtuelle. |
| --usbehci on|off |
Ce paramètre permet d'activer et désactiver le contrôleur USB 2.0 virtuel de la machine virtuelle. |
| --usbxhci on|off |
Ce paramètre permet d'activer et désactiver le contrôleur USB 3.0 virtuel de la machine virtuelle. |
| --usbrename oldname newname |
Ce paramètre permet de renommer le contrôleur USB virtuel de la VM de oldname à newname. |
| --recording on|off |
Ce paramètre permet d'activer ou désactiver l'enregistrement d'une session d'une machine virtuelle dans un fichier WebM/VP8. Lorsque cette valeur d'option est activée, l'enregistrement commence au démarrage de la session de la machine virtuelle. |
| --recordingscreens all|screen-ID [screen-ID ...] |
Ce paramètre permet de spécifier les écrans de machine virtuelle à enregistrer. L'enregistrement de chaque écran que vous spécifiez est enregistré dans son propre fichier. |
| --recordingfile filename |
Ce paramètre permet d'indiquer le fichier dans lequel sauvegarder l'enregistrement. |
| --recordingmaxsize MB |
Ce paramètre permet d'indiquer la taille maximale du fichier vidéo enregistré en mégaoctets. L'enregistrement s'arrête lorsque le fichier atteint la taille spécifiée. Si cette valeur est égale à zéro, l'enregistrement continue jusqu'à ce que vous l'arrêtiez. |
| --recordingmaxtime seconds |
Ce paramètre permet d'indiquer la durée maximale d'enregistrement en secondes. L'enregistrement s'arrête une fois le nombre de secondes spécifié écoulé. Si cette valeur est égale à zéro, l'enregistrement continue jusqu'à ce que vous l'arrêtiez. |
| --recordingopts keyword=value[,keyword=value ...] |
Ce paramètre permet d'indiquer des options d'enregistrement vidéo supplémentaires dans un format de valeur par mot-clef séparé par des virgules. Par exemple, a=b, g=l,... N'utilisez cette option que si vous êtes un utilisateur avancé. |
| --recordingvideofps fps |
Ce paramètre permet d'indiquer le nombre maximal d'images vidéo par seconde (FPS) à enregistrer. Les images qui ont une fréquence plus élevée sont ignorées. L'augmentation de cette valeur réduit le nombre d'images ignorées et augmente la taille du fichier. |
| --recordingvideorate bit-rate |
Ce paramètre permet d'indiquer le débit binaire de la vidéo en kilobits par seconde. L'augmentation de cette valeur améliore l'apparence de la vidéo au prix d'une augmentation de la taille du fichier. |
| --recordingvideores widthxheight |
Ce paramètre permet d'indiquer la résolution vidéo de la vidéo enregistrée en pixels. |
| --vrde on|off |
Ce paramètre permet d'activer et désactiver le serveur VRDE (VirtualBox Remote Desktop Extension). |
| --vrdeproperty "TCP/Ports|Address=value |
Ce paramètre permet de définir les numéros de port et l'adresse IP sur la machine virtuelle à laquelle le serveur VRDE peut se lier : |
| TCP/Ports |
Cet option permet d'indiquer que value doit être un port ou un intervalle de ports auxquels le serveur VRDE peut se lier. par défaut ou 0 signifie le port 3389, le port standard pour RDP. |
| TCP/Address |
Cet option permet d'indiquer que value doit être l'adresse IP de l'interface réseau hôte à laquelle le serveur VRDE se liera. Si spécifié, le serveur n'acceptera les connexions que sur l'interface réseau hôte spécifiée. |
| --vrdeproperty "VideoChannel/Enabled|Quality|DownscaleProtection=value" |
Ce paramètre permet de définir les propriétés de redirection vidéo VRDP : |
| VideoChannel/Enabled |
Cet option permet d'indiquer que value peut être réglé sur "1", activant le canal vidéo VRDP. |
| VideoChannel/Quality |
Cet option permet d'indiquer que value doit être défini entre 10 et 100% inclus, ce qui représente un niveau de compression JPEG sur le canal vidéo du serveur VRDE. Des valeurs inférieures signifient une qualité inférieure mais une compression plus élevée. |
| VideoChannel/DownscaleProtection |
Cet option permet d'indiquer que value peut être réglé sur «1» pour activer la fonction de protection de réduction de l'échelle du canal vidéo. Lorsqu'elle est activée, si la taille d'une vidéo est égale à la taille du tampon d'ombre, elle est considérée comme une vidéo plein écran et s'affiche. Mais si sa taille se situe entre le plein écran et le seuil de réduction, il n'est pas affiché, car il pourrait s'agir d'une fenêtre d'application, qui serait illisible lors de la réduction. Lorsque la fonction de protection à la baisse est désactivée, une tentative est toujours faite pour afficher des vidéos. |
| --vrdeproperty "Client/DisableDisplay|DisableInput|DisableAudio|DisableUSB=1" |
Ce paramètre permet de désactiver l'une des fonctionnalités du serveur VRDE : Display, Input, Audio ou USB respectivement. Pour activer une fonctionnalité, utilisez "Client/DisableDisplay=" par exemple. |
| --vrdeproperty "Client/DisableClipboard|DisableUpstreamAudio=1" |
Ce paramètre permet de désactiver l'une des fonctionnalités du serveur VRDE : Clipboard ou UpstreamAudio respectivement. Pour activer une fonctionnalité, utilisez "Client/DisableClipboard=" par exemple. |
| --vrdeproperty "Client/DisableRDPDR=1" |
Ce paramètre permet de désactiver la fonction de serveur VRDE : redirection de périphérique RDP pour les cartes à puce. Pour activer cette fonctionnalité, utilisez "Client/DisableRDPR=". |
| --vrdeproperty "H3DRedirect/Enabled=1" |
Ce paramètre permet d'active la fonction serveur VRDE : redirection 3D. Pour désactiver cette fonction, utilisez "H3DRedirect/Enabled=". |
| --vrdeproperty "Security/Method|ServerCertificate|ServerPrivateKey|CACertificate=value" |
Ce paramètre permet de définir la méthode de sécurité souhaitée et le chemin du certificat de serveur, le chemin de la clef privée du serveur, le chemin du certificat CA, étant utilisés pour une connexion : |
| Security/Method=value |
Cette option permet de définir la méthode de sécurité souhaitée, étant utilisée pour une connexion. Les valeurs valides sont : |
| Negotiate |
Cette valeur permet d'indiquer que les connexions de sécurité RDP améliorée (TLS) et standard sont autorisées. La méthode de sécurité est négociée avec le client. Ce sont les paramètres par défauts. |
| RDP |
Cette valeur permet d'indiquer que seule la sécurité RDP standard est acceptée. |
| TLS |
Cette valeur permet d'indiquer que seule la sécurité RDP améliorée est acceptée. Le client doit prendre en charge TLS. |
| Security/ServerCertificate=value |
Cette option permet d'indiquer que value est le chemin absolu du certificat de serveur. |
| Security/ServerPrivateKey=value |
Cette option permet d'indiquer que value est le chemin absolu de la clef privée du serveur. |
| Security/CACertificate=value |
Cette option permet d'indiquer que value est le chemin absolu du certificat auto-signé par l'autorité de certification. |
| --vrdeproperty "Audio/RateCorrectionMode|LogPath=value" |
Ce paramètre permet de définir le mode de connexion audio ou le chemin du fichier journal de bord audio. |
| Audio/RateCorrectionMode=value |
Cette option permet d'indiquer que le value est le mode de correction de débit souhaité. Les valeurs autorisées sont : |
| VRDP_AUDIO_MODE_VOID |
Cette valeur permet d'indiquer qu'aucun mode n'est spécifié. Utilisez pour désactiver tout mode audio déjà défini. |
| VRDP_AUDIO_MODE_RC |
Cette valeur permet d'indiquer le mode de correction de fréquence. |
| VRDP_AUDIO_MODE_LPF |
Cette valeur permet d'indiquer le mode filtre passe-bas. |
| VRDP_AUDIO_MODE_CS |
Cette valeur permet d'indiquer le mode de synchronisation du client pour éviter le sous-dépassement ou le dépassement de la file d'attente du client. |
| Audio/LogPath=value |
Cette option permet d'indiquer que value est le chemin absolu du fichier journal de bord audio. |
| --vrdeextpack default|name |
Ce paramètre permet d'indiquer la bibliothèque à utiliser pour accéder à distance à la machine virtuelle. La valeur par défaut consiste à utiliser le code RDP faisant partie du paquet d'extension VirtualBox. |
| --vrdeport default|ports |
Ce paramètre permet d'indiquer un port ou un intervalle de ports auxquels le serveur VRDE peut se lier. par défaut ou 0 signifie le port 3389, le port standard pour RDP. Vous pouvez spécifier une liste de ports ou d'intervalles de ports séparés par des virgules. Utilisez un tiret entre deux numéros de port pour spécifier un intervalle. Le serveur VRDE se liera à l'un des ports disponibles de la liste spécifiée. Une seule machine peut utiliser un port donné à la fois. Par exemple, l'option --vrdeport 5000,5010-5012 indiquera au serveur de se lier à l'un des ports suivants: 5000, 5010, 5011 ou 5012. |
| --vrdeaddress IP-address |
Ce paramètre permet d'indiquer l'adresse IP de l'interface réseau hôte à laquelle le serveur VRDE se liera. Si spécifié, le serveur n'acceptera les connexions que sur l'interface réseau hôte spécifiée.
Le paramètre peut être utilisé pour spécifier si le serveur VRDP doit accepter IPv4, IPv6 ou les deux connexions : |
| Uniquement IPv4 |
--vrdeaddress "0.0.0.0" |
| Uniquement IPv6 |
--vrdeaddress "::" |
| IPv6 et IPv4 |
--vrdeaddress "" |
| --vrdeauthtype null|external|guest |
Ce paramètre permet d'indiquer l'utilisation de l'autorisation et de spécifier comment l'autorisation sera effectuée. |
| --vrdeauthlibrary default|name |
Ce paramètre permet d'indiquer la bibliothèque utilisée pour l'authentification RDP. |
| --vrdemulticon on|off |
Ce paramètre permet d'établir plusieurs connexions au même serveur VRDE, si le serveur prend en charge cette fonctionnalité. |
| --vrdereusecon on|off |
Ce paramètre permet d'indiquer le comportement du serveur VRDE lorsque plusieurs connexions sont désactivées. Lorsque cette option est activée, le serveur autorisera un nouveau client à se connecter et supprimera la connexion existante. Lorsque cette option est désactivée, paramètre par défaut, une nouvelle connexion ne sera pas acceptée s'il existe déjà un client connecté au serveur. |
| --vrdevideochannel on|off |
Ce paramètre permet d'activer la redirection vidéo, si elle est prise en charge par le serveur VRDE. |
| --vrdevideochannelquality percent |
Ce paramètre permet d'indiquer la qualité d'image pour la redirection vidéo. |
| --teleporter on|off |
Ce paramètre permet d'activer et désactiver la fonction de téléporteur par laquelle lorsque la machine est démarrée, elle attend de recevoir une demande de téléportation du réseau au lieu de démarrer normalement. |
| --teleporterport port |
Ce paramètre permet d'indiquer le port que la machine virtuelle doit écouter pour recevoir une demande de téléportation envoyée depuis une autre machine virtuelle. Le paramètre port peut être n'importe quel numéro de port TCP/IP libre, tel que 6000. |
| --teleporteraddress address |
Ce paramètre permet d'indiquer l'adresse que la machine virtuelle doit écouter pour recevoir une demande de téléportation envoyée depuis une autre machine virtuelle. Le paramètre address peut être n'importe quelle adresse IP ou nom d'hôte et spécifie le socket TCP/IP auquel se connecter. La valeur par défaut est 0.0.0.0, ce qui signifie n'importe quelle adresse. |
| --teleporterpassword password |
Ce paramètre permet d'indiquer le mot de passe de téléportation. Si ce paramètre facultatif est utilisé, la demande de téléportation ne réussira que si la machine source spécifie le même mot de passe que celui donné avec cette commande. |
| --teleporterpasswordfile password |
Ce paramètre permet d'indiquer le fichier de mot de passe de téléportation. Si ce paramètre facultatif est utilisé, la demande de téléportation ne réussira que si la machine source spécifie le même mot de passe que celui spécifié dans le fichier donné avec cette commande. Utilisez stdin pour lire le mot de passe depuis stdin. |
| --cpuid leaf eax ebx ecx edx |
Ce paramètre permet d'indiquer les valeurs de l'instruction CPUID. Les utilisateurs avancés peuvent utiliser ce paramètre avant une opération de téléportation, pour restreindre les capacités du processeur virtuel que VirtualBox présente au système d'exploitation invité. Cela doit être exécuté à la fois sur les machines source et cible impliquées dans la téléportation et modifiera alors ce que l'invité voit lorsqu'il exécute l'instruction machine CPUID. Il peut aider les applications se comportant mal supposant à tort que certaines capacités du processeur sont présentes. La signification des paramètres dépend du matériel. |
| --tracing-enabled on|off |
Ce paramètre permet d'activer le tracebuffer. Il consomme de la mémoire pour le tampon de trace et ajoute une surcharge supplémentaire. |
| --tracing-config config-string |
Ce paramètre permet d'activer la configuration du traçage. En particulier, cela définit quel groupe de points de trace est activé. |
| --tracing-allow-vm-access on|off |
Ce paramètre permet d'activer et de désactiver l'accès de la machine virtuelle au tampon de trace. Par défaut, ce paramètre est désactivé. |
| --usbcardreader on|off |
Ce paramètre permet d'activer et de désactiver l'interface du lecteur de carte USB. |
| --autostart-enabled on|off |
Ce paramètre permet d'activer et désactiver le démarrage automatique de la machine virtuelle au démarrage du système hôte, en utilisant le nom d'utilisateur spécifié. |
| --autostart-delay seconds |
Ce paramètre permet d'indiquer un délai, en secondes, après le démarrage du système hôte, avant le démarrage automatique de la machine virtuelle. |
Cette commande permet de modifier les propriétés d'une machine virtuel enregistré laquelle n'est pas exécuté.