【转】VBoxManage命令详解

Maclean Liu(刘相兵

VBoxManage命令详解



VBoxManage[-v|-version]        显示virtualbox的版本号
VBoxManage-nologo              隐藏logo
VBoxManage-convertSettings      允许自动转换设置文件
VBoxManage-convertSettingsBackup  允许自动转换设置文件，并在转换前作备份
VBoxManage-convertSettingsIgnore  允许自动转换设置文件，但是不保存结果

VBoxManagelist vms|runningvms   显示列表虚拟机|正在运行的虚拟机
               |ostypes|hostdvdsvirtualbox支持的系统类型|宿主机的光盘驱动器
              |hostfloppies    宿主机的软盘驱动器
              |hostifs|hostinfo宿主机的网络接口|宿主机的信息
               |hdds|dvds       已注册的虚拟硬盘|已注册的虚拟光盘
               |floppies|usbhost已注册的虚拟软盘|宿主机的USB设备
              |usbfilters      USB筛选器
              |systemproperties 虚拟机的基本信息

VBoxManageshowvminfo <uuid>|<name>    显示指定虚拟机的信息
                    [-details]        显示详细信息
                    [-statistics]     显示统计信息
                     [-machinereadable] 以清晰的格式显示虚拟机信息

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

VBoxManageunregistervm <uuid>|<name>   从虚拟机列表清除指定的虚拟机
                       [-delete]       从虚拟机列表删除指定的虚拟机

VBoxManagecreatevm     -name <name>    创建指定名称的虚拟机
                       [-register]      将创建的虚拟机添加到列表
                       [-basefolder <path> 指定虚拟机的基础目录
                        [-settingsfile<path>] 指定虚拟机配置文件的基础目录
                       [-uuid <uuid>]  创建指定uuid的虚拟机

VBoxManagemodifyvm     <uuid|name>      编辑指定的虚拟机的配置
                       [-name <name>]   修改虚拟机的名称
                        [-ostype<ostype>]修改虚拟机的操作系统类型
                        [-memory<memorysize>]   修改虚拟机的内存大小
                        [-vram<vramsize>]       修改虚拟机的显存大小
                        [-acpion|off]          启动或禁止acpi电源管理接口
                        [-ioapicon|off]         启动或禁止I/OAPIC电源管理接口
                        [-paeon|off]           启动或禁止CPU的PAE支持，PAE是
Physical Address Extension : 物理地址扩展
                        [-hwvirtexon|off|default]启动或禁止CPU的硬件虚拟化支持
                       [-nestedpaging on|off]   开启或关闭CPU的嵌套页面列表支持
                       [-monitorcount <number>] 设置显示器数目，VRDP多用户模式时                       
[-bioslogofadeinon|off]  开启或关闭bioslogo渐显效果
                        [-bioslogofadeouton|off] 开启或关闭bioslogo渐隐效果
                        [-bioslogodisplaytime<msec>]设置bioslogo显示时间（以毫秒为单位)
                        [-bioslogoimagepath<imagepath>]设置bioslogo图像路径，用于自定义bioslogo
                        [-biosbootmenudisabled| 设置是否显示bios启动菜单关闭
                                      menuonly| 只菜单
                                      messageandmenu] 信息和菜单
                        [-biossystemtimeoffset<msec>] 设置bios系统时间补偿（以毫秒为单位）
                        [-biospxedebugon|off] 打开或关闭biospxe调试
                        [-boot<1-4>none|floppy|dvd|disk|net>] 设置启动顺序
                        [-hd<a|b|d>none|<uuid>|<filename>]为虚拟机添加三个IDE设备之一（第2个主盘被vm保留作为光驱，不能占用）在三个IDE中，你可以指定（硬盘）的vdi文件名或者它的UUID
                        [-idecontrollerPIIX3|PIIX4] 设置IDE控制器的类型
                        [-sataon|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光驱
                        [-dvdpassthroughon|off]打开|关闭虚拟机里光盘的刻录功能
                        [-floppydisabled| 不连接软驱
                                           empty| 连接软驱但不插入软盘
                                           <uuid>|指定UUID的软驱连接
                                               <filename>|将指定的软盘映像文件挂接到软驱驱
                                            host:<drive>]将宿主机的软驱驱挂接到虚拟机的软驱
                       [-nic<1-N> none| 虚拟机不添加网卡
                                           null|虚拟机有网卡但不连接
                                                   nat| 网络连接使用NAT模式
                                                hostif| 网络连接使用桥接模式
                                                intnet] 网络连接使用内部网络模式
                        [-nictype<1-N>Am79C970A| 虚拟机连接AMDPCNet PCI II网卡
                                               Am79C973| 虚拟机连接AMDPCNet FAST III网卡（默认）
                                        82540EM| 虚拟机连接IntelPRO/1000 MT Desktop网卡
                                        82543GC] 虚拟机连接IntelPRO/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/Obase> <IRQ>]启用虚拟串口，并设置虚拟串口的I/O参数和IRQ参数
                       [-uartmode<1-N> disconnected|启用虚拟串口，但不连接到宿主机的串口
                                      server <pipe>|在宿主机创建PIPE通道，并将虚拟机串口连接到这个通道
                                       client<pipe>| 不创建PIPE通道，而是将虚拟机串口连接到已存在的通道
                                      <devicename>] 将虚拟机串口连接到宿主机的串口
                       [-gueststatisticsinterval <seconds>]配置虚拟机静态时间间隔
                       [-audio none| 虚拟机不连接声卡
                                                       null|将虚拟机的声卡连接到空的声音设备
                                                     dsound] 将虚拟机的声卡连接到宿主机的声卡
                       [-audiocontroller ac97| 将虚拟机声卡虚拟为ICHAC97声卡
                                                 sb16]将虚拟机声卡虚拟为soundblaster16声卡
                       [-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断线重连
                        [-usbon|off] 打开|关闭虚拟USB控制器
                       [-usbehci on|off] 打开|关闭虚拟USB2.0控制器
                       [-snapshotfolder default| 将系统快照保存到默认文件夹
                                         <path>] 将系统快照保存到指定文件夹

VBoxManagestartvm      <uuid>|<name>开启指定UUID|名称的虚拟机
                        [-typegui|vrdp] 设置虚拟机标准显示设备GUI界面|VRDP

VBoxManagecontrolvm    <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设备   
               dvdattachnone| 不连接虚拟DVD光驱
                       <uuid>|连接到指定UUID的DVD光驱
                  <filename>| 连接到指定名称的DVD映像文件
                 host:<drive> 连接到宿主机的DVD光驱
               floppyattachnone| 不连接虚拟软驱
                         <uuid>| 连接到指定UUID的虚拟软驱
                     <filename>| 连接到指定名称的软盘映像文件
                    host:<drive> 连接到宿主机的软驱

               setvideomodehint<xres> 设置虚拟机的屏幕分辨率水平像素
                               <yres> 垂直像素
                                <bpp> 颜色深度
                            [display] 刷新频率
               setcredentials<username> 指定VRDP自动连接参数用户名
                              <password>密码
                               <domain> 域
             [-allowlocallogon<yes|no>] 允许|禁止本地登陆

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

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

VBoxManagesnapshot        <uuid>|<name> 为指定的虚拟机拍快照
                           take <name> 为快照取名
                        [-desc<desc>]| 给快照添加描述
                       discard <uuid>|<name> |丢弃指定的快照
                       discardcurrent -state| 恢复到最近的快照
                                       -all | 恢复到倒数第二个快照
                       edit <uuid>|<name>| 编辑指定的快照
                                  -current 编辑当前快照
                          [-newname<name>] 修改快照名称
                          [-newdesc<desc>] 修改快照描述
                       showvminfo <uuid>|<name>显示快照的虚拟机信息

VBoxManageregisterimage    disk|dvd|floppy <filename>注册硬盘、光盘、软盘映像文件
[-type normal|注册为普通类型（可创建快照，可读写）
immutable|注册为只读类型（相当于加了硬盘卡）
writethrough]注册为可写类型（这种类型不能创建快照）
(disk only)(注册类型选项只适用于硬盘）

VBoxManageunregisterimage  disk| 从虚拟介质管理器删除指定的硬盘
dvd|从虚拟介质管理器删除指定的DVD光盘
floppy从虚拟介质管理器删除指定的软盘
<uuid>|删除时指定UUID
<filename>删除时指定映像文件

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


VBoxManagecreatevdi        -filename<filename> 创建指定名称的虚拟硬盘
                           -size <megabytes> 指定虚拟硬盘的大小（以兆为单位）
                           [-static] 创建固定大小的虚拟硬盘
                           [-comment <comment>] 添加一段解释性文字
                           [-register] 注册新创建的虚拟硬盘
                           [-type normal| 注册类型普通（可以创建快照）
                             writethrough]注册类型 可写（不能创建快照）
                         (default: normal) 默认是普通类型
VBoxManagemodifyvdi        <uuid>|<filename>compact 压缩指定的虚拟硬盘

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

VBoxManageconvertdd        [-static]<filename> <outputfile> 将raw硬盘转换成vdi虚拟硬盘
VBoxManageconvertdd        [-static] stdin<outputfile> <bytes> 将标准输入参数指定的设备转换成vdi虚拟硬盘，比如：ddif=/dev/sda1 | VBoxManage convertdd stdin /media/disk/C.vdi62277025792

VBoxManage命令详解（二）
VBoxManageaddiscsidisk     -server <name>|<ip>通过指定服务器名称|ip地址添加ISCSI硬盘
                           -target <target> 指定对象名称字符串
                           [-port <port>] 指定ISCSI对象的服务端口号
                           [-lun <lun>] 指定对象资源的逻辑单元编号
                           [-encodedlun <lun>]指定另一种格式的对象资源的逻辑单元编号
                           [-username <username>]指定连接ISCSI对象的用户名
                           [-password <password>]指定连接ISCSI对象所需的密码
                           [-comment <comment>] 为这个连接添加一段描述性文字
比如：VBoxManageaddiscsidisk -server 10.200.2.30 -targetiqn.2000-12.com.acme:storage.lun0 -lun 0

VBoxManagecreatehostif     <name> 在宿主机添加一个指定名称的虚拟网络接口
VBoxManageremovehostif     <uuid>|<name>从宿主机删除指定UUID|名称的虚拟网络接口

VBoxManagegetextradata     global| 获取全局设置信息
                            <uuid>|获取指定UUID的虚拟机的信息
                           <name>  获取指定名称的虚拟机的信息
                           <key>|  获取与指定键值相关联的数据信息
                         enumerate 列举信息
比如：VBoxManagegetextradata xp installdate 用于获取虚拟机XP的安装时间

VBoxManagesetextradata     global| 设置全局信息
                           <uuid>| 设置指定UUID的虚拟机的信息
                            <name>设置指定名称的虚拟机的信息
                            <key> 指定要添加信息的键
                         [<value>]给上面的键添加键值（必须指定键值）
比如：VBoxManagesetextradata xp installdate 2006.01.01 设置虚拟机xp的安装时间为2006年1月1日

VBoxManagesetproperty      vdifolder default|在全局设定里设置vdi目录为默认
                                   <folder> | 在全局设定里设置指定vdi目录
                       machinefolder default| 在全局设定里设置虚拟机目录为默认
                                   <folder> | 在全局设定里指定虚拟机目录
                      vrdpauthlibrarydefault| 在全局设定里设置VRDP证书为默认的证书
                                   <library>| 在全局设定里指定其他的VRDP证书
                    websrvauthlibrarydefault| 在全局设定里设置Web服务证书为默认的证书
                                        null| 在全局设定里设置web服务证书为空
                                   <library>|在全局设定里指定其他的Web服务证书
                       hwvirtexenabled yes|no 在全局设定里设置是|否支持硬件虚拟化
                       loghistorycount<value> 在全局设定里设置日志数目，编号从0开始

VBoxManageusbfilter        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>]

VBoxManageusbfilter        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>|""]

VBoxManageusbfilter        remove<index,0-N> 删除指定序号的usb筛选器
                              -target <uuid>| 删除指定UUID的虚拟机的usb筛选器
                                      <name>| 删除指定名称的虚拟机的usb筛选器
                                       global 删除全局usb筛选器


VBoxManagesharedfolder     add <vmname>|添加共享文件夹到指定名称的虚拟机
                                   <uuid>添加共享文件夹到指定uuid的虚拟机
                            -name <name> 指定共享文件夹名称
                    -hostpath <hostpath>指定共享文件夹所在的主机路径
                            [-transient] 设置临时共享
                             [-readonly] 设置共享为只读

VBoxManagesharedfolder  remove <vmname>| 从指定名称的虚拟机删除共享文件夹
                                   <uuid>从指定UUID的虚拟机删除共享文件夹
                            -name <name> 删除指定名称的共享文件夹
                            [-transient] 临时删除

VBoxManagevmstatistics        <vmname>| 统计指定名称的虚拟机的运行状态信息
                                   <uuid>统计指定UUID的虚拟机的运行状态信息
                                 [-reset]复位统计信息
                     [-pattern<pattern>] 设置信息的显示格式
                         [-descriptions] 在统计信息中显示描述信息


VBoxManageguestproperty    get <vmname>|获取指定名称的虚拟机的预先设定的属性值
                                  <uuid>获取指定UUID的虚拟机的预先设定的属性值
                              <property> 获取指定属性的预先设定的值
                              [-verbose] 以冗长的格式显示


VBoxManageguestproperty    set <vmname>| 给指定名称的虚拟机设置属性值
                                  <uuid>给指定UUID的虚拟机设置属性值
                              <property> 要设定值的属性
                                [<value> 给属性设定的值
                       [-flags <flags>]] 设置一个标志

VBoxManageguestproperty    enumerate <vmname>|列举指定名称的虚拟机的属性值
                                       <uuid>  列举指定UUID的虚拟机的属性值
                       [-patterns <patterns>] 列举属性值时采用的格式
VBoxManagemetrics             list [*| 显示性能计数器
收集的所有系统资源的监测数据
                              host| 显示性能计数器
收集的宿主机的系统资源的监测数据
                           <vmname> 显示性能计数器
收集的虚拟机的系统资源的监测数据
                   [<metric_list>]] 要显示的性能计数器列表

VBoxManagemetrics          setup设置性能计数器
                           [-period <seconds>] 设置性能计数器的显示周期
                           [-samples <count>] 设置性能计数器抽样统计数
                           [*| 对所有资源设置设置性能计数器
                         host| 对宿主机资源设置设置性能计数器
                       <vmname>对虚拟机资源设置设置性能计数器
              [<metric_list>]] 性能计数器列表
例如：VBoxManagemetrics setup -period 1 -samples 5 host CPU/Load,RAM/Usage

VBoxManagemetrics  query [*| 查找并显示所有资源当前的性能计数器
                       host| 查找并显示宿主机当前的资源的性能计数器
                    <vmname> 查找并显示虚拟机当前的资源的性能计数器
            [<metric_list>]] 性能计数器列表
例如：VBoxManagequery host CPU/Load/User,CPU/Load/Kernel

VBoxManagemetrics     collect 收集性能计数器信息
                       [-period<seconds>] 设置性能计数器信息显示的刷新周期
                       [-samples<count>] 设置性能计数器抽样统计数
                       [-list]显示当前可以收集信息的性能计数器
                       [-detach]
                       [*|收集所有系统资源的性能计数器信息
                    host| 收集宿主机资源的性能计数器信息
                  <vmname>收集虚拟机资源的性能计数器信息
         [<metric_list>]] 性能计数器列表