Hard Disk Drive Management Parameters
This group of parameters is used to add and configure virtual hard disks in a virtual machine.
Syntax
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
]
Parameters
Name
|
Description
|
ID
|
The virtual machine ID.
|
VM_name
|
The virtual machine name.
|
--device-add
|
Adds a virtual hard disk 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 hard disks and optical disk drives.
|
--device-set
|
Modifies the parameters of an existing virtual hard disk.
|
hdd
|
Specifies the type of the virtual device to add to the virtual machine (in this instance, a virtual hard disk).
|
hdd
N
|
The name of the virtual hard disk to modify. Virtual hard disks are named using the
hdd
N
format where
N
is the drive index number starting from 0 (e.g.
hdd0
,
hdd1
). To obtain the list of disk names, use the
prlctl list
command with the
--info
option.
|
--image
name
|
This options is used to create a virtual hard disk using an image file. You have an option of creating a new image file or to use an existing image.
-
To use an existing image file, specify its name and path using the
name
parameter.
-
To create a new image file, omit the
--image
parameter. New image files are created in the virtual machine directory and are automatically named using the
harddisk
N
.hdd
format, where
N
is the disk index number (e.g.
harddisk0.hdd
,
harddisk1.hdd
).
|
--device
name
|
This option is used to create a virtual hard disk based on a boot camp partition (Mac hosts). The
name
parameter must contain the boot camp partition name.
|
--type expand|plain
|
For image file based virtual disk drives, specified the disk type:
-
expand
-- expanding disk. The image file is small initially and grows in size as you add data to it. This is the default virtual disk type.
-
plain
-- plain disk. The image file has a fixed size from the moment it is created (i.e the space is allocated for the drive fully). Plain disks perform faster than expanding disks.
|
--size
number
|
The size of the virtual hard disk, in megabytes. The default size is 32,000 MB.
|
--split
|
Splits the hard disk image file into 2 GB pieces. You should split a virtual disk if it is stored on a file system that cannot support files larger than 2 GB (e.g. FAT16).
|
--iface ide|scsi
|
Interface type:
-
ide
-- IDE drive.
-
scsi
- SCSI drive (default).
|
--position
number
|
The SCSI or IDE device identifier to be used for the virtual disk. 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 virtual disk drive. All newly added disk drives are enabled by default (provided the
--disable
option is omitted).
|
--disable
|
Disables the specified virtual disk drive. The disk drive itself is not removed from the virtual machine configuration.
|
Links
General Syntax,
Virtual Device Management
|