User guide

prlctl Parameters 23
DVD-ROM and CD-ROM Drive Management Parameters
This group of parameters is used to manage virtual machine DVD-ROM and CD-ROM drives.
The parameters syntax is as follows:
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]
All VM DVD/CD-ROM drive-related parameters are explained in the following table:
Parameter Name Description
--device-add
Adds a DVD/CD-ROM drive to the virtual machine.
Note: You can connect up to four IDE devices and up to seven
SCSI devices to a virtual machine. Any of these devices can be
a virtual hard disk or DVD/CD-ROM drive.
--device-set
Used to configure certain settings of the specified VM DVD/CD-
ROM drive.
cdrom
Informs the prlctl set command that the device to be added to
the virtual machine is a DVD/CD-ROM drive.
cdromN
The name of the DVD/CD-ROM drive whose parameters you wish to
configure where N denotes the drive index number.
You can learn this number by running the prlctl list command
with the --info option.
--device name
Tells the prlctl set command to connect a physical DVD/CD-
ROM drive (either on the Parallels server or on the client computer
where you are running the prlctl utility) with the specified name to
the virtual machine.
--image name
Tells the prlctl set command to connect an existing image file
(either on the Parallels server or on the client computer where you are
running the prlctl utility) with the specified name to the virtual
machine. Currently, the following image file formats are supported:
.iso, .cue, .ccd, and .dmg. Images must be non-compressed and
non-encrypted.
--iface ide|scsi
The interface type of the DVD/CD-ROM drive. It can be one of the
following:
 IDE (Integrated Drive Electronics) and
 SCSI (Small Computer Systems Interface).
By default, the interface type of the newly added disk drive is set to
scsi.