Download Oracle VM VirtualBox User Manual

8 VBoxManage
– only IPv4: --vrdeaddress "0.0.0.0"
– only IPv6: --vrdeaddress "::"
– both IPv6 and IPv4 (default): --vrdeaddress ""
• --vrdeauthtype null|external|guest: This allows you to choose whether and how
authorization will be performed; see chapter 7.1.5, RDP authentication, page 106 for details.
• --vrdemulticon on|off: This enables multiple connections to the same VRDE server, if
the server supports this feature; see chapter 7.1.7, Multiple connections to the VRDP server,
page 108.
• --vrdereusecon on|off: This specifies the VRDE server behavior when multiple connections are disabled. When this option is enabled, the server will allow a new client to
connect and will drop the existing connection. When this option is disabled (this is the default setting), a new connection will not be accepted if there is already a client connected
to the server.
• --vrdevideochannel on|off: This enables video redirection, if it is supported by the
VRDE server; see chapter 7.1.9, VRDP video redirection, page 109.
• --vrdevideochannelquality <percent>: Sets the image quality for video redirection;
see chapter 7.1.9, VRDP video redirection, page 109.
8.8.5 Teleporting settings
With the following commands for VBoxManage modifyvm you can configure a machine to be a
target for teleporting. See chapter 7.2, Teleporting, page 110 for an introduction.
• --teleporter on|off: With this setting you turn on or off whether a machine waits for
a teleporting request to come in on the network when it is started. If “on”, when the
machine is started, it does not boot the virtual machine as it would normally; instead, it
then waits for a teleporting request to come in on the port and address listed with the next
two parameters.
• --teleporterport <port>, --teleporteraddress <address>: these must be used
with –teleporter and tell the virtual machine on which port and address it should listen
for a teleporting request from another virtual machine. <port> can be any free TCP/IP
port number (e.g. 6000); <address> can be any IP address or hostname and specifies the
TCP/IP socket to bind to. The default is “0.0.0.0”, which means any address.
• --teleporterpassword <password>: if this optional argument is given, then the teleporting request will only succeed if the source machine specifies the same password as the
one given with this command.
• --teleporterpasswordfile <password>: if this optional argument is given, then the
teleporting request will only succeed if the source machine specifies the same password as
the one specified in the file give with this command. Use stdin to read the password from
stdin.
• --cpuid <leaf> <eax> <ebx> <ecx> <edx>: Advanced users can use this command before a teleporting operation to restrict the virtual CPU capabilities that VirtualBox presents
to the guest operating system. This must be run on both the source and the target machines
involved in the teleporting and will then modify what the guest sees when it executes the
CPUID machine instruction. This might help with misbehaving applications that wrongly
assume that certain CPU capabilities are present. The meaning of the parameters is hardware dependent; please refer to the AMD or Intel processor manuals.
129