VBoxManage命令详解

转自：http://zhang-ly520.iteye.com/blog/300606

由于最近工作对vbox有一定涉猎，发现这个写的比较好，先转来，稍有空时再根据自己的心得整理一下。

VBoxManage [-v|-version] 显示virtualbox的版本号

VBoxManage -nologo 隐藏logo

VBoxManage -convertSettings 允许自动转换设置文件

VBoxManage -convertSettingsBackup 允许自动转换设置文件，并在转换前作备份

VBoxManage -convertSettingsIgnore 允许自动转换设置文件，但是不保存结果

VBoxManage list vms|runningvms 显示列表虚拟机|正在运行的虚拟机

|ostypes|hostdvds virtualbox支持的系统类型|宿主机的光盘驱动器

|hostfloppies 宿主机的软盘驱动器

|floppies|usbhost 已注册的虚拟软盘|宿主机的USB设备

|usbfilters USB筛选器

|systemproperties 虚拟机的基本信息

VBoxManage showvminfo <uuid>|<name> 显示指定虚拟机的信息

[-details] 显示详细信息

[-statistics] 显示统计信息

[-machinereadable] 以清晰的格式显示虚拟机信息

VBoxManage registervm <filename> 将指定文件所在的虚拟机添加到列表

VBoxManage unregistervm <uuid>|<name> 从虚拟机列表清除指定的虚拟机

[-delete] 从虚拟机列表删除指定的虚拟机

VBoxManage createvm -name <name> 创建指定名称的虚拟机

[-register] 将创建的虚拟机添加到列表

[-basefolder <path> 指定虚拟机的基础目录

[-settingsfile <path>] 指定虚拟机配置文件的基础目录

[-uuid <uuid>] 创建指定uuid的虚拟机

VBoxManage modifyvm <uuid|name> 编辑指定的虚拟机的配置

[-name <name>] 修改虚拟机的名称

[-ostype <ostype>]修改虚拟机的操作系统类型

[-memory <memorysize>] 修改虚拟机的内存大小

[-vram <vramsize>] 修改虚拟机的显存大小

[-acpi on|off] 启动或禁止acpi电源管理接口

[-ioapic on|off] 启动或禁止I/O APIC电源管理接口

[-pae on|off] 启动或禁止CPU的PAE支持，PAE是

Physical Address Extension : 物理地址扩展

[-hwvirtex on|off|default]启动或禁止CPU的硬件虚拟化支持

[-nestedpaging on|off] 开启或关闭CPU的嵌套页面列表支持
[-monitorcount <number>] 设置显示器数目，VRDP多用户模式时 [-bioslogofadein on|off] 开启或关闭bioslogo渐显效果

[-bioslogofadeout on|off] 开启或关闭bioslogo渐隐效果

[-bioslogodisplaytime <msec>]设置bioslogo显示时间（以毫秒为单位)

[-bioslogoimagepath <imagepath>]设置bioslogo图像路径，用于自定义bioslogo

[-biosbootmenu disabled| 设置是否显示bios启动菜单关闭

menuonly| 只菜单

messageandmenu] 信息和菜单

[-biossystemtimeoffset <msec>] 设置bios系统时间补偿（以毫秒为单位）

[-biospxedebug on|off] 打开或关闭biospxe调试

[-boot<1-4> none|floppy|dvd|disk|net>] 设置启动顺序

[-hd<a|b|d> none|<uuid>|<filename>] 为虚拟机添加三个IDE设备之一（第2个主盘被vm保留作为光驱，不能占用）在三个IDE中，你可以指定（硬盘）的vdi文件名或者它的UUID

[-idecontroller PIIX3|PIIX4] 设置IDE控制器的类型

[-sata on|off] 开启或关闭SATA硬盘控制器

[-sataportcount <1-30>] 设置虚拟机最多支持的SATA控制器数目

[-sataport<1-30> none| 没有硬盘连接到SATA控制器

<uuid>| 指定uuid的硬盘连接到SATA控制器

<filename>] 指定文件名的硬盘连接到SATA控制器

