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.