Previous 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 ID | name

prlctl stop ID | name [ --kill ]

prlctl restart ID | name

prlctl reset ID | name

prlctl status ID | name

Parameters

Name

Description

ID

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

name

The 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.

Links

General Syntax