[-sataideemulation<1-4> <1-30>] 指定一个SATA设备工作在IDE兼容模式，IDE设备编号是1-4，SATA设备编号是1-30

[-dvd none| 不连接DVD光驱

<uuid>| 指定UUID的DVD光驱连接

<filename>| 将指定的光盘映像文件挂接到DVD光驱

host:<drive>] 将宿主机的DVD光驱挂接到虚拟机的DVD光驱

[-dvdpassthrough on|off]打开|关闭虚拟机里光盘的刻录功能

[-floppy disabled| 不连接软驱

empty| 连接软驱但不插入软盘

<uuid>| 指定UUID的软驱连接

<filename>| 将指定的软盘映像文件挂接到软驱驱

host:<drive>] 将宿主机的软驱驱挂接到虚拟机的软驱

[-nic<1-N> none| 虚拟机不添加网卡

null| 虚拟机有网卡但不连接

nat| 网络连接使用NAT模式

hostif| 网络连接使用桥接模式

intnet] 网络连接使用内部网络模式

[-nictype<1-N> Am79C970A| 虚拟机连接AMD PCNet PCI II网卡

Am79C973| 虚拟机连接AMD PCNet FAST III网卡（默认）

82540EM| 虚拟机连接Intel PRO/1000 MT Desktop网卡

82543GC] 虚拟机连接Intel PRO/1000 T Server网卡

[-cableconnected<1-N> on|off]插入或拔出网线

[-nictrace<1-N> on|off] 开启或关闭网络追踪

[-nictracefile<1-N> <filename>] 将网络流量追踪数据保存到文件

[-nicspeed<1-N> <kbps>] 设置网络连接的速度

[-hostifdev<1-N> none| 不连接到主机网络接口

<devicename>] 桥接模式下连接到指定的主机接口

[-intnet<1-N> <network name>] 内网模式下为虚拟机指定内部网络名称

[-natnet<1-N> <network>| 配置NAT网络接口的地址

default] 默认NAT网络接口的地址是10.0.x.0/24

[-macaddress<1-N> auto| 自动生成虚拟网卡的MAC地址

<mac>] 指定虚拟网卡的MAC地址

[-uart<1-N> off| 不启用虚拟串口

<I/O base> <IRQ>]启用虚拟串口，并设置虚拟串口的I/O参数和IRQ参数

[-uartmode<1-N> disconnected| 启用虚拟串口，但不连接到宿主机的串口

server <pipe>| 在宿主机创建PIPE通道，并将虚拟机串口连接到这个通道

client <pipe>| 不创建PIPE通道，而是将虚拟机串口连接到已存在的通道

<devicename>] 将虚拟机串口连接到宿主机的串口

[-gueststatisticsinterval <seconds>] 配置虚拟机静态时间间隔

[-audio none| 虚拟机不连接声卡

null| 将虚拟机的声卡连接到空的声音设备

dsound] 将虚拟机的声卡连接到宿主机的声卡

[-audiocontroller ac97| 将虚拟机声卡虚拟为ICH AC97声卡

sb16] 将虚拟机声卡虚拟为soundblaster 16声卡

[-clipboard disabled| 不共享剪贴板

hosttoguest| 将宿主机的剪贴板共享给虚拟机

guesttohost| 将虚拟机的剪贴板共享给宿主机

bidirectional] 宿主机和虚拟机共使用一个剪贴板

[-vrdp on|off] 开启|关闭virtualbox内置的VRDP服务器

[-vrdpport default| 使用默认的vrdp端口3389

<port>] 指定vrdp端口

[-vrdpaddress <host>] 指定VRDP主机地址

[-vrdpauthtype null| 不用授权，任何客户机都可以连接到VRDP服务器

external| 只有宿主机的用户才可以连接到VRDP服务器

guest] 只有虚拟机的用户才可以连接到VRDP服务器

[-vrdpmulticon on|off] 打开|关闭VRDP多用户连接模式

[-vrdpreusecon on|off] 打开|关闭VRDP断线重连

[-usb on|off] 打开|关闭虚拟USB控制器

[-usbehci on|off] 打开|关闭虚拟USB2.0控制器

