8.7. VBoxManage registervm

Synopsis

VBoxManage registervm <filename> --password file

Description

The VBoxManage registervm command enables you to create a virtual machine (VM) by importing an XML machine configuration file into Oracle VM VirtualBox. The VM cannot have the same UUID as a VM that is already registered in Oracle VM VirtualBox. Ensure that the XML machine configuration file is in the machines folder prior to registration.

Note

When you use the VBoxManage createvm command to create a VM, you can specify the --register option to register the VM.

filename: Specifies the XML machine configuration file. This file has the .vbox file extension.
--password: Use the --password to supply the encryption password of the VM. Either specify the absolute pathname of a password file on the host operating system, or - to prompt you for the password on the command line.

Examples

The following command registers a VM called vm2. The XML machine configuration file for the VM is located in the default machines folder.

$ VBoxManage registervm "/home/user/VirtualBox VMs/vm2/vm2.vbox"