User guide

prlctl Parameters 19
prlctl set
The prlctl set command is used for setting and configuring virtual machine parameters. It
also can be used to manage the VM devices. The command has the following syntax:
prlctl set <ID|name> [--cpus <number>] [--memsize <number>]
[--videosize <number>] [--description <description>]
[--autostart <on|off|auto>] [--autostart-delay <number>]
[--autostop <stop|suspend>] [--applyconfig <conf>]
[--start-as-user administrator|owner|user:passwd]
[device_management_options] [-v, --verbose number]
The general command options are the following:
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.