prlctl register, unregister

The register command is used to register a virtual machine with Parallels Cloud Server.

The unregister command removes a virtual machine from the Parallels Cloud Server registry.

Syntax

prlctl register <path> --preserve-uuid < yes | no >

prlctl unregister <vm_ID|vm_name>

Options

Name	Description
`<path>`	An absolute path to the virtual machine directory.
`<vm_ID\|vm_name>`	The ID or the name of the virtual machine to remove from the Parallels Cloud Server registry.
--preserve-uuid <yes `\|` no>	Specifies what to do with the UUID (universally unique identifier). If you specify `yes` , the UUID is preserved. If you specify `no` , the UUID is regenerated. Note: By default, IDs are regenerated.

Remarks

Use the register command when you have a virtual machine on the server that does not show up in the list of the virtual machines registered with the Parallels Cloud Server. This can be a machine that was previously removed from the registry or a machine that was copied from another location.

The unregister command removes a virtual machine from the Parallels Cloud Server registry, but does not delete the virtual machine files from the server. You can re-register such a machine with Parallels Cloud Server later using the register command.

Top of page

Feedback