Previous page

Next page

Locate page in Contents

Print this page

prlctl list

The prlctl list command is used to display a list of virtual machines currently registered in Parallels Server or Parallels Desktop together with additional information about these virtual machines. It has the following syntax:

prlctl list [-a, --all] [-t, --template] [--no-header]

[-o, --output name [, name ...]] [-s, --sort name |- name ]

[-v, --verbose number ]

prlctl list --info [< ID | name >] [-v, --verbose number ]

The options that can be used with this command are explained in the table below:

Parameter Name

Description

-a, --all

Lists all virtual machines currently registered in Parallels Server or Parallels Desktop.

-t, --template

Lists the templates that currently exist on Parallels Server or Parallels Desktop and that can be used as the basis for the virtual machine creation. In this case, a template denotes a folder containing one or more VM configuration files.

To deploy a template, use the prlctl create command.

--no-header

Do not display column headers.

-i, --info

Displays detailed information on all virtual machines currently registered in Parallels Server or Parallels Desktop. You can specify the virtual machine ID or its name to view detailed information about this VM only.

ID

The ID of the virtual machine whose detailed information you wish to view.

name

The name of the virtual machine whose detailed information you wish to view.

-o, --output name

This option is used to display only particular information about the virtual machine. Currently, you can use the following parameters after the --output option:

  • uuid : the ID assigned to the virtual machine;
  • name : the name assigned to the virtual machine;
  • status : the current status of the virtual machine.

To display a number of parameters in a single output, they should be separated with commas (e.g. uuid , name ).

-s, --sort name

Sorts the virtual machines in the list by the specified parameter. If "-" is given before the name of the parameter, the sorting order is reversed.

-v, --verbose number

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

If no parameter is specified, only the currently running virtual machines will be listed.

Please send us your feedback on this help page