Listing Virtual Machines and Containers

To get an overview of the virtual machines and Containers existing on the physical server and to get additional information about them—their IP addresses, hostnames, current resource consumption, and so on—use the prlctl list command. In the most general case, you can get a list of all virtual machines and Containers by issuing the following command:

# prlctl list -a

UUID STATUS IP_ADDR T NAME

{600adc12-0e39-41b3-bf05-c59b7d26dd73} running 10.10.1.101 CT 101

{b2de86d9-6539-4ccc-9120-928b33ed31b9} stopped 10.10.100.1 VM MyVM

The -a option tells the prlctl list command to output both running and stopped virtual machines and Containers. By default, only running virtual machines and Containers are shown. The default columns inform you of the Container IDs and virtual machine names, the virtual machine or Container status, type, IP addresses, and unique identifiers. This output can be customized as desired by using prlctl list command line options. For example:

# prlctl list -a -o name,ctid

NAME ID

101 101

MyVm {b8cb6d99-1af1-453d-a302-2fddd8f86769}

This command displays only the names of existing virtual machines and Containers and the IP addresses assigned to them. The full list of the prlctl list command-line options for virtual machines and Containers is available in the Parallels Cloud Server 6.0 Command Line Reference Guide .