Managing Virtual Devices

The prlctl set command allows to add, modify, and delete virtual devices of virtual machines.

Syntax

prlctl set <vm_ID|vm_name> --device-add <dev_type> <options>

prlctl set <vm_ID|vm_name> --device-set <dev_name> <options>

prlctl set <vm_ID|vm_name> --device-del <dev_name> <options> --destroy-image-force

prlctl set <vm_ID|vm_name> --device-connect <dev_name>

prlctl set <vm_ID|vm_name> --device-disconnect <dev_name>

prlctl set <vm_ID|vm_name> --device-bootorder "<dev_name1> <dev_name2> [...]"

Options

Name	Description
`<vm_ID\|vm_name>`	The virtual machine ID or name.
--device-add `<dev_type>` `<options>`	Adds a virtual device of the type `<dev_type>` to a stopped virtual machine. The `<dev_type>` parameter can be: `hdd`, `cdrom`, `net`, `fdd`, `serial`, `parallel`, `sound`, `usb`, `pci`.
--device-set `<dev_name>` `<options>`	Modifies the configuration of the virtual device `<dev_name>` in a stopped virtual machine.
--device-del `<dev_name> <options>`	Deletes the virtual device `<dev_name>` from a stopped virtual machine.
--destroy-image-force	Used with the `--device-del` option. Deletes a virtual machine HDD even if it is used in that virtual machine's snapshots.
--device-connect `<dev_name>`	Connects the virtual device `<dev_name>` to a running virtual machine.
--device-disconnect `<dev_name>`	Disconnects the virtual device `<dev_name>` from a running virtual machine.
--device-bootorder "`<dev_name1>` `<dev_name2>` [...]"	Specifies the boot order for a virtual machine.

Note: Device names can be obtained with the prlctl list -i command.

The device-related <options> can be subdivided into the following categories:

Each group of options is explained in the following subsections in detail.