vboxmanage-*: add page (#11598)

* VBoxManage-unregistervm : create & write markdown

* VBoxManage-clonevm : create & write markdown

* VBoxManage-createvm : create & write markdown

* VBoxManage-export : create & write markdown

* VBoxManage-import : create & write markdown

* VBoxManage-registervm : create & write markdown

* VBoxManage-registervm : add Title

* VBoxManage-unregistervm : add Title

* vboxmamange : correct typo

* Update pages/common/vboxmanage-clonevm.md

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* vboxmamange-* : rewrite to infinitive tense + change name exemple

* vboxmamange-* : change name exemple

* vboxmamange-* : add colon + add empty line

* Update pages/common/vboxmanage-import.md

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* Update pages/common/vboxmanage-import.md

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* Update pages/common/vboxmanage-import.md

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* Update pages/common/vboxmanage-import.md

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* Update pages/common/vboxmanage-import.md

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* vboxmanage-createvm : fix typo

* vboxmanage-export/import/clonevm : fix typo

* Update pages/common/vboxmanage-clonevm.md

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* vboxmanage-registervm/createVM/cloneVM : correct password option error + correct typo

* VBoxManage-export : correct page

* vboxmanage-createvm : correct typo ostype

* vboxmanage-* : fix typo

* Update vboxmanage-registervm.md

---------

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
pull/23/head
Jacques Hogge 2023-11-29 22:46:27 +01:00 committed by GitHub
parent ef55f8e062
commit 218768cb40
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
6 changed files with 144 additions and 0 deletions

View File

@ -0,0 +1,20 @@
# vboxmanage-clonevm
> Creates a clone of an existing virtual machine (VM).
> More information: <https://www.virtualbox.org/manual/ch08.html#vboxmanage-clonevm>.
- Clone the specified VM:
`VBoxManage clonevm {{vm_name}}`
- Specify a new name for the new VM:
`VBoxManage clonevm {{vm_name}} --name {{new_vm_name}}`
- Indicate the folder where the new VM configuration is saved:
`VBoxManage clonevm {{vm_name}} --basefolder {{path/to/directory}}`
- Store the cloned VM in VirtualBox:
`VBoxManage clonevm {{vm_name}} --register`

View File

@ -0,0 +1,32 @@
# vboxmanage-createvm
> Create a new virtual machine.
> More information: <https://www.virtualbox.org/manual/ch08.html#vboxmanage-createvm>.
- Create a new VM with default settings:
`VBoxManage createvm --name {{vm_name}}`
- Set the base folder where the VM configuration will be stored:
`VBoxManage createvm --name {{vm_name}} --basefolder {{path/to/directory}}`
- Set the guest OS type (one of `VBoxManage list ostypes`) for the imported VM:
`VBoxManage createvm --name {{vm_name}} --ostype {{ostype}}`
- Register the created VM in VirtualBox:
`VBoxManage createvm --name {{vm_name}} --register`
- Set the VM to the specified groups:
`VBoxManage createvm --name {{vm_name}} --group {{group1,group2,...}}`
- Set the Universally Unique Identifier (UUID) of the VM:
`VBoxManage createvm --name {{vm_name}} --uuid {{uuid}}`
- Set the cipher to use for encryption:
`VBoxManage createvm --name {{vm_name}} --cipher {{AES-128|AES-256}}`

View File

@ -0,0 +1,24 @@
# vboxmanage-export
> Export virtual machines to a virtual appliance (ISO) or a cloud service.
> More information: <https://www.virtualbox.org/manual/ch08.html#vboxmanage-export>.
- Specify the target OVF file:
`VBoxManage export --output {{path/to/filename.ova}}`
- Export in OVF 0.9 legacy mode:
`VBoxManage export --legacy09`
- Export in OVF (0.9|1.0|2.0) format:
`VBoxManage export --{{ovf09|ovf10|ovf20}}`
- Create manifest of the exported files:
`VBoxManage export --manifest`
- Specify description to the VM:
`VBoxManage export --description "{{description-info}}"`

View File

@ -0,0 +1,36 @@
# vboxmanage-import
> Imports a virtual machine (VM) previously exported or created.
> More information: <https://www.virtualbox.org/manual/ch08.html#vboxmanage-import>.
- Import a VM from an OVF or OVA file:
`VBoxManage import {{path/to/file.ovf}}`
- Set the name of the imported VM:
`VBoxManage import {{path/to/file.ovf}} --name {{vm_name}}`
- Indicate the folder where the configuration of the imported VM will be stored:
`VBoxManage import {{path/to/file.ovf}} --basefolder {{path/to/directory}}`
- Register the imported VM in VirtualBox:
`VBoxManage import {{path/to/file.ovf}} --register`
- Perform a dry run to check the import without actually importing:
`VBoxManage import {{path/to/file.ovf}} --dry-run`
- Set the guest OS type (one of `VBoxManage list ostypes`) for the imported VM:
`VBoxManage import {{path/to/file.ovf}} --ostype={{ostype}}`
- Set the memory (in megabytes) for the imported VM:
`VBoxManage import {{path/to/file.ovf}} --memory={{1}}`
- Set the number of CPUs for the imported VM:
`VBoxManage import {{path/to/file.ovf}} --cpus={{1}}`

View File

@ -0,0 +1,16 @@
# vboxmanage-registervm
> Register a virtual machine (VM).
> More information: <https://www.virtualbox.org/manual/ch08.html#vboxmanage-registervm>.
- Register an existing VM:
`VBoxManage registervm {{path/to/filename.vbox}}`
- Supply the encryption password file of the VM:
`VBoxManage registervm {{path/to/filename.vbox}} --password {{path/to/password_file}}`
- Prompt for the encryption password on the command line:
`VBoxManage registervm {{path/to/filename.vbox}} --password -`

View File

@ -0,0 +1,16 @@
# vboxmanage-unregistervm
> Unregister a virtual machine (VM).
> More information: <https://www.virtualbox.org/manual/ch08.html#vboxmanage-unregistervm>.
- Unregister an existing VM:
`VBoxManage unregistervm {{uuid|vm_name}}`
- Delete hard disk image files, all saved state files, VM logs, XML VM machine files:
`VBoxManage unregistervm {{uuid|vm_name}} --delete`
- Delete all files from the VM:
`VBoxManage unregistervm {{uuid|vm_name}} --delete-all`