Previous page

Next page

Locate page in Contents

Print this page

pctl start, stop, reset

Start, stop, and reset a virtual machine.

Syntax

pctl start ID | name

pctl stop ID | name [ --kill ]

pctl reset ID | name

Parameters

Name

Description

ID

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

name

The name of the virtual machine to start, stop, or reset.

--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 reset command stops and then starts a virtual machine. The command first performs a 'hard' virtual machine shutdown and then starts the virtual machine from the stopped state.

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

Links

General Syntax , Legend