User guide

prlctl Parameters 27
Serial Port Management Parameters
This group of parameters is used to manage serial port settings of your virtual machines. The
parameters syntax is as follows:
prlctl set <ID|name> --device-add serial
{--device <name>|--output <file>|--socket <name>}
[--enable|--disable][--connect|--disconnect]
prlctl set <ID|name> --device-set serialN
{--device <name>|--output <file>|--socket <name>}
[--enable|--disable][--connect|--disconnect]
All VM serial port-related parameters are explained in the following table:
Parameter Name Description
--device-add
Adds a new serial port to the virtual machine.
Note. You can connect up to four serial ports to a virtual machine.
--device-set
Used to configure certain settings of the specified serial port.
serial
Informs the prlctl set command that the device to be added to the
virtual machine is a serial port.
--device name
The number of the serial port on the Parallels server where the newly
created VM serial port is to be connected.
--output file
The path to the output file where the newly created VM serial port is to
be connected.
--socket name
The name of the physical socket on the Parallels server where the newly
created VM serial port is to be connected.
--enable
Enables the VM serial port. All newly added serial ports are enabled by
default (provided the --disable option is omitted).
--disable
Temporarily disables the operations with the newly added serial port.
--connect
Use this option to have the specified serial port automatically enabled
inside the virtual machine on its start.
--disconnect
Use this option if you do not wish to have the specified serial port
automatically enabled inside the virtual machine on its start.