Previous page

Next page

Locate page in Contents

Print this page

prlctl start, stop, restart, reset, status

Start, stop, reset, and check the status of a virtual machine.

Syntax

prlctl start <vm_ID|vm_name>

prlctl stop <vm_ID|vm_name> [ --kill ]

prlctl restart <vm_ID|vm_name>

prlctl reset <vm_ID|vm_name>

prlctl status <vm_ID|vm_name>

Options

Name

Description

<vm_ID|vm_name>

The ID or name of the virtual machine to start, stop, restart, reset, or check the status of.

--kill

Perform a 'hard' virtual machine shutdown. If this option is omitted, an attempt to perform a graceful shutdown will be made.

Remarks

The stop command can perform a 'hard' or a graceful virtual machine shutdown. If the --kill parameter is included, the 'hard' shutdown will be performed. If the parameter is omitted, the outcome of the graceful shutdown attempt will depend on the following:

  • If the Parallels Tools package is installed in a virtual machine, the graceful shutdown will be performed using its facilities.
  • If the Parallels Tools package is not installed, the command will try to perform a graceful shutdown using ACPI. Depending on the ACPI support availability in the guest operating system, this may work or not.

The restart command first gracefully shuts down a virtual machine and then starts it again.

The reset command first performs a 'hard' virtual machine shutdown and then starts it again.

The start command can be used to start a stopped virtual machine or to resume a paused virtual machine .