Optical Disk Drive Management Parameters
This group of parameters is used to add and configure virtual optical disk drives, such as DVD or CD drives.
Syntax
prlctl set ID|VM_name --device-add cdrom --image image_name
[--iface ide|scsi] [--position number]
[--enable|--disable] [--connect|--disconnect]
prlctl set ID|VM_name --device-add cdrom --device device_name
[--iface ide|scsi] [--position number]
[--enable|--disable] [--connect|--disconnect]
prlctl set ID|VM_name --device-set cdromN
{--device name|--image name} [--iface ide|scsi]
[--position number][--enable|--disable]
[--connect|--disconnect]
Parameters
Name
|
Description
|
ID
|
The virtual machine ID.
|
name
|
The virtual machine name.
|
--device-add
|
Adds a DVD/CD drive to the virtual machine. You can connect up to four IDE devices and up to seven SCSI devices to a virtual machine. This includes virtual hard disks and DVD/CD drives.
|
--device-set
|
Modifies the parameters of an existing virtual optical disk.
|
cdrom
|
Specifies the virtual device type (in this instance, a CD or DVD drive).
|
cdrom N
|
The name of the DVD/CD drive to modify. The N postfix indicates the drive index number. To obtain the list of the available drives, use the prlctl list command with the --info option.
|
--device name
|
The name of the physical optical disk to connect to the virtual machine.
|
--image name
|
The name of an existing disk image file to mount in the virtual machine. Currently, the following image file formats are supported: .iso , .cue , .ccd , and .dmg . The image must not be compressed and/or encrypted.
|
--iface ide|scsi
|
Interface type:
ide -- IDE disk.scsi -- SCSI disk (default).
|
--position number
|
The SCSI or IDE device identifier to be used for the DVD/CD drive. The allowed ID ranges are the following:
- for IDE devices:
0:0 , 0:1 , 1:0 , 1:1 ; - for SCSI device:
0:0 , 1:0 , 2:0 , 3:0 , 4:0 , 5:0 , 6:0 .
You can use one of the following formats for specifying IDs: ID : bus , ID - bus , ID . For example, if you specify 3:0 (or 3-0 or 3) as number for a SCSI drive, the guest OS will see the drive as having ID 3 on SCSI bus 0.
|
--enable
|
Enables the specified DVD/CD drive. All newly added drives are enabled by default (provided the --disable option is omitted).
|
--disable
|
Disables the specified optical disk drive. The disk drive itself is not removed from the virtual machine configuration.
|
--connect
|
Automatically connect the specified optical disk drive during the virtual machine startup process.
|
--disconnect
|
Do not automatically connect the specified optical disk drive during the virtual machine startup process.
|
|