4.1.7. prlctl list

Displays a list of virtual machines on the Hardware Node. Displays information on virtual machines on the Hardware Node.

Syntax. 

prlctl list --vmtype vm [-a, --all] [-o, --output <field>[,...]]
            [-s, --sort {<field>|-<field>}] [-t, --template] [-j, --json]
prlctl list -i, --info --vmtype vm [<VM_name>] [-f, --full] [-t, --template]
                                   [-j, --json]

Table 4.7. Options

NameDescription

-a, --all

List all running, stopped, suspended, and paused virtual machines. If this and the rest of the parameters are omitted, only the running virtual machines will be displayed.

-t, --template

List available virtual machine templates instead of actual virtual machines.

-o, --output <field>[,…]

Display only the specified fields. Type field names in lower case. Separate multiple fields with commas. For the list of fields, see Section 3.2.15.1, “prlctl list Output Parameters”.

-s, --sort {<field>|-<field>}

Sort virtual machines by the specified field in either ascending or descending order.

-i, --info

Display detailed information about the specified virtual machine.

-f, --full

Display detailed information about network cards in virtual machines. Used with the --info option.

<VM_name>

The name of the virtual machine for which to display the detailed information. If not specified, the information will be displayed for all registered virtual machines.

-j, -json

Produce machine-readable output in the JSON format.