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.

cdrom N

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 .

--position number

The SCSI or IDE device identifier to be used for the DVD/CD-ROM 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-ROM drive. All newly added DVD/CD-ROM drives are enabled by default (provided the --disable option is omitted).

--disable

Temporarily disables the operations with the newly added DVD/CD-ROM drive.

--connect

Use this option to have the specified DVD/CD-ROM drive automatically connected to the virtual machine on its start.

--disconnect

Use this option if you do not wish to have the specified DVD/CD-ROM drive automatically connected to the virtual machine on its start.