ВАЖНО! Параметры команды VBoxManage постоянно изменяются от версии к версии.
Поэтому настоятельно рекомендую изучать вывод команды VBoxManage | more
Оглавление
Когда вы запускаете VBoxManage без параметров или с неправильными параметрами, то будет показана синтаксическая диаграмма, приведенная ниже. Вид диаграмм может быть немного другим, в зависимости от платформы хоста; если вы сомневаетесь то проверьте вывод VBoxManage
на предмет доступных команд на вашем хосте.
Использование: VBoxManage [-v|--version] показать номер версии и выйти VBoxManage [-q|--nologo] ... запретить показ логотипа VBoxManage list [--long|-l] vms|runningvms|ostypes|hostdvds|hostfloppies| bridgedifs|hostinfo|dhcpservers| hddbackends|hdds|dvds|floppies| usbhost|usbfilters|systemproperties VBoxManage showvminfo <uuid>|<name> [--details] [--statistics] [--machinereadable] VBoxManage registervm <filename> VBoxManage unregistervm <uuid>|<name> [--delete] VBoxManage createvm --name <name> [--ostype <ostype>] [--register] [--basefolder <path> | --settingsfile <path>] [--uuid <uuid>] VBoxManage modifyvm <uuid|name> [--name <name>] [--ostype <ostype>] [--memory <memorysize in MB>] [--vram <vramsize in MB>] [--acpi on|off] [--ioapic on|off] [--pae on|off] [--hwvirtex on|off|default] [--nestedpaging on|off] [--vtxvpid on|off] [--monitorcount <number>] [--accelerate3d <on|off>] [--bioslogofadein on|off] [--bioslogofadeout on|off] [--bioslogodisplaytime <msec>] [--bioslogoimagepath <imagepath>] [--biosbootmenu disabled|menuonly|messageandmenu] [--biossystemtimeoffset <msec>] [--biospxedebug on|off] [--boot<1-4> none|floppy|dvd|disk|net>] [--hd<a|b|d> none|<uuid>|<filename>] [--idecontroller PIIX3|PIIX4] [--dvd none|<uuid>|<filename>|host:<drive>] [--dvdpassthrough on|off] [--floppy disabled|empty|<uuid>| <filename>|host:<drive>] [--nic<1-N> none|null|nat|bridged|intnet] [--nictype<1-N> Am79C970A|Am79C973] [--cableconnected<1-N> on|off] [--nictrace<1-N> on|off] [--nictracefile<1-N> <filename>] [--nicspeed<1-N> <kbps>] [--bridgeadapter<1-N> none|<devicename>] [--intnet<1-N> <network name>] [--natnet<1-N> <network>|default] [--macaddress<1-N> auto|<mac>] [--uart<1-N> off|<I/O base> <IRQ>] [--uartmode<1-N> disconnected| server <pipe>| client <pipe>| <devicename>] [--gueststatisticsinterval <seconds>] [--audio none|null|dsound|solaudio|oss|coreaudio] [--audiocontroller ac97|sb16] [--clipboard disabled|hosttoguest|guesttohost| bidirectional] [--vrdp on|off] [--vrdpport default|<port>] [--vrdpaddress <host>] [--vrdpauthtype null|external|guest] [--vrdpmulticon on|off] [--vrdpreusecon on|off] [--usb on|off] [--usbehci on|off] [--snapshotfolder default|<path>] VBoxManage import <ovf> [--dry-run|-n] [more options] (run with -n to have options displayed for a particular OVF) VBoxManage export <machines> --output|-o <ovf> [--legacy09] [--vsys <number of virtual system>] [--product <product name>] [--producturl <product url>] [--vendor <vendor name>] [--vendorurl <vendor url>] [--version <version info>] [--eula <license text>] [--eulafile <filename>] VBoxManage startvm <uuid>|<name> [--type gui|vrdp] VBoxManage controlvm <uuid>|<name> pause|resume|reset|poweroff|savestate| acpipowerbutton|acpisleepbutton| keyboardputscancode <hex> [<hex> ...]| injectnmi| setlinkstate<1-4> on|off | usbattach <uuid>|<address> | usbdetach <uuid>|<address> | dvdattach none|<uuid>|<filename>|host:<drive> | floppyattach none|<uuid>|<filename>|host:<drive> | vrdp on|off] | setvideomodehint <xres> <yres> <bpp> [display]| setcredentials <username> <password> <domain> [--allowlocallogon <yes|no>] VBoxManage discardstate <uuid>|<name> VBoxManage adoptstate <uuid>|<name> <state_file> VBoxManage snapshot <uuid>|<name> take <name> [--description <desc>] | discard <uuid>|<name> | discardcurrent --state|--all | edit <uuid>|<name>|--current [--name <name>] [--description <desc>] | showvminfo <uuid>|<name> VBoxManage openmedium disk|dvd|floppy <filename> [--type normal|immutable|writethrough] (disk only) VBoxManage closemedium disk|dvd|floppy <uuid>|<filename> VBoxManage showhdinfo <uuid>|<filename> VBoxManage createhd --filename <filename> --size <megabytes> [--format VDI|VMDK|VHD] (default: VDI) [--variant Standard,Fixed,Split2G,Stream,ESX] [--type normal|writethrough] (default: normal) [--comment <comment>] [--remember] VBoxManage modifyhd <uuid>|<filename> [--type normal|writethrough|immutable] [--autoreset on|off] [--compact] VBoxManage clonehd <uuid>|<filename> <outputfile> [--format VDI|VMDK|VHD|RAW|<other>] [--variant Standard,Fixed,Split2G,Stream,ESX] [--type normal|writethrough|immutable] [--remember] VBoxManage convertfromraw <filename> <outputfile> [--format VDI|VMDK|VHD] [--variant Standard,Fixed,Split2G,Stream,ESX] VBoxManage convertfromraw stdin <outputfile> <bytes> [--format VDI|VMDK|VHD] [--variant Standard,Fixed,Split2G,Stream,ESX] VBoxManage addiscsidisk --server <name>|<ip> --target <target> [--port <port>] [--lun <lun>] [--encodedlun <lun>] [--username <username>] [--password <password>] [--type normal|writethrough|immutable] [--comment <comment>] [--intnet] VBoxManage getextradata global|<uuid>|<name> <key>|enumerate VBoxManage setextradata global|<uuid>|<name> <key> [<value>] (no value deletes key) VBoxManage setproperty hdfolder default|<folder> | machinefolder default|<folder> | vrdpauthlibrary default|<library> | websrvauthlibrary default|null|<library> | hwvirtexenabled yes|no loghistorycount <value> VBoxManage usbfilter add <index,0-N> --target <uuid>|<name>|global --name <string> --action ignore|hold (global filters only) [--active yes|no] (yes) [--vendorid <XXXX>] (null) [--productid <XXXX>] (null) [--revision <IIFF>] (null) [--manufacturer <string>] (null) [--product <string>] (null) [--remote yes|no] (null, VM filters only) [--serialnumber <string>] (null) [--maskedinterfaces <XXXXXXXX>] VBoxManage usbfilter modify <index,0-N> --target <uuid>|<name>|global [--name <string>] [--action ignore|hold] (global filters only) [--active yes|no] [--vendorid <XXXX>|""] [--productid <XXXX>|""] [--revision <IIFF>|""] [--manufacturer <string>|""] [--product <string>|""] [--remote yes|no] (null, VM filters only) [--serialnumber <string>|""] [--maskedinterfaces <XXXXXXXX>] VBoxManage usbfilter remove <index,0-N> --target <uuid>|<name>|global VBoxManage sharedfolder add <vmname>|<uuid> --name <name> --hostpath <hostpath> [--transient] [--readonly] VBoxManage sharedfolder remove <vmname>|<uuid> --name <name> [--transient] VBoxManage vmstatistics <vmname>|<uuid> [--reset] [--pattern <pattern>] [--descriptions] VBoxManage metrics list [*|host|<vmname> [<metric_list>]] (comma-separated) VBoxManage metrics setup [--period <seconds>] [--samples <count>] [--list] [*|host|<vmname> [<metric_list>]] VBoxManage metrics query [*|host|<vmname> [<metric_list>]] VBoxManage metrics collect [--period <seconds>] [--samples <count>] [--list] [--detach] [*|host|<vmname> [<metric_list>]] VBoxManage dhcpserver add|modify --netname <network_name> | [--ip <ip_address> --netmask <network_mask> --lowerip <lower_ip> --upperip <upper_ip>] [--enable | --disable] VBoxManage dhcpserver remove --netname <network_name> |
В каждом вызове VBoxManage, может быть выполнена только одна команда. Однако, команды могут иметь несколько различных подкоманд, которые выполняются в одном вызове. Следующий раздел детально описывает различные команды.
Команда list
предоставляет важную информацию о вашей системе и текущих настройках VirtualBox.
Доступны следующие подкоманды для VBoxManage list
:
vms
отображает список всех виртуальных машин зарегистрированных в VirtualBox. По умолчанию показывается компактный список в две колонки: имя ВМ и UUID; если вы укажите параметр --long
или -l
, то будет показан детальный список настроек ВМ, как при выводе команды showvminfo
(см. далее).
runningvms
отображает список всех работающих виртуальных машин с их UUIDs в таком же формате, что и в vms
.
hdds
, dvds
и floppies
предоставляют вам информацию о всех зарегистрированных в VirtualBox образах виртуальных носителей, включая их свойства: UUID и имя файла.
ostypes
отображает список гостевых операционных систем "известных" VirtualBox, с идентификатором типа используемым в команде modifyvm
.
hostdvds
, hostfloppies
и hostifs
отображает список DVD, дискет и сетевых интерфейсов хоста с именами используемых в VirtualBox.
usbhost
отображает информацию о устройствах USB подключенных к хосту, данная информация будет полезна при настройке фильтров USB и не зависит от их текущего использования на хосте.
usbfilters
отображает список всех фильтров USB зарегистрированных в VirtualBox, которые можно использовать в виртуальных машинах, а также параметры фильтров.
systemproperties
показывает некоторые глобальные настройки VirtualBox, такие как минимальный и максимальный объем памяти гостя, максимальный размер виртуального жесткого диска, пути к файлам настроек и текущая используемая библиотека аутентификации.
hddbackends
доступные типы используемых виртуальных дисков (backends) в VirtualBox. Кроме имени типа, показывается информация о capabilities, настройке и другая нужная информация.