[-snapshotfolder default| 将系统快照保存到默认文件夹

<path>] 将系统快照保存到指定文件夹

VBoxManage startvm <uuid>|<name> 开启指定UUID|名称的虚拟机

[-type gui|vrdp] 设置虚拟机标准显示设备GUI界面|VRDP

VBoxManage controlvm <uuid>|<name> 改变正在运行的虚拟机的状态

pause| 暂停，这时虚拟机窗口显示灰色

resume| 恢复暂停的虚拟机

reset| 复位

poweroff| 强行关闭

acpipowerbutton| 关机

acpisleepbutton| 使虚拟机处于睡眠状态

savestate| 保存状态然后关闭，相当于休眠

keyboardputscancode <hex> [<hex> ...] 键盘扫描码设置

setlinkstate<1-4> on|off 连接|断开网络连接

usbattach <uuid>|<address> 连接到指定UUDI|地址的USB设备

usbdetach <uuid>|<address> 断开指定UUDI|地址的USB设备

dvdattach none| 不连接虚拟DVD光驱

<uuid>| 连接到指定UUID的DVD光驱

<filename>| 连接到指定名称的DVD映像文件

host:<drive> 连接到宿主机的DVD光驱

floppyattach none| 不连接虚拟软驱

<uuid>| 连接到指定UUID的虚拟软驱

<filename>| 连接到指定名称的软盘映像文件

host:<drive> 连接到宿主机的软驱

setvideomodehint <xres> 设置虚拟机的屏幕分辨率水平像素

<yres> 垂直像素

<bpp> 颜色深度

[display] 刷新频率

setcredentials <username> 指定VRDP自动连接参数用户名

<password> 密码

<domain> 域

[-allowlocallogon <yes|no>] 允许|禁止本地登陆

VBoxManage discardstate <uuid>|<name> 丢弃指定UUID|名称的虚拟机的保存状态

VBoxManage adoptstate <uuid>|<name> <state_file> 将虚拟机从指定的保存状态中恢复

VBoxManage snapshot <uuid>|<name> 为指定的虚拟机拍快照

take <name> 为快照取名

[-desc <desc>]| 给快照添加描述

discard <uuid>|<name> | 丢弃指定的快照

discardcurrent -state| 恢复到最近的快照

-all | 恢复到倒数第二个快照

edit <uuid>|<name>| 编辑指定的快照

-current 编辑当前快照

[-newname <name>] 修改快照名称

[-newdesc <desc>] 修改快照描述

showvminfo <uuid>|<name> 显示快照的虚拟机信息

VBoxManage registerimage disk|dvd|floppy <filename> 注册硬盘、光盘、软盘映像文件

[-type normal| 注册为普通类型（可创建快照，可读写）

immutable| 注册为只读类型（相当于加了硬盘卡）

writethrough] 注册为可写类型（这种类型不能创建快照）

