Parameter Name

Description

ID

The ID of the virtual machine whose parameters you wish to set/configure.

name

The name of the virtual machine whose parameters you wish to set/configure.

--cpus number

If the Parallels server has more than one CPU installed, this option allows you to set the number of virtual CPUs to be available to the virtual machine.

--memsize number

The amount of memory that can be consumed by the virtual machine, in megabytes.

--videosize number

The amount of memory to be allocated to the virtual machine graphic card.

--description VM_description

Short description of the virtual machine.

--autostart on|off|auto

Defines the virtual machine start-up options:

• on : the virtual machine is started automatically on the Parallels server boot.
• off : the virtual machine is left in the stopped state on the Parallels server boot. This is the default VM start-up mode.
• auto : resume the state that the virtual machine had when the Parallels server was turned off.

If you set this option to on or auto , you should additionally specify the --start-as-user option.

--autostart-delay number

Sets the time interval when the virtual machine is to start after the Parallels server boot.

--autostop stop|suspend

Defines the action the virtual machine should perform on the Parallels server shutting down. It can be set to one of the following:

• stop : the virtual machine is stopped when you shut down the virtual machine.
• suspend : the virtual machine is suspended when the Parallels server is shut down.

--start-as-user administrator|owner| user : passwd

Specifies under which account the virtual machine is to be run:

• administrator : run the virtual machine as the Parallels server administrator;
• owner : run the virtual machine as its owner;
• user : run the virtual machine as the specified user.

--applyconfig conf

The full path to the config.pvs configuration file of an existing virtual machine you wish to base your virtual machine on.

device_management_options

A group of parameters used to manage VM devices. Detailed description of all available parameters is given in the next subsection.

-v, --verbose number

Sets the verbosity level for the prlctl set command. The greater number you specify, the more verbose output the command will produce.

In This Section

Device Management Parameters

Hard Disk Drive Management Parameters

DVD-ROM and CD-ROM Drive Management Parameters

Floppy Disk Drive Management Parameters

Network Adapter Management Parameters

Serial Port Management Parameters

Parallel Port Management Parameters

USB Port Management Parameters

Sound Device Management Parameters

Removing Devices from Virtual Machine