%all.entities; ]> September 2019 VBoxManage-modifyvm 1 VBoxManage-modifyvm Change settings for a virtual machine that is stopped Oracle VM VirtualBox VBoxManage modifyvm uuid vmname --name=name --groups= group [,group...] --description=description --ostype=OS-type --iconfile=filename --memory=size-in-MB --pagefusion= on off --vram=size-in-MB --acpi= on off --pciattach=host-PCI-address --pcidetach=host-PCI-address --ioapic= on off --hardwareuuid=UUID --cpus=CPU-count --cpuhotplug= on off --plugcpu=CPU-ID --unplugcpu=CPU-ID --cpuexecutioncap=number --pae= on off --longmode= on off --ibpb-on-vm-exit= on off --ibpb-on-vm-entry= on off --spec-ctrl= on off --l1d-flush-on-sched= on off --l1d-flush-on-vm-entry= on off --mds-clear-on-sched= on off --mds-clear-on-vm-entry= on off --cpu-profile= host Intel 8086 Intel 80286 Intel 80386 --hpet= on off --hwvirtex= on off --triplefaultreset= on off --apic= on off --x2apic= on off --paravirtprovider= none default legacy minimal hyperv kvm --paravirtdebug= key=value [,key=value...] --nestedpaging= on off --largepages= on off --vtxvpid= on off --vtxux= on off --accelerate3d= on off --accelerate2dvideo= on off --chipset= ich9 piix3 --bioslogofadein= on off --bioslogofadeout= on off --bioslogodisplaytime=msec --bioslogoimagepath=pathname --biosbootmenu= disabled menuonly messageandmenu --biosapic= disabled apic x2apic --biossystemtimeoffset=msec --biospxedebug= on off --system-uuid-le= on off --bootX= none floppy dvd disk net --rtcuseutc= on off --graphicscontroller= none vboxvga vmsvga vboxsvga --snapshotfolder= default pathname --firmware= bios efi efi32 efi64 --guestmemoryballoon=size-in-MB --defaultfrontend= default name --nested-hw-virt= on off --vm-process-priority= default flat low normal high VBoxManage modifyvm uuid vmname --nicN= none null nat bridged intnet hostonly generic natnetwork --nictypeN= Am79C970A Am79C973 82540EM 82543GC 82545EM virtio --cableconnectedN= on off --nictraceN= on off --nictracefileN=filename --nicpropertyN=name= value --nicspeedN=kbps --nicbootprioN=priority --nicpromiscN= deny allow-vms allow-all --nicbandwidthgroupN= none name --bridgeadapterN= none device-name --hostonlyadapterN= none device-name --intnetN=network-name --nat-networkN=network-name --nicgenericdrvN=driver-name --macaddressN= auto MAC-address VBoxManage modifyvm uuid vmname --natnetN= network default --natpfN= [rule-name],tcp udp,[host-IP],hostport,[guest-IP],guestport --natpfN=delete=rule-name --nattftpprefixN=prefix --nattftpfileN=filename --nattftpserverN=IP-address --natbindipN=IP-address --natdnspassdomainN= on off --natdnsproxyN= on off --natdnshostresolverN= on off --natsettingsN=[mtu],[socksnd],[sockrcv],[tcpsnd],[tcprcv] --nataliasmodeN= default [log],[proxyonly],[sameports] VBoxManage modifyvm uuid vmname --mouse= ps2 usb usbtablet usbmultitouch --keyboard= ps2 usb --uartN= off IO-base IRQ --uartmodeN= disconnected server pipe client pipe tcpserver port tcpclient hostname:port file filename device-name --uarttypeN= 16450 16550A 16750 --lptmodeN=device-name --lptN= off IO-base IRQ --audio= none null dsound oss alsa pulse coreaudio --audiocontroller= ac97 hda sb16 --audiocodec= stac9700 ad1980 stac9221 sb16 --audioin= on off --audioout= on off --clipboard= disabled hosttoguest guesttohost bidirectional --draganddrop= disabled hosttoguest guesttohost bidirectional --monitorcount=number --usbehci= on off --usbohci= on off --usbxhci= on off --usbrename=old-name new-name VBoxManage modifyvm uuid vmname --recording= on off --recordingscreens= all screen-ID [screen-ID...] --recordingfile=filename --recordingmaxsize=MB --recordingmaxtime=msec --recordingopts= key=value [,key=value...] --recordingvideofps=fps --recordingvideorate=rate --recordingvideores=width height VBoxManage modifyvm uuid vmname --vrde= on off --vrdeproperty=property-name= property-value --vrdeextpack= default name --vrdeport=port --vrdeaddress=hostip --vrdeauthtype= null external guest --vrdeauthlibrary= default name --vrdemulticon= on off --vrdereusecon= on off --vrdevideochannel= on off --vrdevideochannelquality=percent VBoxManage modifyvm uuid vmname --teleporter= on off --teleporterport=port --teleporteraddress= address empty --teleporterpassword=password --teleporterpasswordfile= filename stdin --cpuid-portability-level=level --cpuid-set=leaf :subleaf eax ebx ecx edx --cpuid-remove=leaf :subleaf --cpuidremoveall VBoxManage modifyvm uuid vmname --tracing-enabled= on off --tracing-config=string --tracing-allow-vm-access= on off VBoxManage modifyvm uuid vmname --usbcardreader= on off VBoxManage modifyvm uuid vmname --autostart-enabled= on off --autostart-delay=seconds The VBoxManage modifyvm command enables you to change the properties of a registered virtual machine (VM) that is not running. Most of these properties correspond to the VM settings that are shown in each VM's Settings dialog in the VirtualBox Manager. See . However, some settings can only be viewed and managed with the VBoxManage command. You can use the VBoxManage modifyvm 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. You can use the VBoxManage controlvm command to dynamically change some VM machine settings while the VM is running. See . The following options enable you to modify general information about your VM. The VBoxManage modifyvm command supports the following options: --name=vmname Changes the name of the VM and its related internal VM files. See . --groups=group Changes the group membership of a VM. Group names always begin with a slash character (/) and can be nested. By default, VMs are members of the / group. --description=desc 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 VBoxManage modifyvm command enables you include arbitrary strings that can contain multiple lines. --ostype=OS-type Specifies the guest operating system (OS) to run in the VM. Use the VBoxManage list ostypes command to view the OS type identifiers. --iconfile=filename Specifies the absolute path to the &product-name; icon on the host system. The icon is shown on the VM. --memory=size Specifies the amount of host system RAM to allocate to the VM. The size is in MB. See . --pagefusion=on | off 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 . --vram=size Specifies the amount of RAM to allocate to the virtual graphics card. See . --acpi=on | off Determines whether the VM has ACPI support. See . --ioapic=on | off Determines whether the VM has I/O APIC support. See . --pciattach=host-PCI-address[@guest-PCI-host-bus-address] 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 . --pcidetach=host-PCI-address Detaches the specified PCI network controller from the attached PCI bus on the guest VM. See . --hardwareuuid=uuid 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. --cpus=CPU-count Specifies the number of virtual CPUs to assign to the VM. See . If CPU hot-plugging is enabled, this option specifies the maximum number of virtual CPUs that can be plugged into the VMs. --cpuhotplug=on | off 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 . --plugcpu=CPU-ID Adds a virtual CPU to the VM. CPU-ID is the index of the virtual CPU to add. A valid index value is a number from 0 to the maximum number of CPUs that you configured by using the --cpus option. Only use this option if CPU hot-plugging is enabled. --unplugcpu=CPU-ID Removes a virtual CPU from the VM. CPU-ID is the index of the virtual CPU to remove. A valid index value is a number from 1 to the maximum number of CPUs that you configured by using the --cpus option. Only use this option if CPU hot-plugging is enabled. Note that you cannot remove CPU 0. --cpuexectioncap=percentage Specifies how much CPU time a virtual CPU can use. A valid value is from 1 to 100. A value of 50 indicates that a single virtual CPU can use up to 50% of a single host CPU. --pae=on | off Enables or disables physical address extension (PAE). See . --longmode=on | off Enables or disables long mode. See . --ibpb-on-vm-exit=on | off Enables use of Indirect Branch Prediction Barrier (IBPB) on every VM exit. --ibpb-on-vm-entry=on | off Enables use of Indirect Branch Prediction Barrier (IBPB) on every VM entry. --spec-ctrl=on | off Enables or disables the exposure of speculation control interfaces to the guest VM. These interfaces must be available on the host system. Depending on the host CPU and the workload, enabling speculation control might significantly reduce performance. --l1d-flush-on-sched=on | off Enables or disables level 1 data cache flushing when a thread is scheduled to execute guest code. See . --l1d-flush-on-vm-entry=on | off Enables or disables level 1 data cache flushing on every VM entry. See . --mds-clear-on-sched=on | off Enables CPU buffer clearing when a thread is scheduled to execute guest code. See . --mds-clear-on-vm-entry=on | off Enables CPU buffer clearing on every VM entry. See . --cpu-profile=host | Intel 8086 | Intel 80286 | Intel 80386 Specifies the profile to use for guest CPU emulation. Specify a value that is based on the host system CPU (host) or one of the following older Intel micro-architectures: 8086, 80286, or 80386. --hpet=on | off 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. --hwvirtex=on | off 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 . --triplefaultreset=on | off 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). --apic=on | off 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 . --x2apic=on | off 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. Disable this feature when the OS that runs on a host system or a guest VM is incompatible with CPU x2APIC. --paravirtprovider=none | default | legacy | minimal | hyperv | kvm Specifies one of the following paravirtualization interfaces to provide to the guest OS: none does not expose any paravirtualization interface. default selects the appropriate interface based on the guest OS type when starting the VM. This is the default value used when creating new VMs. legacy selects a paravirtual interface for VMs that were created by older &product-name; versions. minimal is required for Mac OS X guest VMs. kvm is recommended for Linux guest VMs. See . hyperv is recommended for Windows guest VMs. See . --paravirtdebug=property=value Specifies debugging properties that are specific to the paravirtualization provider configured for the specified VM. See . --nestedpaging=on | off 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 and . --largepages=on | off 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. --vtxvpid=on | off Enables or disables the use of the tagged TLB (VPID) feature in the processor of your host system. See . This option is available only when hardware virtualization is enabled on Intel VT-x. --vtxux=on | off 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. --accelerated3d=on | off Enables or disables hardware 3D acceleration. This option is available only when the Guest Additions are installed. See . --accelerated2dvideo=on | off Enables or disables 2D video acceleration. This option is available only when the Guest Additions are installed. See . --chipset=piix3 | ich9 Specify the Intel chipset for &product-name; to emulate. The default value is the Intel PIIX3 chipset (piix3). Change this value only if you need to relax some of the chipset constraints. See . --bioslogofacein=on | off Specifies whether the BIOS logo fades in on VM startup. By default, an &product-name; logo is shown. --bioslogofacein=on | off Specifies whether the BIOS logo fades out on VM startup. --bioslogodisplaytime=msec Specifies the amount of time in milliseconds that the BIOS logo is visible. --bioslogoimagepath=pathname 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. --biosbootmenu=disabled | menuonly | messageandmenu Specifies whether the BIOS permits you to select a temporary boot device. Valid values are: disabled outputs the alternate boot device message and permits you to select a temporary boot device by pressing F12. menuonly suppresses the alternate boot device message, but permits you to select a temporary boot device by pressing F12. messageandmenu suppresses the alternate boot device message and prevents you from selecting a temporary boot device by pressing F12. --biosapic=x2apic | apic | disabled Specifies the APIC level of the firmware. Valid values are: x2apic, apic, and disabled. When the value is disabled, neither the apic nor the x2apic version of the firmware is used. Note that if you specify the x2apic value and x2APIC is unsupported by the virtual CPU, the APIC level downgrades to apic, if supported. Otherwise, the APIC level downgrades to disabled. Similarly, if you specify the apic value and APIC is unsupported by the virtual CPU, the APIC level downgrades to disabled. --biossystemtimeoffset=msec 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. --biospxedebug=on | off Enables or disables additional debugging output when using the Intel PXE boot ROM. The debug output is written to the release log file. See . --system-uuid-le=on | off Enables or disables representing the system UUID in little endian form. The default value is on for new VMs. For old VMs the setting is off to keep the content of the DMI/SMBIOS table unchanged, which can be important for Windows license activation. --bootN=none | floppy | dvd | disk | net 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 N in the option name. A value of 1 for N represents the first boot device slot, and so on. The device types are floppy for floppy disks, dvd for DVDs or CDs, disk for hard disks, and net for a network device. A value of none indicates that no boot device is associated with the specified slot. --rtcuseutc=on | off Specifies whether the real-time clock (RTC) uses coordinated universal time (UTC). See . --graphicscontroller=none | vboxvga | vmsvga | vboxsvga Specifies the graphics controller type to use. See . --snapshotfolder=default | pathname Specifies the name of the VM's snapshot storage folder. If you specify default, the folder name is Snapshots/ in the machine folder. --firmware=bios | efi | efi32 | efi64 Specifies the firmware used to boot the VM. Valid values are: bios, efi, efi32, or efi64. Use EFI values with care. By default, BIOS firmware is used. --guestmemoryballoon=size 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 size in megabytes. The default value is 0 megabytes. See . --defaultfrontend=default | name Specifies the default frontend to use when starting the specified VM. If you specify default, the VM is shown in a window on the user's desktop. See . --nested-hw-virt=on | off Enables or disables nested virtualization. See . --vm-process-priority=default | flat | low | normal | high Specifies the priority scheme of the VM process to use when starting the specified VM and while the VM runs. The following options enable you to modify networking on your VM. With all these options, N is an integer greater than zero that represents the particular virtual network adapter to configure. --nicN=none | null | nat | natnetwork | bridged | intnet | hostonly | generic Configures the network type used by each virtual network card in the VM. The following valid values correspond to the modes described in : none – No networking present null – Not connected to the host system nat – Use network address translation (NAT) natnetwork – Use a NAT metwork bridged – Use bridged networking intnet – Use internal networking hostonly – Use host-only networking generic – Access rarely used sub-modes --nictypeN=Am79C970A | Am79C973 | 82540EM | 82543GC | 82545EM | virtio Identifies the type of networking hardware that &product-name; presents to the guest VM for the specified virtual network card. See . Valid values are as follows: Am79C970A represents the AMD PCNet PCI II. Am79C973 represents the AMD PCNet FAST III, which is the default value. 82540EM represents the Intel PRO/1000 MT Desktop. 82543GC represents the Intel PRO/1000 T Server. 82545EM represents the Intel PRO/1000 MT Server. virtio represents a paravirtualized network adapter. --cableconnectedN=on | off 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. --nictraceN=on | off Enables or disables network tracing for the specified virtual network card. --nictracefileN=filename Specifies the absolute path of the file in which to write trace log information. Use this option if network tracing is enabled. --nicpropertyN=name=value Enables you to set property values and pass them to rarely used network backends. To use this option, you must also use the --nicgenericdrv option. These properties are specific to the backend engine and differ between the UDP Tunnel and the VDE backend drivers. For property examples, see . --nicspeedN=kbps 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 --nic option to enable generic networking for the specified virtual network card. --nicbootprioN=priority 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 0 to 4. Priority 0, which is the default value, is the lowest priority. Priority 1 is the highest priority, and priorities 3 and 4 are lower. This option has an effect only when using the Intel PXE boot ROM. --nicpromiscN=deny | allow-vms | allow-all 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: deny hides any traffic that is not intended for the VM. This is the default value. allow-vms hides all host traffic from the VM, but allows the VM to see traffic to and from other VMs. allow-all allows the VM to see all traffic. --nicbandwidthgroupN=none | name Adds or removes a bandwidth group assignment to the specified virtual network interface. Valid values are as follows: none removes any current bandwidth group assignment from the specified virtual network interface. name adds a bandwidth group assignment to the specified virtual network interface. See . --bridgeadapterN=none | device-name Specifies the host interface to use for the specified virtual network interface. See . Use this option only if you used the --nic option to enable bridged networking for the specified virtual network card. --hostonlyadapterN=none | device-name Specifies which host-only networking interface to use for the specified virtual network interface. See . Use this option only if you used the --nic option to enable host-only networking for the specified virtual network card. --intnetN=network-name Specifies the name of the internal network. See . Use this option only if you used the --nic option to enable internal networking for the specified virtual network card. --nat-networkN=network-name Specifies the name of the NAT network to which this adapter is connected. Use this option only if the networking type is natnetwork, not nat. --nicgenericdrvN=backend-driver Enables you to access rarely used networking sub-modes, such as VDE networks and UDP Tunnel. Use this option only if you used the --nic option to enable generic networking for a virtual network card. --macaddressN=auto | MAC-address 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. The following options use N to specify the particular virtual network adapter to modify. --natnetN=default | network Specifies the IP address range to use for this network. See . Use this option only if the networking type is nat, not natnetwork. --natpfN=[name],tcp | udp,[host-IP],hostport,[guest-IP],guestport Specifies the NAT port-forwarding rule to use. See . --natpfN=delete name Specifies the NAT port-forwarding rule to delete. See . --nattftpprefixN=prefix 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 and . --nattftpfileN=boot-file Specifies the name of the TFT boot file. See . --nattftpserverN=tftp-server Specifies the address of the TFTP server from which to boot. See . --natbindipN=IP-address Specifies an alternate IP address to which the NAT engine binds. See . By default, &product-name;'s NAT engine routes TCP/IP packets through the default interface assigned by the host's TCP/IP stack. --natdnspassdomainN=on | off Specifies whether the built-in DHCP server passes the domain name for network name resolution. --natdnsproxyN=on | off Specifies whether the NAT engine is the proxy for all guest DNS requests to the host system's DNS servers. See . --natdnshostresolverN=on | off Specifies whether the NAT engine uses the host system's resolver mechanisms to handle DNS requests. See . --natsettingsN=[mtu],[socksnd],[sockrcv],[tcpsnd],[tcprcv] Specifies values for tuning NAT performance. See . --nataliasmodeN=default | [log],[proxyonly],[sameports] Specifies the behavior of the NAT engine core as follows: log enables logging proxyonly switches off aliasing mode and makes NAT transparent sameports enforces that the NAT engine sends packets through the same port on which they originated default disables all aliasing modes For more information, see . 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. --mouse=ps2 | usb | usbtablet | usbmultitouch Specifies the mode of the mouse to use in the VM. Valid values are: ps2, usb, usbtablet, and usbmultitouch. --keyboard=ps2 | usb Specifies the mode of the keyboard to use in the VM. Valid values are: ps2 and usb. --uartN=off | I/O-base IRQ Configures virtual serial ports for the VM. N represents the serial port to modify. Valid values are off 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 . --uartmodeN=mode Specifies how &product-name; connects the specified virtual serial port to the host system that runs the VM. See . Ensure that you first configure the virtual serial port by using the --uartN option. Specify one of the following connection modes for each port: disconnected 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. server pipe-name creates the specified named pipe or local domain socket on the host system and connects the virtual serial device to it. On a Windows host system, pipe-name is a named pipe that has a name that uses the following form: \\.\pipe\. On a Linux host system, pipe-name is a local domain socket. client pipe-name connects the virtual serial device to the specified named pipe or local domain socket. Note that the named pipe or local domain socket must already exist. tcpserver port creates a TCP socket with the specified TCP port on the host system and connects the virtual serial device to it. For UNIX-like systems, use ports over 1024 for non-root users. tcpclient hostname:port connects the virtual serial device to the TCP socket. Note that the TCP socket must already exist. file filename redirects the serial port output to the specified raw file. Ensure that filename is the absolute path of the on the host system. device-name: specifies the device name of a physical hardware serial port on the specified host system to which the virtual serial port connects. Use this mode to connect a physical serial port to a VM. On a Windows host system, the device name is a COM port such as COM1. On a Linux host system, the device name is similar to /dev/ttyS0. --uarttypeN=UART-type Configures the UART type for the specified virtual serial port (N). Valid values are 16450, 16550A, and 16750. The default value is 16550A. --lptmodeN=device-name Specifies the device name of the parallel port to use. Ensure that you use this option before using the --lpt option. For a Windows host system, use a device name such as lpt1. For a Linux host system, use a device name such as /dev/lp0. --lptN=I/O-base IRQ Specifies the I/O base address and IRQ of the parallel port. Ensure that you use this option after using the --lptmode option. You can view the I/O base address and IRQ that the VM uses for the parallel port in the Device Manager. --audio=type Specifies whether the VM has audio support, and if so, which type. Valid audio type values are: none, null, dsound, oss, alsa, pulse, and coreaudio. Note that the audio types are dependent on the host operating system. Use the VBoxManage modifyvm command usage output to determine the supported audio types for your host system. --audiocontroller=controller-type Specifies the audio controller to be used with the VM. Valid audio controller type values are: ac97, hda, and sb16. --audiocodec=codec-type Specifies the audio codec to be used with the VM. Valid audio codec type values are: stac9700, ad1980, stac9221, and sb16. --audioin=on|off Specifies whether to enable or disable audio capture from the host system. --audioout=on|off Specifies whether to enable or disable audio playback from the guest VM. --clipboard=value Specifies how to share the guest VM or host system OS's clipboard with the host system or guest VM, respectively. Valid values are: disabled, hosttoguest, guesttohost, and bidirectional. See . The clipboard feature is available only if you have the Guest Additions be installed in the VM. --draganddrop=value Specifies how to use the drag and drop feature between the host system and the VM. Valid values are: disabled, hosttoguest, guesttohost, and bidirectional. See . The drag and drop feature is available only if you have the Guest Additions be installed in the VM. --monitorcount=count Enables you to configure multiple monitors. See . --usb=on | off Enables or disables the VM's virtual USB controller. See . --usbohci=on | off Enables or disables the VM's virtual USB 1.1 controller. See . --usbehci=on | off Enables or disables the VM's virtual USB 2.0 controller. See . --usbxhci=on | off Enables or disables the VM's virtual USB 3.0 controller. See . --usbrename=old-name new-name Rename's the VM's virtual USB controller from old-name to new-name. The following options enable you to modify settings for video recording, audio recording, or both. --recording=on | off Enables or disables the recording of a VM session into a WebM or VP8 file. When set to on, recording begins when the VM session starts. --recordingscreens=all | screen-ID Enables you to specify the VM screens to record. The recording for each screen is output to its own file. Valid values are: all, which records all screens, or one or more specified screens. --recordingfile=filename Specifies the name of the file in which to save the recording. --recordingmaxsize=MB Specifies the maximum size of the recorded video file in megabytes. When the file reaches the specified size, recording stops. If the value is 0, recording continues until you manually stop recording. --recordingmaxtime=seconds Specifies the maximum amount of time to record in seconds. When the specified time elapses, recording stops. If the value is 0, recording continues until you manually stop recording. --recordingopts=keyword=value Specifies additional video-recording properties as a comma-separated property keyword-value list. For example, foo=bar,a=b. Only use this option if you are an advanced user. For information about keywords, see the Oracle VM VirtualBox Programming Guide and Reference. --recordingvideofps=fps 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. --recordingvideorate=bit-rate 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. --recordingvideores=widthxheight Specifies the video resolution (width and height) of the recorded video in pixels. The following options enable you to modify the VirtualBox Remote Desktop Extension (VRDE) behavior. --vrde=on | off Enables or disables the VRDE server. --vrdeproperty=TCP/Ports=port port is the port or port range to which the VRDE server binds. The default or 0 value uses port 3389, which is the standard RDP port. Also see the --vrdeport option description. --vrdeproperty=TCP/Address=IP-address IP-address 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. Also see the --vrdeaddress option description. --vrdeproperty=VideoChannel/Enabled=value Specifies whether the VRDP video channel is on or off. 1 means on and 0 means off. See . --vrdeproperty=Quality=value 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 . --vrdeproperty=DownscaleProtection=value Enables or disables the video downscale protection feature. Valid values are 1 to enable the feature and 0 to disable the feature. When this feature is enabled, &product-name; determines whether to display the video: When the video size equals the size of the shadow buffer, the video is considered to be full screen and is displayed. 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. When this feature is disabled, an attempt is always made to display a video. --vrdeproperty=Client/DisableDisplay=1 Disables the display VRDE server feature. To reenable a feature, assign a null value. For example, to reenable the display feature, specify the VBoxManage modifyvm --vrdeproperty=Client/DisableDisplay= command. See . --vrdeproperty=DisableInput=1 Disables the input VRDE server feature. --vrdeproperty=DisableAudio=1 Disables the audio VRDE server feature. --vrdeproperty=DisableUSB=1 Disables the USB VRDE server feature. --vrdeproperty=Client/DisableClipboard=1 Disables the clipboard VRDE server feature. To reenable the feature, assign a null value. See . --vrdeproperty=DisableUpstreamAudio=1 Disables the upstream audio VRDE server feature. To reenable the feature, assign a null value. See . --vrdeproperty=Client/DisableRDPDR=1 Disables the RDP device redirection for smart cards VRDE server feature. To reenable this feature, assign a null value. --vrdeproperty=H3DRedirect/Enabled=1 Enables the 3D redirection VRDE server feature. To disable this feature, assign a null value. --vrdeproperty=Security/Method=value Specifies the following information that is required for a connection: Negotiate 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. RDP indicates that only Standard RDP Security is accepted. TLS indicates that only Enhanced RDP Security is accepted. The client must support TLS. See . --vrdeproperty=ServerCertificate=value Specifies the absolute path to the server certificate. See . --vrdeproperty=ServerPrivateKey=value Specifies the absolute path to the server private key. See . --vrdeproperty=CACertificate=value Specifies the absolute path to the CA self-signed certificate. See . --vrdeproperty Audio/RateCorrectionMode=value Specifies the audio connection mode or the path to the audio log file. Valid values are as follows: VRDP_AUDIO_MODE_VOID is no mode. Use this value to unset any set audio mode. VRDP_AUDIO_MODE_RC is the rate correction mode. VRDP_AUDIO_MODE_LPF is the low pass filter mode. VRDP_AUDIO_MODE_CS is the client sync sync mode to prevent an underflow or overflow of the client queue. --vrdeproperty=LogPath=value Specifies the absolute path to the audio log file. --vrdeextpack=default | name Specifies the library to use to access the VM remotely. The default value uses the RDP code that is part of the &product-name; Extension Pack. To use the VRDE module in VNC, specify VNC. See . --vrdereport=default | port port is the port or port range to which the VRDE server binds. The default or 0 value uses port 3389, which is the standard RDP port. 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 --vrdeport=5000,5010-5012 option specifies that server can bind to one of following ports: 5000, 5010, 5011, or 5012. --vrdeaddress=IP-address 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. Use this option to specify whether the VRDP server should accept IPv4, IPv6, or both type of connections: Only IPv4: Use the --vrdeaddress="0.0.0.0" option. Only IPv6: Use the --vrdeaddress="::" option. Both IPv6 and IPv4: Use the --vrdeaddress=“” option. This is the default value. --vrdeauthtype=null | external | guest Specify whether to use authorization and how to perform authorization. See . Valid values are as follows: null provides no authentication. external provides external authentication through an authentication library. guest performs authentication by using guest user accounts. This unsupported method requires that you install the Guest Additions on the VM. --vrdeauthlibrary=default | name Specifies the library to use for RDP authentication. The default library for external authentication is VBoxAuth. See . --vrdemulticon=on | off Enables or disables the multiple connections VRDE server feature, if supported. See . --vrdereusecon=on | off Specifies how the VRDE server behaves when multiple connections are disabled. When the value is on, the server permits a new client to connect and drops the existing connection. When the value is off, a new connection is not accepted if a client is already connected to the server. This is the default value. --vrdevideochannel=on | off Enables video redirection if supported by the VRDE server. See . --vrdevideochannelquality=percent 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 . The following options enable you to configure a machine as a teleporting target. See . --teleporter=on | off 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. Teleporting requests are received on the port and address specified using the following parameters. --teleporterport=port Specifies the port on which the VM listens to receive a teleporting request from another VM. port is any free TCP/IP port number, such as 6000. You must also specify the --teleporter option. --teleporteraddress=IP-address Specifies the IP address on which the VM listens to receive a teleporting request from another VM. IP-address is any IP address or host name and specifies the TCP/IP socket on which to bind. The default IP address is 0.0.0.0, which represents any IP address. You must also specify the --teleporter option. --teleporterpassword=password 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. --teleporterpasswordfile=filename 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 stdin reads the password from standard input. --cpuid=leaf eax ebx ecx edx For advanced users only. 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 CPUID machine instruction. Run the VBoxManage modifyvm command with this option prior to a teleporting operation on both the source and the target machines. 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. Only use the following options to perform low-level VM debugging. These options are for advanced users only. --tracing-enabled=on | off Enables or disables the trace buffer. Note that when specified, the trace buffer consumes some memory and adds overhead. --tracing-config=config-string Enables a tracing configuration that defines which group of trace points are enabled. --tracing-allow-vm-access=on | off Enables or disables VM access to the trace buffer. The default value is off, which disables access. 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). --usbcardreader=on | off Enables or disables the USB card reader interface. 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 . --autostart-enabled=on | off Enables or disables VM autostart at host system boot-up for the specified users. --autostart-delay=seconds Specifies the number of seconds after host system boot-up to autostart the VM. The following command changes the description for the ol7 VM. $ VBoxManage modifyvm ol7 --description "Oracle Linux 7 with UEK4" The following command enables VirtualBox Remote Display Protocol (VRDP) support for the ol7 VM. $ VBoxManage modifyvm ol7 --vrde on , , ,