(disk only) (注册类型选项只适用于硬盘）

VBoxManage unregisterimage disk| 从虚拟介质管理器删除指定的硬盘

dvd| 从虚拟介质管理器删除指定的DVD光盘

floppy 从虚拟介质管理器删除指定的软盘

<uuid>| 删除时指定UUID

<filename> 删除时指定映像文件

VBoxManage showvdiinfo <uuid>|<filename> 显示指定UUID|名称虚拟硬盘的信息

VBoxManage createvdi -filename <filename> 创建指定名称的虚拟硬盘

-size <megabytes> 指定虚拟硬盘的大小（以兆为单位）

[-static] 创建固定大小的虚拟硬盘

[-comment <comment>] 添加一段解释性文字

[-register] 注册新创建的虚拟硬盘

[-type normal| 注册类型普通（可以创建快照）

writethrough] 注册类型可写（不能创建快照）

(default: normal) 默认是普通类型

VBoxManage modifyvdi <uuid>|<filename> compact 压缩指定的虚拟硬盘

VBoxManage clonevdi <uuid>|<filename> <outputfile> 克隆指定的VDI虚拟硬盘

VBoxManage convertdd [-static] <filename> <outputfile> 将raw硬盘转换成vdi虚拟硬盘

VBoxManage convertdd [-static] stdin <outputfile> <bytes> 将标准输入参数指定的设备转换成vdi虚拟硬盘，比如：dd if=/dev/sda1 | VBoxManage convertdd

=======================================================================

VBoxManage addiscsidisk -server <name>|<ip> 通过指定服务器名称|ip地址添加ISCSI硬盘

-target <target> 指定对象名称字符串

[-port <port>] 指定ISCSI对象的服务端口号

[-lun <lun>] 指定对象资源的逻辑单元编号

[-encodedlun <lun>] 指定另一种格式的对象资源的逻辑单元编号

[-username <username>] 指定连接ISCSI对象的用户名

[-password <password>] 指定连接ISCSI对象所需的密码

[-comment <comment>] 为这个连接添加一段描述性文字

比如：VBoxManage addiscsidisk -server 10.200.2.30 -target iqn.2000-12.com.acme:storage.lun0 -lun 0

VBoxManage createhostif <name> 在宿主机添加一个指定名称的虚拟网络接口

VBoxManage removehostif <uuid>|<name> 从宿主机删除指定UUID|名称的虚拟网络接口

VBoxManage getextradata global| 获取全局设置信息

<uuid>| 获取指定UUID的虚拟机的信息

<name> 获取指定名称的虚拟机的信息

<key>| 获取与指定键值相关联的数据信息

enumerate 列举信息

比如：VBoxManage getextradata xp installdate 用于获取虚拟机XP的安装时间

VBoxManage setextradata global| 设置全局信息

<uuid>| 设置指定UUID的虚拟机的信息

<name> 设置指定名称的虚拟机的信息

<key> 指定要添加信息的键

[<value>] 给上面的键添加键值（必须指定键值）

比如：VBoxManage setextradata xp installdate 2006.01.01 设置虚拟机xp的安装时间为2006年1月1日

VBoxManage setproperty vdifolder default| 在全局设定里设置vdi目录为默认

<folder> | 在全局设定里设置指定vdi目录

machinefolder default| 在全局设定里设置虚拟机目录为默认

<folder> | 在全局设定里指定虚拟机目录

vrdpauthlibrary default| 在全局设定里设置VRDP证书为默认的证书

<library>| 在全局设定里指定其他的VRDP证书

websrvauthlibrary default| 在全局设定里设置Web服务证书为默认的证书

null| 在全局设定里设置web服务证书为空

<library>| 在全局设定里指定其他的Web服务证书

hwvirtexenabled yes|no 在全局设定里设置是|否支持硬件虚拟化

loghistorycount <value> 在全局设定里设置日志数目，编号从0开始

VBoxManage usbfilter add <index,0-N> 添加usb筛选器并设置它在筛选器列表中的位置

-target <uuid>| 添加usb筛选器到指定UUID的虚拟机

<name>| 添加usb筛选器到指定名称的虚拟机

global 添加全局usb筛选器

-name <string> 给usb筛选器指定名称

-action ignore| 不允许虚拟机连接到筛选器

hold 允许虚拟机连接到筛选器（全局筛选器时）

[-active yes|no] 筛选器是|否生效（默认是生效）

[-vendorid <XXXX>] 给usb筛选器指定vendorid（厂商标志）

[-productid <XXXX>] 给usb筛选器指定productid（产品标志号）

[-revision <IIFF>] 给usb筛选器指定revision（修订版本号）

[-manufacturer <string>] 给usb筛选器指定manufacturer（制造商）

[-product <string>] 给usb筛选器指定product（产品标志）

[-remote yes|no] 指定usb筛选器是|否在远程登陆时有效

[-serialnumber <string>] 给usb筛选器指定serialnumber（序列号）

[-maskedinterfaces <XXXXXXXX>]

VBoxManage usbfilter modify <index,0-N> 修改usb筛选器在列表中的顺序

-target <uuid>| 修改指定UUID的虚拟机的usb筛选器

<name>| 修改指定名称的虚拟机的usb筛选器

global 修改全局设置的usb筛选器

[-name <string>] 修改筛选器名称

[-action ignore| 不允许虚拟机连接到筛选器

hold] 允许虚拟机连接到筛选器（全局筛选器时）

[-active yes|no] 筛选器是|否生效（默认是生效）

[-vendorid <XXXX>|""] 给usb筛选器指定vendorid（厂商标志）

[-productid <XXXX>|""] 给usb筛选器指定productid（产品标志号）

[-revision <IIFF>|""] 给usb筛选器指定revision（修订版本号）

[-manufacturer <string>|""] 给usb筛选器指定manufacturer（制造商）

[-product <string>|""] 给usb筛选器指定product（产品标志）

[-remote yes|no] 指定usb筛选器是|否在远程登陆时有效

[-serialnumber <string>|""] 给usb筛选器指定serialnumber（序列号）

[-maskedinterfaces <XXXXXXXX>|""]

VBoxManage usbfilter remove <index,0-N> 删除指定序号的usb筛选器

-target <uuid>| 删除指定UUID的虚拟机的usb筛选器

<name>| 删除指定名称的虚拟机的usb筛选器

global 删除全局usb筛选器

VBoxManage sharedfolder add <vmname>| 添加共享文件夹到指定名称的虚拟机

<uuid> 添加共享文件夹到指定uuid的虚拟机

-name <name> 指定共享文件夹名称

-hostpath <hostpath> 指定共享文件夹所在的主机路径

[-transient] 设置临时共享

[-readonly] 设置共享为只读

VBoxManage sharedfolder remove <vmname>| 从指定名称的虚拟机删除共享文件夹

<uuid> 从指定UUID的虚拟机删除共享文件夹

-name <name> 删除指定名称的共享文件夹

[-transient] 临时删除

VBoxManage vmstatistics <vmname>| 统计指定名称的虚拟机的运行状态信息

<uuid> 统计指定UUID的虚拟机的运行状态信息

[-reset] 复位统计信息

[-pattern <pattern>] 设置信息的显示格式

[-descriptions] 在统计信息中显示描述信息

VBoxManage guestproperty get <vmname>| 获取指定名称的虚拟机的预先设定的属性值

<uuid> 获取指定UUID的虚拟机的预先设定的属性值
<property> 获取指定属性的预先设定的值

[-verbose] 以冗长的格式显示

VBoxManage guestproperty set <vmname>| 给指定名称的虚拟机设置属性值

<uuid> 给指定UUID的虚拟机设置属性值

<property> 要设定值的属性

[<value> 给属性设定的值

[-flags <flags>]] 设置一个标志

VBoxManage guestproperty enumerate <vmname>| 列举指定名称的虚拟机的属性值

<uuid> 列举指定UUID的虚拟机的属性值

[-patterns <patterns>] 列举属性值时采用的格式

VBoxManage metrics list [*| 显示性能计数器

收集的所有系统资源的监测数据

host| 显示性能计数器

收集的宿主机的系统资源的监测数据

<vmname> 显示性能计数器

收集的虚拟机的系统资源的监测数据

[<metric_list>]] 要显示的性能计数器列表

VBoxManage metrics          setup 设置性能计数器
                            [-period <seconds>] 设置性能计数器的显示周期
                            [-samples <count>] 设置性能计数器抽样统计数
                            [*| 对所有资源设置设置性能计数器

host| 对宿主机资源设置设置性能计数器

<vmname> 对虚拟机资源设置设置性能计数器

[<metric_list>]] 性能计数器列表

例如：VBoxManage metrics setup -period 1 -samples 5 host CPU/Load,RAM/Usage

VBoxManage metrics query [*| 查找并显示所有资源当前的性能计数器

host| 查找并显示宿主机当前的资源的性能计数器

<vmname> 查找并显示虚拟机当前的资源的性能计数器

[<metric_list>]] 性能计数器列表

例如：VBoxManage query host CPU/Load/User,CPU/Load/Kernel

VBoxManage metrics     collect 收集性能计数器信息
                       [-period <seconds>] 设置性能计数器信息显示的刷新周期
                       [-samples <count>] 设置性能计数器抽样统计数
                       [-list] 显示当前可以收集信息的性能计数器
       &