Previous page

Next page

Locate page in Contents

Print this page

Managing Virtual Devices

The pctl set command allows to add virtual devices to a virtual machine and to modify and delete existing virtual devices.

General Syntax

pctl set ID | VM_name --device-add dev_ type options

pctl set ID | VM_name --device-set name options

pctl set ID | VM_name --device-del name

Parameters

Name

Description

ID

The virtual machine ID.

VM_name

The virtual machine name.

--device-add dev_type options

Adds a virtual device to the specified virtual machine.

The dev_type parameter specifies the virtual device type ( hdd , cdrom , fdd , net , etc.).

The options parameters specifies device-type specific options.

--device-set name options

Modifies the configuration of an existing virtual device in the specified virtual machine.

The name parameter specifies the virtual device name.

The options parameters specifies device-type specific options.

--device-del name

Deletes a virtual device from the virtual machine. The name parameter specifies the name of the virtual device to delete.

Remarks

All device-related parameters can be subdivided into the following categories:

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

Notes

All operations on virtual machine devices (adding, modifying, or removing a device) must be performed on a stopped virtual machine. An attempt to perform any of these operations on a running virtual machine will result in error.

Links

Legend