diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 14:19:18 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 14:19:18 +0000 |
| commit | 4035b1bfb1e5843a539a8b624d21952b756974d1 (patch) | |
| tree | f1e9cd5bf548cbc57ff2fddfb2b4aa9ae95587e2 /doc/manual/en_US/man_VBoxManage-modifyvm.xml | |
| parent | Initial commit. (diff) | |
| download | virtualbox-4035b1bfb1e5843a539a8b624d21952b756974d1.tar.xz virtualbox-4035b1bfb1e5843a539a8b624d21952b756974d1.zip | |
Adding upstream version 6.1.22-dfsg.upstream/6.1.22-dfsgupstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'doc/manual/en_US/man_VBoxManage-modifyvm.xml')
| -rw-r--r-- | doc/manual/en_US/man_VBoxManage-modifyvm.xml | 2484 |
1 files changed, 2484 insertions, 0 deletions
diff --git a/doc/manual/en_US/man_VBoxManage-modifyvm.xml b/doc/manual/en_US/man_VBoxManage-modifyvm.xml new file mode 100644 index 00000000..322dcf44 --- /dev/null +++ b/doc/manual/en_US/man_VBoxManage-modifyvm.xml @@ -0,0 +1,2484 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + manpage, user manual, usage: VBoxManage modifyvm + + Copyright (C) 2006-2020 Oracle Corporation + + This file is part of VirtualBox Open Source Edition (OSE), as + available from http://www.virtualbox.org. This file is free software; + you can redistribute it and/or modify it under the terms of the GNU + General Public License (GPL) as published by the Free Software + Foundation, in version 2 as it comes in the "COPYING" file of the + VirtualBox OSE distribution. VirtualBox OSE is distributed in the + hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. + --> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[ +<!ENTITY % all.entities SYSTEM "all-entities.ent"> +%all.entities; +]> +<refentry id="vboxmanage-modifyvm" lang="en"> + <refentryinfo> + <pubdate>September 2019</pubdate> + <title>VBoxManage modifyvm</title> + </refentryinfo> + + <refmeta> + <refentrytitle>VBoxManage-modifyvm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>VBoxManage-modifyvm</refname> + <refpurpose>Change settings for a virtual machine that is stopped</refpurpose> + <refclass>Oracle VM VirtualBox</refclass> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-general"> +<!-- The 'id' is mandatory and must start with 'synopsis-'. --> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>vmname</replaceable></arg> + </group> + <arg>--name=<replaceable>name</replaceable></arg> + <arg>--groups= <arg choice="plain"><replaceable>group</replaceable> [,<replaceable>group</replaceable>...]</arg></arg> + <arg>--description=<replaceable>description</replaceable></arg> + <arg>--ostype=<replaceable>OS-type</replaceable></arg> + <arg>--iconfile=<replaceable>filename</replaceable></arg> + <arg>--memory=<replaceable>size-in-MB</replaceable></arg> + <arg>--pagefusion=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vram=<replaceable>size-in-MB</replaceable></arg> + <arg>--acpi=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--pciattach=<replaceable>host-PCI-address</replaceable></arg> + <arg>--pcidetach=<replaceable>host-PCI-address</replaceable></arg> + <arg>--ioapic=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--hardwareuuid=<replaceable>UUID</replaceable></arg> + <arg>--cpus=<replaceable>CPU-count</replaceable></arg> + <arg>--cpuhotplug=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--plugcpu=<replaceable>CPU-ID</replaceable></arg> + <arg>--unplugcpu=<replaceable>CPU-ID</replaceable></arg> + <arg>--cpuexecutioncap=<replaceable>number</replaceable></arg> + <arg>--pae=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--longmode=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--ibpb-on-vm-exit=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--ibpb-on-vm-entry=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--spec-ctrl=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--l1d-flush-on-sched=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--l1d-flush-on-vm-entry=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--mds-clear-on-sched=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--mds-clear-on-vm-entry=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--cpu-profile=<group choice="plain"> + <arg choice="plain">host</arg> + <arg choice="plain">Intel 8086</arg> + <arg choice="plain">Intel 80286</arg> + <arg choice="plain">Intel 80386</arg> + </group></arg> + <arg>--hpet=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--hwvirtex=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--triplefaultreset=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--apic=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--x2apic=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--paravirtprovider=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">default</arg> + <arg choice="plain">legacy</arg> + <arg choice="plain">minimal</arg> + <arg choice="plain">hyperv</arg> + <arg choice="plain">kvm</arg> + </group></arg> + <arg>--paravirtdebug= <arg choice="plain"><replaceable>key</replaceable>=<replaceable>value</replaceable> [,<replaceable>key</replaceable>=<replaceable>value</replaceable>...]</arg></arg> + <arg>--nestedpaging=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--largepages=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vtxvpid=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vtxux=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--accelerate3d=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--accelerate2dvideo=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--chipset=<group choice="plain"> + <arg choice="plain">ich9</arg> + <arg choice="plain">piix3</arg> + </group></arg> + <arg>--bioslogofadein=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--bioslogofadeout=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--bioslogodisplaytime=<replaceable>msec</replaceable></arg> + <arg>--bioslogoimagepath=<replaceable>pathname</replaceable></arg> + <arg>--biosbootmenu=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">menuonly</arg> + <arg choice="plain">messageandmenu</arg> + </group></arg> + <arg>--biosapic=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">apic</arg> + <arg choice="plain">x2apic</arg> + </group></arg> + <arg>--biossystemtimeoffset=<replaceable>msec</replaceable></arg> + <arg>--biospxedebug=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--system-uuid-le=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--boot<replaceable>X</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">floppy</arg> + <arg choice="plain">dvd</arg> + <arg choice="plain">disk</arg> + <arg choice="plain">net</arg> + </group></arg> + <arg>--rtcuseutc=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--graphicscontroller=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">vboxvga</arg> + <arg choice="plain">vmsvga</arg> + <arg choice="plain">vboxsvga</arg> + </group></arg> + <arg>--snapshotfolder=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>pathname</replaceable></arg> + </group></arg> + <arg>--firmware=<group choice="plain"> + <arg choice="plain">bios</arg> + <arg choice="plain">efi</arg> + <arg choice="plain">efi32</arg> + <arg choice="plain">efi64</arg> + </group></arg> + <arg>--guestmemoryballoon=<replaceable>size-in-MB</replaceable></arg> + <arg>--defaultfrontend=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>name</replaceable></arg> + </group></arg> + <arg>--nested-hw-virt=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vm-process-priority=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain">flat</arg> + <arg choice="plain">low</arg> + <arg choice="plain">normal</arg> + <arg choice="plain">high</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-networking"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>vmname</replaceable></arg> + </group> + <arg>--nic<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">null</arg> + <arg choice="plain">nat</arg> + <arg choice="plain">bridged</arg> + <arg choice="plain">intnet</arg> + <arg choice="plain">hostonly</arg> + <arg choice="plain">generic</arg> + <arg choice="plain">natnetwork</arg> + </group></arg> + <arg>--nictype<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">Am79C970A</arg> + <arg choice="plain">Am79C973</arg> + <arg choice="plain">82540EM</arg> + <arg choice="plain">82543GC</arg> + <arg choice="plain">82545EM</arg> + <arg choice="plain">virtio</arg> + </group></arg> + <arg>--cableconnected<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nictrace<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--nictracefile<replaceable>N</replaceable>=<replaceable>filename</replaceable></arg> + <arg>--nicproperty<replaceable>N</replaceable>=<replaceable>name</replaceable>= <arg><replaceable>value</replaceable></arg></arg> + <arg>--nicspeed<replaceable>N</replaceable>=<replaceable>kbps</replaceable></arg> + <arg>--nicbootprio<replaceable>N</replaceable>=<replaceable>priority</replaceable></arg> + <arg>--nicpromisc<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">deny</arg> + <arg choice="plain">allow-vms</arg> + <arg choice="plain">allow-all</arg> + </group></arg> + <arg>--nicbandwidthgroup<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain"><replaceable>name</replaceable></arg> + </group></arg> + <arg>--bridgeadapter<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain"><replaceable>device-name</replaceable></arg> + </group></arg> + <arg>--hostonlyadapter<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain"><replaceable>device-name</replaceable></arg> + </group></arg> + <arg>--intnet<replaceable>N</replaceable>=<replaceable>network-name</replaceable></arg> + <arg>--nat-network<replaceable>N</replaceable>=<replaceable>network-name</replaceable></arg> + <arg>--nicgenericdrv<replaceable>N</replaceable>=<replaceable>driver-name</replaceable></arg> + <arg>--macaddress<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">auto</arg> + <arg choice="plain"><replaceable>MAC-address</replaceable></arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-networking-nat"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>vmname</replaceable></arg> + </group> + <arg>--natnet<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain"><replaceable>network</replaceable></arg> + <arg choice="plain">default</arg> + </group></arg> + <arg>--natpf<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">[<replaceable>rule-name</replaceable>],tcp</arg> + <arg choice="plain">udp,[<replaceable>host-IP</replaceable>],<replaceable>hostport</replaceable>,[<replaceable>guest-IP</replaceable>],<replaceable>guestport</replaceable></arg> + </group></arg> + <arg>--natpf<replaceable>N</replaceable>=delete=<replaceable>rule-name</replaceable></arg> + <arg>--nattftpprefix<replaceable>N</replaceable>=<replaceable>prefix</replaceable></arg> + <arg>--nattftpfile<replaceable>N</replaceable>=<replaceable>filename</replaceable></arg> + <arg>--nattftpserver<replaceable>N</replaceable>=<replaceable>IP-address</replaceable></arg> + <arg>--natbindip<replaceable>N</replaceable>=<replaceable>IP-address</replaceable></arg> + <arg>--natdnspassdomain<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--natdnsproxy<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--natdnshostresolver<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--natsettings<replaceable>N</replaceable>=[<replaceable>mtu</replaceable>],[<replaceable>socksnd</replaceable>],[<replaceable>sockrcv</replaceable>],[<replaceable>tcpsnd</replaceable>],[<replaceable>tcprcv</replaceable>]</arg> + <arg>--nataliasmode<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain">[log],[proxyonly],[sameports]</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-other-hardware"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>vmname</replaceable></arg> + </group> + <arg>--mouse=<group choice="plain"> + <arg choice="plain">ps2</arg> + <arg choice="plain">usb</arg> + <arg choice="plain">usbtablet</arg> + <arg choice="plain">usbmultitouch</arg> + </group></arg> + <arg>--keyboard=<group choice="plain"> + <arg choice="plain">ps2</arg> + <arg choice="plain">usb</arg> + </group></arg> + <arg>--uart<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">off</arg> + <arg choice="plain"><replaceable>IO-base</replaceable> <replaceable>IRQ</replaceable></arg> + </group></arg> + <arg>--uartmode<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">disconnected</arg> + <arg choice="plain">server <replaceable>pipe</replaceable></arg> + <arg choice="plain">client <replaceable>pipe</replaceable></arg> + <arg choice="plain">tcpserver <replaceable>port</replaceable></arg> + <arg choice="plain">tcpclient <replaceable>hostname</replaceable>:<replaceable>port</replaceable></arg> + <arg choice="plain">file <replaceable>filename</replaceable></arg> + <arg choice="plain"><replaceable>device-name</replaceable></arg> + </group></arg> + <arg>--uarttype<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">16450</arg> + <arg choice="plain">16550A</arg> + <arg choice="plain">16750</arg> + </group></arg> + <arg>--lptmode<replaceable>N</replaceable>=<replaceable>device-name</replaceable></arg> + <arg>--lpt<replaceable>N</replaceable>=<group choice="plain"> + <arg choice="plain">off</arg> + <arg choice="plain"><replaceable>IO-base</replaceable> <replaceable>IRQ</replaceable></arg> + </group></arg> + <arg>--audio=<group choice="plain"> + <arg choice="plain">none</arg> + <arg choice="plain">null</arg> + <arg choice="plain">dsound</arg> + <arg choice="plain">oss</arg> + <arg choice="plain">alsa</arg> + <arg choice="plain">pulse</arg> + <arg choice="plain">coreaudio</arg> + </group></arg> + <arg>--audiocontroller=<group choice="plain"> + <arg choice="plain">ac97</arg> + <arg choice="plain">hda</arg> + <arg choice="plain">sb16</arg> + </group></arg> + <arg>--audiocodec=<group choice="plain"> + <arg choice="plain">stac9700</arg> + <arg choice="plain">ad1980</arg> + <arg choice="plain">stac9221</arg> + <arg choice="plain">sb16</arg> + </group></arg> + <arg>--audioin=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--audioout=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--clipboard=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">hosttoguest</arg> + <arg choice="plain">guesttohost</arg> + <arg choice="plain">bidirectional</arg> + </group></arg> + <arg>--draganddrop=<group choice="plain"> + <arg choice="plain">disabled</arg> + <arg choice="plain">hosttoguest</arg> + <arg choice="plain">guesttohost</arg> + <arg choice="plain">bidirectional</arg> + </group></arg> + <arg>--monitorcount=<replaceable>number</replaceable></arg> + <arg>--usbehci=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--usbohci=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--usbxhci=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--usbrename=<replaceable>old-name</replaceable> <replaceable>new-name</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-recording"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>vmname</replaceable></arg> + </group> + <arg>--recording=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--recordingscreens=<group choice="plain"> + <arg choice="plain">all</arg> + <arg choice="plain"><replaceable>screen-ID</replaceable> [<replaceable>screen-ID</replaceable>...]</arg> + </group></arg> + <arg>--recordingfile=<replaceable>filename</replaceable></arg> + <arg>--recordingmaxsize=<replaceable>MB</replaceable></arg> + <arg>--recordingmaxtime=<replaceable>msec</replaceable></arg> + <arg>--recordingopts= <arg choice="plain"><replaceable>key</replaceable>=<replaceable>value</replaceable> [,<replaceable>key</replaceable>=<replaceable>value</replaceable>...]</arg></arg> + <arg>--recordingvideofps=<replaceable>fps</replaceable></arg> + <arg>--recordingvideorate=<replaceable>rate</replaceable></arg> + <arg>--recordingvideores=<replaceable>width</replaceable> <replaceable>height</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-vrde"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>vmname</replaceable></arg> + </group> + <arg>--vrde=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrdeproperty=<replaceable>property-name</replaceable>= <arg><replaceable>property-value</replaceable></arg></arg> + <arg>--vrdeextpack=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>name</replaceable></arg> + </group></arg> + <arg>--vrdeport=<replaceable>port</replaceable></arg> + <arg>--vrdeaddress=<replaceable>hostip</replaceable></arg> + <arg>--vrdeauthtype=<group choice="plain"> + <arg choice="plain">null</arg> + <arg choice="plain">external</arg> + <arg choice="plain">guest</arg> + </group></arg> + <arg>--vrdeauthlibrary=<group choice="plain"> + <arg choice="plain">default</arg> + <arg choice="plain"><replaceable>name</replaceable></arg> + </group></arg> + <arg>--vrdemulticon=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrdereusecon=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrdevideochannel=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--vrdevideochannelquality=<replaceable>percent</replaceable></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-teleport"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>vmname</replaceable></arg> + </group> + <arg>--teleporter=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--teleporterport=<replaceable>port</replaceable></arg> + <arg>--teleporteraddress=<group choice="plain"> + <arg choice="plain"><replaceable>address</replaceable></arg> + <arg choice="plain">empty</arg> + </group></arg> + <arg>--teleporterpassword=<replaceable>password</replaceable></arg> + <arg>--teleporterpasswordfile=<group choice="plain"> + <arg choice="plain"><replaceable>filename</replaceable></arg> + <arg choice="plain">stdin</arg> + </group></arg> + <arg>--cpuid-portability-level=<replaceable>level</replaceable></arg> + <arg>--cpuid-set=<replaceable>leaf</replaceable> <arg>:<replaceable>subleaf</replaceable></arg> <replaceable>eax</replaceable> <replaceable>ebx</replaceable> <replaceable>ecx</replaceable> <replaceable>edx</replaceable></arg> + <arg>--cpuid-remove=<replaceable>leaf</replaceable> <arg>:<replaceable>subleaf</replaceable></arg></arg> + <arg>--cpuidremoveall</arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-debugging"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>vmname</replaceable></arg> + </group> + <arg>--tracing-enabled=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--tracing-config=<replaceable>string</replaceable></arg> + <arg>--tracing-allow-vm-access=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-usbcardreader"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>vmname</replaceable></arg> + </group> + <arg>--usbcardreader=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + </cmdsynopsis> + + <cmdsynopsis id="synopsis-vboxmanage-modifyvm-autostart"> + <command>VBoxManage modifyvm</command> + <group choice="req"> + <arg choice="plain"><replaceable>uuid</replaceable></arg> + <arg choice="plain"><replaceable>vmname</replaceable></arg> + </group> + <arg>--autostart-enabled=<group choice="plain"> + <arg choice="plain">on</arg> + <arg choice="plain">off</arg> + </group></arg> + <arg>--autostart-delay=<replaceable>seconds</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Description</title> + <para> + The <command>VBoxManage modifyvm</command> command enables you to + change the properties of a registered virtual machine (VM) that is + not running. + </para> + <para> + Most of these properties correspond to the VM settings that are + shown in each VM's <emphasis role="bold">Settings</emphasis> + dialog in the VirtualBox Manager. See + <xref linkend="BasicConcepts" />. However, some settings can only + be viewed and managed with the <command>VBoxManage</command> + command. + </para> + <para> + You can use the <command>VBoxManage modifyvm</command> command to + change VM settings only when the VM is powered off. The VM cannot + be running or in saved state when you use this command. + </para> + <para> + You can use the <command>VBoxManage controlvm</command> command to + dynamically change some VM machine settings while the VM is + running. See <xref linkend="vboxmanage-controlvm" />. + </para> + <refsect2 id="vboxmanage-modifyvm-general"> + <title>General Settings</title> + <remark role="help-copy-synopsis"/> + <para> + The following options enable you to modify general information + about your VM. + </para> + <para> + The <command>VBoxManage modifyvm</command> command supports the + following options: + </para> + <variablelist> + <varlistentry> + <term><option>--name=<replaceable>vmname</replaceable></option></term> + <listitem><para> + Changes the name of the VM and its related internal VM + files. See <xref linkend="vboxmanage-createvm"/>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--groups=<replaceable>group</replaceable></option></term> + <listitem><para> + Changes the group membership of a VM. Group names always + begin with a slash character (<literal>/</literal>) and + can be nested. By default, VMs are members of the + <literal>/</literal> group. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--description=<replaceable>desc</replaceable></option></term> + <listitem><para> + Changes the optional VM description. Use a description to + record details about the VM in a meaningful way. The GUI + interprets HTML markup while the <command>VBoxManage + modifyvm</command> command enables you include arbitrary + strings that can contain multiple lines. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ostype=<replaceable>OS-type</replaceable></option></term> + <listitem><para> + Specifies the guest operating system (OS) to run in the + VM. Use the <command>VBoxManage list ostypes</command> + command to view the OS type identifiers. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--iconfile=<replaceable>filename</replaceable></option></term> + <listitem><para> + Specifies the absolute path to the &product-name; icon on + the host system. The icon is shown on the VM. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--memory=<replaceable>size</replaceable></option></term> + <listitem><para> + Specifies the amount of host system RAM to allocate to the + VM. The size is in MB. See + <xref linkend="gui-createvm" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--pagefusion=on | off</option></term> + <listitem><para> + Enables or disables the Page Fusion feature, which is + disabled by default. Use the Page Fusion feature to + minimize the memory duplication between VMs that have + similar configurations and that run on the same host + system. See <xref linkend="guestadd-pagefusion" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vram=<replaceable>size</replaceable></option></term> + <listitem><para> + Specifies the amount of RAM to allocate to the virtual + graphics card. See <xref linkend="settings-display" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--acpi=on | off</option></term> + <listitem><para> + Determines whether the VM has ACPI support. See + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ioapic=on | off</option></term> + <listitem><para> + Determines whether the VM has I/O APIC support. See + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--pciattach=<replaceable>host-PCI-address</replaceable>[@<replaceable>guest-PCI-host-bus-address</replaceable>]</option></term> + <listitem><para> + Attaches the specified PCI network controller on the host + to the guest VM. You can optionally specify the PCI bus on + the guest VM on which to attach the controller. See + <xref linkend="pcipassthrough" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--pcidetach=<replaceable>host-PCI-address</replaceable></option></term> + <listitem><para> + Detaches the specified PCI network controller from the + attached PCI bus on the guest VM. See + <xref linkend="pcipassthrough" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hardwareuuid=<replaceable>uuid</replaceable></option></term> + <listitem><para> + Specifies the Universally Unique Identifier (UUID) to + present to the guest VM in memory tables (DMI/SMBIOS), + hardware, and VM properties. By default this hardware UUID + is the same as the VM UUID. Use this option when cloning a + VM. Note that the teleporting feature automatically + handles the UUID value. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpus=<replaceable>CPU-count</replaceable></option></term> + <listitem><para> + Specifies the number of virtual CPUs to assign to the VM. + See <xref linkend="settings-processor" />. + </para><para> + If CPU hot-plugging is enabled, this option specifies the + maximum number of virtual CPUs that can be plugged into + the VMs. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuhotplug=on | off</option></term> + <listitem><para> + Enables or disables CPU hot-plugging. When enabled, you + can dynamically add virtual CPUs to a VM or remove virtual + CPUs from a VM. See <xref linkend="cpuhotplug" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--plugcpu=<replaceable>CPU-ID</replaceable></option></term> + <listitem><para> + Adds a virtual CPU to the VM. + <replaceable>CPU-ID</replaceable> is the index of the + virtual CPU to add. A valid index value is a number from + <literal>0</literal> to the maximum number of CPUs that + you configured by using the <option>--cpus</option> + option. + </para><para> + Only use this option if CPU hot-plugging is enabled. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--unplugcpu=<replaceable>CPU-ID</replaceable></option></term> + <listitem><para> + Removes a virtual CPU from the VM. + <replaceable>CPU-ID</replaceable> is the index of the + virtual CPU to remove. A valid index value is a number + from <literal>1</literal> to the maximum number of CPUs + that you configured by using the <option>--cpus</option> + option. + </para><para> + Only use this option if CPU hot-plugging is enabled. + </para><para> + Note that you cannot remove CPU 0. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuexectioncap=<replaceable>percentage</replaceable></option></term> + <listitem><para> + Specifies how much CPU time a virtual CPU can use. A valid + value is from <literal>1</literal> to + <literal>100</literal>. A value of 50 indicates that a + single virtual CPU can use up to 50% of a single host CPU. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--pae=on | off</option></term> + <listitem><para> + Enables or disables physical address extension (PAE). See + <xref linkend="settings-processor" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--longmode=on | off</option></term> + <listitem><para> + Enables or disables long mode. See + <xref linkend="settings-processor" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ibpb-on-vm-exit=on | off</option></term> + <listitem><para> + Enables use of Indirect Branch Prediction Barrier (IBPB) + on every VM exit. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--ibpb-on-vm-entry=on | off</option></term> + <listitem><para> + Enables use of Indirect Branch Prediction Barrier (IBPB) + on every VM entry. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--spec-ctrl=on | off</option></term> + <listitem><para> + Enables or disables the exposure of speculation control + interfaces to the guest VM. These interfaces must be + available on the host system. + </para><para> + Depending on the host CPU and the workload, enabling + speculation control might significantly reduce + performance. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--l1d-flush-on-sched=on | off</option></term> + <listitem><para> + Enables or disables level 1 data cache flushing when a + thread is scheduled to execute guest code. See + <xref linkend="sec-rec-cve-2018-3646" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--l1d-flush-on-vm-entry=on | off</option></term> + <listitem><para> + Enables or disables level 1 data cache flushing on every + VM entry. See <xref linkend="sec-rec-cve-2018-3646" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--mds-clear-on-sched=on | off</option></term> + <listitem><para> + Enables CPU buffer clearing when a thread is scheduled to + execute guest code. See + <xref linkend="sec-rec-cve-2018-12126-et-al" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--mds-clear-on-vm-entry=on | off</option></term> + <listitem><para> + Enables CPU buffer clearing on every VM entry. See + <xref linkend="sec-rec-cve-2018-12126-et-al" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpu-profile=host | Intel 8086 | Intel 80286 | Intel 80386</option></term> + <listitem><para> + Specifies the profile to use for guest CPU emulation. + Specify a value that is based on the host system CPU + (<literal>host</literal>) or one of the following older + Intel micro-architectures: <literal>8086</literal>, + <literal>80286</literal>, or <literal>80386</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hpet=on | off</option></term> + <listitem><para> + Enables or disables a High Precision Event Timer (HPET) + that can replace a legacy system timer. This feature is + disabled by default. Note HPET is supported on Windows + versions starting with Vista. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hwvirtex=on | off</option></term> + <listitem><para> + Enables or disables the use of hardware virtualization + extensions in the processor of the host system. Such + extensions are Intel VT-x or AMD-V. See + <xref linkend="hwvirt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--triplefaultreset=on | off</option></term> + <listitem><para> + Enables or disables the resetting of the guest VM instead + of triggering a Guru Meditation. Some guest VMs raise a + triple fault to reset the CPU, so sometimes resetting the + guest VM is the best outcome. This option only applies to + guests that do not use symmetric multiprocessing (SMP). + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--apic=on | off</option></term> + <listitem><para> + Enables or disables I/O APIC. With I/O APIC, OSes can use + more than 16 interrupt requests (IRQs) to avoid IRQ + sharing and to improve reliability. I/O APIC is enabled by + default. See <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--x2apic=on | off</option></term> + <listitem><para> + Enables or disables the CPU x2APIC feature. CPU x2APIC + enables an OS to run more efficiently on high core count + configurations and to optimize interrupt distribution in + virtualized environments. This feature is enabled by + default. + </para><para> + Disable this feature when the OS that runs on a host + system or a guest VM is incompatible with CPU x2APIC. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--paravirtprovider=none | default | legacy | minimal | hyperv | kvm</option></term> + <listitem><para> + Specifies one of the following paravirtualization + interfaces to provide to the guest OS: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> does not expose any + paravirtualization interface. + </para></listitem> + <listitem><para> + <literal>default</literal> selects the appropriate + interface based on the guest OS type when starting the + VM. This is the default value used when creating new + VMs. + </para></listitem> + <listitem><para> + <literal>legacy</literal> selects a paravirtual + interface for VMs that were created by older + &product-name; versions. + </para></listitem> + <listitem><para> + <literal>minimal</literal> is required for Mac OS X + guest VMs. + </para></listitem> + <listitem><para> + <literal>kvm</literal> is recommended for Linux guest + VMs. See <xref linkend="gimproviders" />. + </para></listitem> + <listitem><para> + <literal>hyperv</literal> is recommended for Windows + guest VMs. See <xref linkend="gimproviders" />. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--paravirtdebug=<replaceable>property</replaceable>=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies debugging properties that are specific to the + paravirtualization provider configured for the specified + VM. See <xref linkend="gimdebug" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nestedpaging=on | off</option></term> + <listitem><para> + Enables or disables the nested paging feature in the + processor of the host system. This option is available + only when hardware virtualization is enabled. See + <xref linkend="hwvirt" /> and + <xref linkend="sec-rec-cve-2018-3646" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--largepages=on | off</option></term> + <listitem><para> + Enables or disables the hypervisor's use of large pages, + which can improve performance by up to 5%. The use of + large pages reduces TLB use and overhead. This option is + available only when both hardware virtualization and + nested paging are enabled. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vtxvpid=on | off</option></term> + <listitem><para> + Enables or disables the use of the tagged TLB (VPID) + feature in the processor of your host system. See + <xref linkend="hwvirt" />. This option is available only + when hardware virtualization is enabled on Intel VT-x. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vtxux=on | off</option></term> + <listitem><para> + Enables or disables the use of unrestricted guest mode for + executing the guest VM. This option is available only when + hardware virtualization is enabled on Intel VT-x. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--accelerated3d=on | off</option></term> + <listitem><para> + Enables or disables hardware 3D acceleration. This option + is available only when the Guest Additions are installed. + See <xref linkend="guestadd-3d" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--accelerated2dvideo=on | off</option></term> + <listitem><para> + Enables or disables 2D video acceleration. This option is + available only when the Guest Additions are installed. See + <xref linkend="guestadd-2d" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--chipset=piix3 | ich9</option></term> + <listitem><para> + Specify the Intel chipset for &product-name; to emulate. + The default value is the Intel PIIX3 chipset + (<literal>piix3</literal>). + </para><para> + Change this value only if you need to relax some of the + chipset constraints. See + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bioslogofacein=on | off</option></term> + <listitem><para> + Specifies whether the BIOS logo fades in on VM startup. By + default, an &product-name; logo is shown. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bioslogofacein=on | off</option></term> + <listitem><para> + Specifies whether the BIOS logo fades out on VM startup. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bioslogodisplaytime=<replaceable>msec</replaceable></option></term> + <listitem><para> + Specifies the amount of time in milliseconds that the BIOS + logo is visible. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bioslogoimagepath=<replaceable>pathname</replaceable></option></term> + <listitem><para> + Replaces the existing BIOS logo with a different image. + The replacement image must be an uncompressed 256-color + bitmap file (BMP) that does not contain color space + information (Windows 3.0 format). Also ensure that the + image is no larger than 640 X 480 pixels. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--biosbootmenu=disabled | menuonly | messageandmenu</option></term> + <listitem><para> + Specifies whether the BIOS permits you to select a + temporary boot device. Valid values are: + </para><itemizedlist> + <listitem><para> + <literal>disabled</literal> outputs the alternate boot + device message and permits you to select a temporary + boot device by pressing F12. + </para></listitem> + <listitem><para> + <literal>menuonly</literal> suppresses the alternate + boot device message, but permits you to select a + temporary boot device by pressing F12. + </para></listitem> + <listitem><para> + <literal>messageandmenu</literal> suppresses the + alternate boot device message and prevents you from + selecting a temporary boot device by pressing F12. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--biosapic=x2apic | apic | disabled</option></term> + <listitem><para> + Specifies the APIC level of the firmware. Valid values + are: <literal>x2apic</literal>, <literal>apic</literal>, + and <literal>disabled</literal>. When the value is + <literal>disabled</literal>, neither the + <literal>apic</literal> nor the <literal>x2apic</literal> + version of the firmware is used. + </para><para> + Note that if you specify the <literal>x2apic</literal> + value and x2APIC is unsupported by the virtual CPU, the + APIC level downgrades to <literal>apic</literal>, if + supported. Otherwise, the APIC level downgrades to + <literal>disabled</literal>. Similarly, if you specify the + <literal>apic</literal> value and APIC is unsupported by + the virtual CPU, the APIC level downgrades to + <literal>disabled</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--biossystemtimeoffset=<replaceable>msec</replaceable></option></term> + <listitem><para> + Specifies the time offset in milliseconds of the guest VM + relative to the time on the host system. If the offset + value is positive, the guest VM time runs ahead of the + time on the host system. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--biospxedebug=on | off</option></term> + <listitem><para> + Enables or disables additional debugging output when using + the Intel PXE boot ROM. The debug output is written to the + release log file. See + <xref linkend="collect-debug-info" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--system-uuid-le=on | off</option></term> + <listitem><para> + Enables or disables representing the system UUID in little + endian form. The default value is <literal>on</literal> for + new VMs. For old VMs the setting is <literal>off</literal> to + keep the content of the DMI/SMBIOS table unchanged, which can + be important for Windows license activation. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--boot<replaceable>N</replaceable>=none | floppy | dvd | disk | net</option></term> + <listitem><para> + Enables you to specify the boot device order for the VM by + assigning one of the device types to each of the four boot + device slots that are represented by + <replaceable>N</replaceable> in the option name. + </para><para> + A value of 1 for <replaceable>N</replaceable> represents + the first boot device slot, and so on. + </para><para> + The device types are <literal>floppy</literal> for floppy + disks, <literal>dvd</literal> for DVDs or CDs, + <literal>disk</literal> for hard disks, and + <literal>net</literal> for a network device. A value of + <literal>none</literal> indicates that no boot device is + associated with the specified slot. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--rtcuseutc=on | off</option></term> + <listitem><para> + Specifies whether the real-time clock (RTC) uses + coordinated universal time (UTC). See + <xref linkend="settings-motherboard" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--graphicscontroller=none | vboxvga | vmsvga | vboxsvga</option></term> + <listitem><para> + Specifies the graphics controller type to use. See + <xref linkend="settings-screen" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--snapshotfolder=default | <replaceable>pathname</replaceable></option></term> + <listitem><para> + Specifies the name of the VM's snapshot storage folder. If + you specify <literal>default</literal>, the folder name is + <filename>Snapshots/</filename> in the machine folder. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--firmware=bios | efi | efi32 | efi64</option></term> + <listitem><para> + Specifies the firmware used to boot the VM. Valid values + are: <literal>bios</literal>, <literal>efi</literal>, + <literal>efi32</literal>, or <literal>efi64</literal>. Use + EFI values with care. + </para><para> + By default, BIOS firmware is used. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--guestmemoryballoon=<replaceable>size</replaceable></option></term> + <listitem><para> + Specifies the size of the guest memory balloon. The guest + memory balloon is the memory allocated by the Guest + Additions from the guest OS and returned to the hypervisor + for use by other VMs. Specify + <replaceable>size</replaceable> in megabytes. The default + value is <literal>0</literal> megabytes. See + <xref linkend="guestadd-balloon" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--defaultfrontend=default | <replaceable>name</replaceable></option></term> + <listitem><para> + Specifies the default frontend to use when starting the + specified VM. If you specify <literal>default</literal>, + the VM is shown in a window on the user's desktop. See + <xref linkend="vboxmanage-startvm" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nested-hw-virt=on | off</option></term> + <listitem><para> + Enables or disables nested virtualization. See + <xref linkend="nested-virt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vm-process-priority=default | flat | low | normal | high</option></term> + <listitem><para> + Specifies the priority scheme of the VM process to use + when starting the specified VM and while the VM runs. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-networking"> + <title>Networking Settings</title> + <remark role="help-copy-synopsis"/> + <para> + The following options enable you to modify networking on your + VM. With all these options, <replaceable>N</replaceable> is an + integer greater than zero that represents the particular virtual + network adapter to configure. + </para> + <variablelist> + <varlistentry> + <term><option>--nic<replaceable>N</replaceable>=none | null | nat | natnetwork | bridged | intnet | hostonly | generic</option></term> + <listitem><para> + Configures the network type used by each virtual network + card in the VM. + </para><para> + The following valid values correspond to the modes + described in <xref linkend="networkingmodes" />: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> – No networking present + </para></listitem> + <listitem><para> + <literal>null</literal> – Not connected to the + host system + </para></listitem> + <listitem><para> + <literal>nat</literal> – Use network address + translation (NAT) + </para></listitem> + <listitem><para> + <literal>natnetwork</literal> – Use a NAT + metwork + </para></listitem> + <listitem><para> + <literal>bridged</literal> – Use bridged + networking + </para></listitem> + <listitem><para> + <literal>intnet</literal> – Use internal + networking + </para></listitem> + <listitem><para> + <literal>hostonly</literal> – Use host-only + networking + </para></listitem> + <listitem><para> + <literal>generic</literal> – Access rarely used + sub-modes + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--nictype<replaceable>N</replaceable>=Am79C970A | Am79C973 | 82540EM | 82543GC | 82545EM | virtio</option></term> + <listitem><para> + Identifies the type of networking hardware that + &product-name; presents to the guest VM for the specified + virtual network card. See <xref linkend="nichardware" />. + </para><para> + Valid values are as follows: + </para><itemizedlist> + <listitem><para> + <literal>Am79C970A</literal> represents the AMD PCNet + PCI II. + </para></listitem> + <listitem><para> + <literal>Am79C973</literal> represents the AMD PCNet + FAST III, which is the default value. + </para></listitem> + <listitem><para> + <literal>82540EM</literal> represents the Intel + PRO/1000 MT Desktop. + </para></listitem> + <listitem><para> + <literal>82543GC</literal> represents the Intel + PRO/1000 T Server. + </para></listitem> + <listitem><para> + <literal>82545EM</literal> represents the Intel + PRO/1000 MT Server. + </para></listitem> + <listitem><para> + <literal>virtio</literal> represents a paravirtualized + network adapter. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--cableconnected<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Temporarily disconnects a virtual network interface, as if + you pull a network cable from a physical network card. You + might use this option to reset certain software components + in the VM. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nictrace<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Enables or disables network tracing for the specified + virtual network card. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nictracefile<replaceable>N</replaceable>=<replaceable>filename</replaceable></option></term> + <listitem><para> + Specifies the absolute path of the file in which to write + trace log information. Use this option if network tracing + is enabled. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nicproperty<replaceable>N</replaceable>=<replaceable>name</replaceable>=<replaceable>value</replaceable></option></term> + <listitem><para> + Enables you to set property values and pass them to rarely + used network backends. To use this option, you must also + use the <option>--nicgenericdrv</option> option. + </para><para> + These properties are specific to the backend engine and + differ between the UDP Tunnel and the VDE backend drivers. + For property examples, see + <xref linkend="network_udp_tunnel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nicspeed<replaceable>N</replaceable>=<replaceable>kbps</replaceable></option></term> + <listitem><para> + Specifies the throughput rate in kilobits per second for + rarely used networking sub-modes such as VDE network and + UDP Tunnel. Use this option only if you used the + <option>--nic</option> option to enable generic networking + for the specified virtual network card. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nicbootprio<replaceable>N</replaceable>=<replaceable>priority</replaceable></option></term> + <listitem><para> + Assigns a priority to each NIC that determines the order + in which that NIC is used to perform a PXE network boot. + The priority value is an integer in the range from + <literal>0</literal> to <literal>4</literal>. Priority + <literal>0</literal>, which is the default value, is the + lowest priority. Priority <literal>1</literal> is the + highest priority, and priorities <literal>3</literal> and + <literal>4</literal> are lower. + </para><para> + This option has an effect only when using the Intel PXE + boot ROM. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nicpromisc<replaceable>N</replaceable>=deny | allow-vms | allow-all</option></term> + <listitem><para> + Enables you to specify whether to deny or allow + promiscuous mode for the specified VM virtual network + card. This option is relevant only for bridged networking. + Valid values are as follows: + </para><itemizedlist> + <listitem><para> + <literal>deny</literal> hides any traffic that is not + intended for the VM. This is the default value. + </para></listitem> + <listitem><para> + <literal>allow-vms</literal> hides all host traffic + from the VM, but allows the VM to see traffic to and + from other VMs. + </para></listitem> + <listitem><para> + <literal>allow-all</literal> allows the VM to see all + traffic. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--nicbandwidthgroup<replaceable>N</replaceable>=none | <replaceable>name</replaceable></option></term> + <listitem><para> + Adds or removes a bandwidth group assignment to the + specified virtual network interface. Valid values are as + follows: + </para><itemizedlist> + <listitem><para> + <literal>none</literal> removes any current bandwidth + group assignment from the specified virtual network + interface. + </para></listitem> + <listitem><para> + <replaceable>name</replaceable> adds a bandwidth group + assignment to the specified virtual network interface. + </para></listitem> + </itemizedlist><para> + See <xref linkend="network_bandwidth_limit" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--bridgeadapter<replaceable>N</replaceable>=none | <replaceable>device-name</replaceable></option></term> + <listitem><para> + Specifies the host interface to use for the specified + virtual network interface. See + <xref linkend="network_bridged" />. Use this option only + if you used the <option>--nic</option> option to enable + bridged networking for the specified virtual network card. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--hostonlyadapter<replaceable>N</replaceable>=none | <replaceable>device-name</replaceable></option></term> + <listitem><para> + Specifies which host-only networking interface to use for + the specified virtual network interface. See + <xref linkend="network_hostonly" />. Use this option only + if you used the <option>--nic</option> option to enable + host-only networking for the specified virtual network + card. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--intnet<replaceable>N</replaceable>=<replaceable>network-name</replaceable></option></term> + <listitem><para> + Specifies the name of the internal network. See + <xref linkend="network_internal" />. Use this option only + if you used the <option>--nic</option> option to enable + internal networking for the specified virtual network + card. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nat-network<replaceable>N</replaceable>=<replaceable>network-name</replaceable></option></term> + <listitem><para> + Specifies the name of the NAT network to which this + adapter is connected. Use this option only if the + networking type is <literal>natnetwork</literal>, not + <literal>nat</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nicgenericdrv<replaceable>N</replaceable>=<replaceable>backend-driver</replaceable></option></term> + <listitem><para> + Enables you to access rarely used networking sub-modes, + such as VDE networks and UDP Tunnel. Use this option only + if you used the <option>--nic</option> option to enable + generic networking for a virtual network card. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--macaddress<replaceable>N</replaceable>=auto | <replaceable>MAC-address</replaceable></option></term> + <listitem><para> + Specifies the MAC address of the specified network adapter + on the VM. By default, &product-name; assigns a random MAC + address to each network adapter at VM creation. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-networking-nat"> + <title>NAT Networking Settings</title> + <remark role="help-copy-synopsis"/> + <para> + The following options use <replaceable>N</replaceable> to + specify the particular virtual network adapter to modify. + </para> + <variablelist> + <varlistentry> + <term><option>--natnet<replaceable>N</replaceable>=default | <replaceable>network</replaceable></option></term> + <listitem><para> + Specifies the IP address range to use for this network. + See <xref linkend="changenat" />. Use this option only if + the networking type is <literal>nat</literal>, not + <literal>natnetwork</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--natpf<replaceable>N</replaceable>=[<replaceable>name</replaceable>],tcp | udp,[<replaceable>host-IP</replaceable>],<replaceable>hostport</replaceable>,[<replaceable>guest-IP</replaceable>],<replaceable>guestport</replaceable></option></term> + <listitem><para> + Specifies the NAT port-forwarding rule to use. See + <xref linkend="natforward" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--natpf<replaceable>N</replaceable>=delete <replaceable>name</replaceable></option></term> + <listitem><para> + Specifies the NAT port-forwarding rule to delete. See + <xref linkend="natforward" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nattftpprefix<replaceable>N</replaceable>=<replaceable>prefix</replaceable></option></term> + <listitem><para> + Specifies a prefix to use for the built-in TFTP server. + For example, you might use a prefix to indicate where the + boot file is located. See <xref linkend="nat-tftp" /> and + <xref linkend="nat-adv-tftp" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nattftpfile<replaceable>N</replaceable>=<replaceable>boot-file</replaceable></option></term> + <listitem><para> + Specifies the name of the TFT boot file. See + <xref linkend="nat-adv-tftp" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nattftpserver<replaceable>N</replaceable>=<replaceable>tftp-server</replaceable></option></term> + <listitem><para> + Specifies the address of the TFTP server from which to + boot. See <xref linkend="nat-adv-tftp" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--natbindip<replaceable>N</replaceable>=<replaceable>IP-address</replaceable></option></term> + <listitem><para> + Specifies an alternate IP address to which the NAT engine + binds. See <xref linkend="nat-adv-settings" />. By + default, &product-name;'s NAT engine routes TCP/IP packets + through the default interface assigned by the host's + TCP/IP stack. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--natdnspassdomain<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Specifies whether the built-in DHCP server passes the + domain name for network name resolution. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--natdnsproxy<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Specifies whether the NAT engine is the proxy for all + guest DNS requests to the host system's DNS servers. See + <xref linkend="nat-adv-dns" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--natdnshostresolver<replaceable>N</replaceable>=on | off</option></term> + <listitem><para> + Specifies whether the NAT engine uses the host system's + resolver mechanisms to handle DNS requests. See + <xref linkend="nat-adv-dns" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--natsettings<replaceable>N</replaceable>=[<replaceable>mtu</replaceable>],[<replaceable>socksnd</replaceable>],[<replaceable>sockrcv</replaceable>],[<replaceable>tcpsnd</replaceable>],[<replaceable>tcprcv</replaceable>]</option></term> + <listitem><para> + Specifies values for tuning NAT performance. See + <xref linkend="nat-adv-settings" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--nataliasmode<replaceable>N</replaceable>=default | [log],[proxyonly],[sameports]</option></term> + <listitem><para> + Specifies the behavior of the NAT engine core as follows: + </para><itemizedlist> + <listitem><para> + <literal>log</literal> enables logging + </para></listitem> + <listitem><para> + <literal>proxyonly</literal> switches off aliasing + mode and makes NAT transparent + </para></listitem> + <listitem><para> + <literal>sameports</literal> enforces that the NAT + engine sends packets through the same port on which + they originated + </para></listitem> + <listitem><para> + <literal>default</literal> disables all aliasing modes + </para></listitem> + </itemizedlist><para> + For more information, see + <xref linkend="nat-adv-alias" />. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-other-hardware"> + <title>Other Hardware Settings</title> + <remark role="help-copy-synopsis"/> + <para> + The following options enable you to configure other hardware, + such as the serial port, monitor, audio device, USB ports, and + the clipboard, and drag-and-drop features. + </para> + <variablelist> + <varlistentry> + <term><option>--mouse=ps2 | usb | usbtablet | usbmultitouch</option></term> + <listitem><para> + Specifies the mode of the mouse to use in the VM. Valid + values are: <literal>ps2</literal>, + <literal>usb</literal>, <literal>usbtablet</literal>, and + <literal>usbmultitouch</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--keyboard=ps2 | usb</option></term> + <listitem><para> + Specifies the mode of the keyboard to use in the VM. Valid + values are: <literal>ps2</literal> and + <literal>usb</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--uart<replaceable>N</replaceable>=off | <replaceable>I/O-base</replaceable> <replaceable>IRQ</replaceable></option></term> + <listitem><para> + Configures virtual serial ports for the VM. + <replaceable>N</replaceable> represents the serial port to + modify. Valid values are <literal>off</literal> to disable + the port or an I/O base address and IRQ. For information + about the traditional COM port I/O base address and IRQ + values, see <xref linkend="serialports" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--uartmode<replaceable>N</replaceable>=<replaceable>mode</replaceable></option></term> + <listitem><para> + Specifies how &product-name; connects the specified + virtual serial port to the host system that runs the VM. + See <xref linkend="serialports" />. + </para><para> + Ensure that you first configure the virtual serial port by + using the + <option>--uart<replaceable>N</replaceable></option> + option. + </para><para> + Specify one of the following connection modes for each + port: + </para><itemizedlist> + <listitem><para> + <literal>disconnected</literal> indicates that even + though the serial port is shown to the guest VM, it is + not connected. This state is like a physical COM port + without a cable attached. + </para></listitem> + <listitem><para> + <literal>server</literal> + <replaceable>pipe-name</replaceable> creates the + specified named pipe or local domain socket on the + host system and connects the virtual serial device to + it. + </para><para> + On a Windows host system, + <replaceable>pipe-name</replaceable> is a named pipe + that has a name that uses the following form: + <literal>\\.\<replaceable>pipe</replaceable>\</literal>. + </para><para> + On a Linux host system, + <replaceable>pipe-name</replaceable> is a local domain + socket. + </para></listitem> + <listitem><para> + <literal>client</literal> + <replaceable>pipe-name</replaceable> connects the + virtual serial device to the specified named pipe or + local domain socket. + </para><para> + Note that the named pipe or local domain socket must + already exist. + </para></listitem> + <listitem><para> + <literal>tcpserver</literal> + <replaceable>port</replaceable> creates a TCP socket + with the specified TCP port on the host system and + connects the virtual serial device to it. + </para><para> + For UNIX-like systems, use ports over 1024 for + non-root users. + </para></listitem> + <listitem><para> + <literal>tcpclient</literal> + <replaceable>hostname</replaceable>:<replaceable>port</replaceable> + connects the virtual serial device to the TCP socket. + </para><para> + Note that the TCP socket must already exist. + </para></listitem> + <listitem><para> + <literal>file</literal> + <replaceable>filename</replaceable> redirects the + serial port output to the specified raw file. Ensure + that <replaceable>filename</replaceable> is the + absolute path of the on the host system. + </para></listitem> + <listitem><para> + <replaceable>device-name</replaceable>: specifies the + device name of a physical hardware serial port on the + specified host system to which the virtual serial port + connects. + </para><para> + Use this mode to connect a physical serial port to a + VM. + </para><para> + On a Windows host system, the device name is a COM + port such as <literal>COM1</literal>. On a Linux host + system, the device name is similar to + <filename>/dev/ttyS0</filename>. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--uarttype<replaceable>N</replaceable>=<replaceable>UART-type</replaceable></option></term> + <listitem><para> + Configures the UART type for the specified virtual serial + port (<replaceable>N</replaceable>). Valid values are + <literal>16450</literal>, <literal>16550A</literal>, and + <literal>16750</literal>. The default value is + <literal>16550A</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--lptmode<replaceable>N</replaceable>=<replaceable>device-name</replaceable></option></term> + <listitem><para> + Specifies the device name of the parallel port to use. + Ensure that you use this option before using the + <option>--lpt</option> option. + </para><para> + For a Windows host system, use a device name such as + <command>lpt1</command>. For a Linux host system, use a + device name such as <filename>/dev/lp0</filename>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--lpt<replaceable>N</replaceable>=<replaceable>I/O-base</replaceable> <replaceable>IRQ</replaceable></option></term> + <listitem><para> + Specifies the I/O base address and IRQ of the parallel + port. Ensure that you use this option after using the + <option>--lptmode</option> option. + </para><para> + You can view the I/O base address and IRQ that the VM uses + for the parallel port in the Device Manager. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audio=<replaceable>type</replaceable></option></term> + <listitem><para> + Specifies whether the VM has audio support, and if so, + which type. Valid audio type values are: + <literal>none</literal>, <literal>null</literal>, + <literal>dsound</literal>, <literal>oss</literal>, + <literal>alsa</literal>, <literal>pulse</literal>, and + <literal>coreaudio</literal>. + </para><para> + Note that the audio types are dependent on the host + operating system. Use the <command>VBoxManage + modifyvm</command> command usage output to determine the + supported audio types for your host system. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audiocontroller=<replaceable>controller-type</replaceable></option></term> + <listitem><para> + Specifies the audio controller to be used with the VM. + Valid audio controller type values are: + <literal>ac97</literal>, <literal>hda</literal>, and + <literal>sb16</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audiocodec=<replaceable>codec-type</replaceable></option></term> + <listitem><para> + Specifies the audio codec to be used with the VM. Valid + audio codec type values are: <literal>stac9700</literal>, + <literal>ad1980</literal>, <literal>stac9221</literal>, + and <literal>sb16</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audioin=on|off</option></term> + <listitem><para> + Specifies whether to enable or disable audio capture from + the host system. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--audioout=on|off</option></term> + <listitem><para> + Specifies whether to enable or disable audio playback from + the guest VM. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--clipboard=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies how to share the guest VM or host system OS's + clipboard with the host system or guest VM, respectively. + Valid values are: <literal>disabled</literal>, + <literal>hosttoguest</literal>, + <literal>guesttohost</literal>, and + <literal>bidirectional</literal>. See + <xref linkend="generalsettings" />. + </para><para> + The clipboard feature is available only if you have the + Guest Additions be installed in the VM. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--draganddrop=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies how to use the drag and drop feature between the + host system and the VM. Valid values are: + <literal>disabled</literal>, + <literal>hosttoguest</literal>, + <literal>guesttohost</literal>, and + <literal>bidirectional</literal>. See + <xref linkend="guestadd-dnd" />. + </para><para> + The drag and drop feature is available only if you have + the Guest Additions be installed in the VM. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--monitorcount=<replaceable>count</replaceable></option></term> + <listitem><para> + Enables you to configure multiple monitors. See + <xref linkend="settings-display" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usb=on | off</option></term> + <listitem><para> + Enables or disables the VM's virtual USB controller. See + <xref linkend="settings-usb" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usbohci=on | off</option></term> + <listitem><para> + Enables or disables the VM's virtual USB 1.1 controller. + See <xref linkend="settings-usb" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usbehci=on | off</option></term> + <listitem><para> + Enables or disables the VM's virtual USB 2.0 controller. + See <xref linkend="settings-usb" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usbxhci=on | off</option></term> + <listitem><para> + Enables or disables the VM's virtual USB 3.0 controller. + See <xref linkend="settings-usb" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--usbrename=<replaceable>old-name</replaceable> <replaceable>new-name</replaceable></option></term> + <listitem><para> + Rename's the VM's virtual USB controller from + <replaceable>old-name</replaceable> to + <replaceable>new-name</replaceable>. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-recording"> + <title>Recording Settings</title> + <remark role="help-copy-synopsis"/> + <para> + The following options enable you to modify settings for video + recording, audio recording, or both. + </para> + <variablelist> + <varlistentry> + <term><option>--recording=on | off</option></term> + <listitem><para> + Enables or disables the recording of a VM session into a + WebM or VP8 file. When set to <literal>on</literal>, + recording begins when the VM session starts. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recordingscreens=all | <replaceable>screen-ID</replaceable></option></term> + <listitem><para> + Enables you to specify the VM screens to record. The + recording for each screen is output to its own file. Valid + values are: <literal>all</literal>, which records all + screens, or one or more specified screens. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recordingfile=<replaceable>filename</replaceable></option></term> + <listitem><para> + Specifies the name of the file in which to save the + recording. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recordingmaxsize=<replaceable>MB</replaceable></option></term> + <listitem><para> + Specifies the maximum size of the recorded video file in + megabytes. When the file reaches the specified size, + recording stops. If the value is <literal>0</literal>, + recording continues until you manually stop recording. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recordingmaxtime=<replaceable>seconds</replaceable></option></term> + <listitem><para> + Specifies the maximum amount of time to record in seconds. + When the specified time elapses, recording stops. If the + value is <literal>0</literal>, recording continues until + you manually stop recording. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recordingopts=<replaceable>keyword</replaceable>=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies additional video-recording properties as a + comma-separated property keyword-value list. For example, + <literal>foo=bar,a=b</literal>. + </para><para> + Only use this option if you are an advanced user. For + information about keywords, see the <citetitle>Oracle VM + VirtualBox Programming Guide and Reference</citetitle>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recordingvideofps=<replaceable>fps</replaceable></option></term> + <listitem><para> + Specifies the maximum number of video frames per second + (FPS) to record. The recording ignores any frames that + have a higher frequency. When you increase the FPS, fewer + frames are ignored but the recording and the size of the + recording file increases. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recordingvideorate=<replaceable>bit-rate</replaceable></option></term> + <listitem><para> + Specifies the bit rate of the video in kilobits per + second. When you increase the bit rate, the recording + appearance improves and the size of the recording file + increases. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--recordingvideores=<replaceable>width</replaceable>x<replaceable>height</replaceable></option></term> + <listitem><para> + Specifies the video resolution (width and height) of the + recorded video in pixels. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-vrde"> + <title>Remote Machine Settings</title> + <remark role="help-copy-synopsis"/> + <para> + The following options enable you to modify the VirtualBox Remote + Desktop Extension (VRDE) behavior. + </para> + <variablelist> + <varlistentry> + <term><option>--vrde=on | off</option></term> + <listitem><para> + Enables or disables the VRDE server. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=TCP/Ports=<replaceable>port</replaceable></option></term> + <listitem><para> + <replaceable>port</replaceable> is the port or port range + to which the VRDE server binds. The + <literal>default</literal> or <literal>0</literal> value + uses port <literal>3389</literal>, which is the standard + RDP port. + </para><para> + Also see the <option>--vrdeport</option> option + description. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=TCP/Address=<replaceable>IP-address</replaceable></option></term> + <listitem><para> + <replaceable>IP-address</replaceable> is the IP address of + the host network interface to which the VRDE server binds. + When specified, the server accepts connections only on the + host network interface at that IP address. + </para><para> + Also see the <option>--vrdeaddress</option> option + description. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=VideoChannel/Enabled=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies whether the VRDP video channel is on or off. + <literal>1</literal> means <literal>on</literal> and + <literal>0</literal> means <literal>off</literal>. See + <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=Quality=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies a value between 10% and 100%, inclusive, that + represents the JPEG compression level on the VRDE server + video channel. A lower value produces lower JPEG quality + but higher compression. See + <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=DownscaleProtection=<replaceable>value</replaceable></option></term> + <listitem><para> + Enables or disables the video downscale protection + feature. Valid values are <literal>1</literal> to enable + the feature and <literal>0</literal> to disable the + feature. + </para><para> + When this feature is enabled, &product-name; determines + whether to display the video: + </para><itemizedlist> + <listitem><para> + When the video size equals the size of the shadow + buffer, the video is considered to be full screen and + is displayed. + </para></listitem> + <listitem><para> + When the video size is between full screen and the + downscale threshold, the video is not displayed. Such + a video might be an application window, which is + unreadable when downscaled. + </para></listitem> + </itemizedlist><para> + When this feature is disabled, an attempt is always made + to display a video. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=Client/DisableDisplay=1</option></term> + <listitem><para> + Disables the display VRDE server feature. + </para><para> + To reenable a feature, assign a null value. For example, + to reenable the display feature, specify the + <command>VBoxManage modifyvm + --vrdeproperty=Client/DisableDisplay=</command> command. + See <xref linkend="vrde-customization" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=DisableInput=1</option></term> + <listitem><para> + Disables the input VRDE server feature. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=DisableAudio=1</option></term> + <listitem><para> + Disables the audio VRDE server feature. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=DisableUSB=1</option></term> + <listitem><para> + Disables the USB VRDE server feature. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=Client/DisableClipboard=1</option></term> + <listitem><para> + Disables the clipboard VRDE server feature. To reenable + the feature, assign a null value. See + <xref linkend="vrde-customization" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=DisableUpstreamAudio=1</option></term> + <listitem><para> + Disables the upstream audio VRDE server feature. To + reenable the feature, assign a null value. See + <xref linkend="vrde-customization" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=Client/DisableRDPDR=1</option></term> + <listitem><para> + Disables the RDP device redirection for smart cards VRDE + server feature. To reenable this feature, assign a null + value. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=H3DRedirect/Enabled=1</option></term> + <listitem><para> + Enables the 3D redirection VRDE server feature. To disable + this feature, assign a null value. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=Security/Method=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies the following information that is required for a + connection: + </para><itemizedlist> + <listitem><para> + <literal>Negotiate</literal> indicates that both + Enhanced (TLS) and Standard RDP Security connections + are permitted. The security method is negotiated with + the client. This is the default value. + </para></listitem> + <listitem><para> + <literal>RDP</literal> indicates that only Standard + RDP Security is accepted. + </para></listitem> + <listitem><para> + <literal>TLS</literal> indicates that only Enhanced + RDP Security is accepted. The client must support TLS. + </para></listitem> + </itemizedlist><para> + See <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=ServerCertificate=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies the absolute path to the server certificate. See + <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=ServerPrivateKey=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies the absolute path to the server private key. See + <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=CACertificate=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies the absolute path to the CA self-signed + certificate. See <xref linkend="vrde-crypt" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty Audio/RateCorrectionMode=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies the audio connection mode or the path to the + audio log file. Valid values are as follows: + </para><itemizedlist> + <listitem><para> + <literal>VRDP_AUDIO_MODE_VOID</literal> is no mode. + Use this value to unset any set audio mode. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_RC</literal> is the rate + correction mode. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_LPF</literal> is the low pass + filter mode. + </para></listitem> + <listitem><para> + <literal>VRDP_AUDIO_MODE_CS</literal> is the client + sync sync mode to prevent an underflow or overflow of + the client queue. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeproperty=LogPath=<replaceable>value</replaceable></option></term> + <listitem><para> + Specifies the absolute path to the audio log file. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeextpack=default | <replaceable>name</replaceable></option></term> + <listitem><para> + Specifies the library to use to access the VM remotely. + The <literal>default</literal> value uses the RDP code + that is part of the &product-name; Extension Pack. + </para><para> + To use the VRDE module in VNC, specify + <literal>VNC</literal>. See + <xref linkend="otherextpacks"/>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdereport=default | <replaceable>port</replaceable></option></term> + <listitem><para> + <replaceable>port</replaceable> is the port or port range + to which the VRDE server binds. The + <literal>default</literal> or <literal>0</literal> value + uses port <literal>3389</literal>, which is the standard + RDP port. + </para><para> + You can specify a comma-separated list of ports or port + ranges of ports. Use a dash between two port numbers to + specify a port range. The VRDE server binds to only one of + the available ports from the list. Only one machine can + use a given port at a time. For example, the + <option>--vrdeport=5000,5010-5012</option> option + specifies that server can bind to one of following ports: + <literal>5000</literal>, <literal>5010</literal>, + <literal>5011</literal>, or <literal>5012</literal>. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeaddress=<replaceable>IP-address</replaceable></option></term> + <listitem><para> + Specifies the IP address of the host network interface to + which the VRDE server binds. If you specify an IP address, + the server accepts connections only on the specified host + network interface. + </para><para> + Use this option to specify whether the VRDP server should + accept IPv4, IPv6, or both type of connections: + </para><itemizedlist> + <listitem><para> + <emphasis role="bold">Only IPv4:</emphasis> Use the + <option>--vrdeaddress="0.0.0.0"</option> option. + </para></listitem> + <listitem><para> + <emphasis role="bold">Only IPv6:</emphasis> Use the + <option>--vrdeaddress="::"</option> option. + </para></listitem> + <listitem><para> + <emphasis role="bold">Both IPv6 and IPv4:</emphasis> + Use the <option>--vrdeaddress=“”</option> + option. This is the default value. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeauthtype=null | external | guest</option></term> + <listitem><para> + Specify whether to use authorization and how to perform + authorization. See <xref linkend="vbox-auth" />. Valid + values are as follows: + </para><itemizedlist> + <listitem><para> + <literal>null</literal> provides no authentication. + </para></listitem> + <listitem><para> + <literal>external</literal> provides external + authentication through an authentication library. + </para></listitem> + <listitem><para> + <literal>guest</literal> performs authentication by + using guest user accounts. This unsupported method + requires that you install the Guest Additions on the + VM. + </para></listitem> + </itemizedlist></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdeauthlibrary=default | <replaceable>name</replaceable></option></term> + <listitem><para> + Specifies the library to use for RDP authentication. The + default library for external authentication is + <filename>VBoxAuth</filename>. See + <xref linkend="vbox-auth" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdemulticon=on | off</option></term> + <listitem><para> + Enables or disables the multiple connections VRDE server + feature, if supported. See + <xref linkend="vrde-multiconnection" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdereusecon=on | off</option></term> + <listitem><para> + Specifies how the VRDE server behaves when multiple + connections are disabled. When the value is + <literal>on</literal>, the server permits a new client to + connect and drops the existing connection. When the value + is <literal>off</literal>, a new connection is not + accepted if a client is already connected to the server. + This is the default value. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdevideochannel=on | off</option></term> + <listitem><para> + Enables video redirection if supported by the VRDE server. + See <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--vrdevideochannelquality=<replaceable>percent</replaceable></option></term> + <listitem><para> + Specifies the image quality for video redirection as a + value from 10 to 100 percent. The percentage represents + the JPEG compression level where a lower number diminishes + quality and provides higher compression. See + <xref linkend="vrde-videochannel" />. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-teleport"> + <title>Teleporting Settings</title> + <remark role="help-copy-synopsis"/> + <para> + The following options enable you to configure a machine as a + teleporting target. See <xref linkend="teleporting" />. + </para> + <variablelist> + <varlistentry> + <term><option>--teleporter=on | off</option></term> + <listitem><para> + Enables or disables the teleporter. When enabled, a + machine starts up and waits to receive a teleporting + request from the network instead of booting normally. + </para><para> + Teleporting requests are received on the port and address + specified using the following parameters. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporterport=<replaceable>port</replaceable></option></term> + <listitem><para> + Specifies the port on which the VM listens to receive a + teleporting request from another VM. + <replaceable>port</replaceable> is any free TCP/IP port + number, such as <literal>6000</literal>. You must also + specify the <option>--teleporter</option> option. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporteraddress=<replaceable>IP-address</replaceable></option></term> + <listitem><para> + Specifies the IP address on which the VM listens to + receive a teleporting request from another VM. + <replaceable>IP-address</replaceable> is any IP address or + host name and specifies the TCP/IP socket on which to + bind. The default IP address is + <literal>0.0.0.0</literal>, which represents any IP + address. You must also specify the + <option>--teleporter</option> option. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporterpassword=<replaceable>password</replaceable></option></term> + <listitem><para> + Specifies the password to use for authentication. When + specified, the teleporting request only succeeds if the + password on the source machine is the same password as the + one you specify. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--teleporterpasswordfile=<replaceable>filename</replaceable></option></term> + <listitem><para> + Specifies a file that contains the password to use for + authentication. When specified, the teleporting request + only succeeds if the password on the source machine is the + same password as the one you specify in the password file. + A value of <literal>stdin</literal> reads the password + from standard input. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--cpuid=<replaceable>leaf</replaceable> <replaceable>eax</replaceable> <replaceable>ebx</replaceable> <replaceable>ecx</replaceable> <replaceable>edx</replaceable></option></term> + <listitem><para> + For advanced users only. + </para><para> + Restricts the virtual CPU capabilities that &product-name; + presents to the guest VM OS. This option affects what the + guest VM sees when it executes the + <literal>CPUID</literal> machine instruction. + </para><para> + Run the <command>VBoxManage modifyvm</command> command + with this option prior to a teleporting operation on both + the source and the target machines. + </para><para> + Use this option if a misbehaving application assumes that + certain CPU capabilities are present when they are not. + The meaning of the values is hardware dependent. See the + AMD or Intel processor documentation. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-debugging"> + <title>Debugging Settings</title> + <remark role="help-copy-synopsis"/> + <para> + Only use the following options to perform low-level VM + debugging. These options are for advanced users only. + </para> + <variablelist> + <varlistentry> + <term><option>--tracing-enabled=on | off</option></term> + <listitem><para> + Enables or disables the trace buffer. Note that when + specified, the trace buffer consumes some memory and adds + overhead. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tracing-config=<replaceable>config-string</replaceable></option></term> + <listitem><para> + Enables a tracing configuration that defines which group + of trace points are enabled. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--tracing-allow-vm-access=on | off</option></term> + <listitem><para> + Enables or disables VM access to the trace buffer. The + default value is <literal>off</literal>, which disables + access. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-usbcardreader"> + <title>USB Card Reader Settings</title> + <remark role="help-copy-synopsis"/> + <para> + The following options specify the access to a USB Card Reader by + the guest environment. A USB card reader can access data on + memory cards, such as CompactFlash (CF), Secure Digital (SD), + and MultiMediaCard (MMC). + </para> + <variablelist> + <varlistentry> + <term><option>--usbcardreader=on | off</option></term> + <listitem><para> + Enables or disables the USB card reader interface. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + <refsect2 id="vboxmanage-modifyvm-autostart"> + <title>Autostarting VMs During Host System Boot</title> + <para> + The following options enable you to configure the VM autostart + feature, which automatically starts the VM at host system + boot-up. You must do some host system configuration before you + can use this feature. See <xref linkend="autostart" />. + </para> + <remark role="help-copy-synopsis"/> + <variablelist> + <varlistentry> + <term><option>--autostart-enabled=on | off</option></term> + <listitem><para> + Enables or disables VM autostart at host system boot-up + for the specified users. + </para></listitem> + </varlistentry> + <varlistentry> + <term><option>--autostart-delay=<replaceable>seconds</replaceable></option></term> + <listitem><para> + Specifies the number of seconds after host system boot-up + to autostart the VM. + </para></listitem> + </varlistentry> + </variablelist> + </refsect2> + </refsect1> + + <refsect1> + <title>Examples</title> + <remark role="help-scope" condition="GLOBAL" /> + <para> + The following command changes the description for the + <filename>ol7</filename> VM. + </para> +<screen>$ VBoxManage modifyvm ol7 --description "Oracle Linux 7 with UEK4"</screen> + <para> + The following command enables VirtualBox Remote Display Protocol + (VRDP) support for the <filename>ol7</filename> VM. + </para> +<screen>$ VBoxManage modifyvm ol7 --vrde on</screen> + </refsect1> + + <refsect1> + <title>See Also</title> + <para> + <xref linkend="vboxmanage-controlvm" />, + <xref linkend="vboxmanage-createvm" />, + <xref linkend="vboxmanage-list" />, + <xref linkend="vboxmanage-startvm" /> + </para> + </refsect1> +</refentry> |