User guide

prlctl Parameters 29
USB Port Management Parameters
This group of parameters is used to manage USB controller settings of your virtual machines.
The parameters syntax is as follows:
prlctl set <ID|name> --device-add usb [--enable|--disable]
[--connect|--disconnect]
All USB controller-related parameters are explained in the following table:
Parameter Name Description
usb
Informs the prlctl set command that the device to be added to the
virtual machine is a USB controller.
Note: A virtual machine can use only one USB controller.
However, you can connect up to eight USB 2.0 ports and two USB
1.0 ports to the virtual machine.
--enable
Enables the specified USB controller. All newly added USB controllers
are enabled by default (provided the --disable option is omitted).
--disable
Temporarily disables the operations with the specified USB controller.
--connect
Use this option to have the specified USB controller automatically
enabled inside the virtual machine on its start.
--disconnect
Use this option if you do not wish to have the specified USB controller
automatically enabled inside the virtual machine on its start.
Sound Device Management Parameters
This group of parameters is used to manage sound device settings of your virtual machines. The
parameters syntax is as follows:
prlctl set <ID|name> --device-add sound --output <name>
[--enable|--disable][--connect|--disconnect]
prlctl set <ID|name> --device-set sound --output <name>
[--enable|--disable][--connect|--disconnect]
All VM sound device-related parameters are explained in the following table:
Parameter Name Description
sound
Informs the prlctl set command that the device to be added to the
virtual machine is a sound card.
--output name
The name of the output device on the Parallels server.
--input name
The name of the input device on the Parallels server.
--enable
Enables the specified sound device. All newly added sound devices are
enabled by default (provided the --disable option is omitted).
--disable
Temporarily disables the operations with the specified sound device.
--connect
Use this option to have the sound card automatically enabled inside the
virtual machine on its start.