User guide

prlctl Parameters 21
Hard Disk Drive Management Parameters
This group of parameters is used to create new virtual hard disk drives for your virtual machines
and configure their properties. The parameters syntax is as follows:
prlctl set <ID|VM_name> --device-add hdd [--image <name>]
[--type <expand|plain>][--size <number>][--split]
[--iface <ide|scsi>][--position <number>]
[--enable|--disable]
prlctl set <ID|VM_name> --device-add hdd --device <name>
[--iface <ide|scsi>][--position <number>]
[--enable|--disable]
prlctl set <ID|VM_name> --device-set hddN [--image <name>]
[--type <expand|plain>][--size <number>][--split]
[--iface <ide|scsi>][--position <number>]
[--enable|--disable]
prlctl set <ID|VM_name> --device-set hddN --device <name>
[--iface <ide|scsi>][--position <number>]
[--enable|--disable]
All VM disk drive-related parameters are explained in the following table:
Parameter Name Description
--device-add
Adds a virtual hard disk drive to the virtual machine. By default, the
prlctl create command creates a virtual machine with only one
disk drive. However, you can use --device-add to add additional
virtual disk drives to your 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 hard disk
drive.
hdd
Informs the prlctl set command that the device to be added to
the virtual machine is a hard disk drive. By default, prlctl set
creates a virtual disk drive
hddN
The name of the virtual hard disk drive whose parameters you wish to
configure where N denotes the disk 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 the specified physical
hard disk on the Parallels server to the virtual machine. Using this
option allows you to run guest operating systems (e.g. Mac OS X,
Linux, or Windows) from existing physical disk partitions on the
Parallels server.
When used with --device-set, this parameter configures the
properties of the VM disk drive connected the specified physical
partition.
You can use the prlctl server command to learn what physical
hard disk drives currently exist on the Parallels server.