Previous page

Next page

Locate page in Contents

Register / Unregister  a Virtual Machine

Register a virtual machine

prlctl register < path >

Registers a virtual machine with Parallels Desktop. The < path> parameter specifies a path to the virtual machine file.

Optional parameters

--preserve-uuid

If included, the existing virtual machine ID will be kept unchanged.

--uuid < UUID >

If included, the specified UUID will be assigned to the virtual machine. Note that you can include either the -uuid or the --preserve-uuid parameter, but not both. If none of the two parameters are included, an automatically generated ID will be used for the virtual machine.

--force

If included, all validation checks will be skipped.

--regenerate-src-uuid

If included, the virtual machine source ID will be automatically generated (the SMBIOS product ID will be changed as well).

Unregister a virtual machine

prlctl unregister < vm_id | vm_name >

Unregisters the specified virtual machine.

Remarks

Use the register command when you have a virtual machine on the host that doesn't show up in the list of the virtual machines registered with Parallels Desktop. This can be a machine that was previously removed from Parallels Desktop or a machine that was manually copied from another location.

The unregister command removes a virtual machine from Parallels Desktop but does not delete it from the host. You can re-register such a machine with Parallels Desktop later using the register command.