BCDEdit /hypervisorsettings

项目
07/08/2024

/hypervisorsettings 命令集或显示系统的虚拟机监控程序调试程序设置。

若要设置单个虚拟机监控程序调试程序设置，请使用 bcdedit /set {hypervisorsettings} <type> <value>。有关 set 命令的详细信息，请参阅 BCDEdit /set。

bcdedit /hypervisorsettings [ <debugtype> [DEBUGPORT:<port>] [BAUDRATE:<baud>] [CHANNEL:<channel>] [HOSTIP:<ip>] [PORT:<port>] [BUSPARAMS:<Bus.Device.Function>] ]

<debugtype> - 指定调试器的类型。 <debugtype> 可以是 NET、SERIAL 或 1394 之一，如下所示。

注意

设置 BCDEdit 选项之前，可能需要禁用或暂停计算机上的 BitLocker 和安全启动。

网络调试

<debugtype>NET
指定用于调试的以太网网络连接。使用此选项时， 还必须通过指定主机调试器的 IPv4 地址来设置 HOSTIP 选项。

HOSTIP：<ip> 仅在虚拟机监控程序为 Net 时才使用 IP 地址。若要通过网络连接调试虚拟机监控程序，请指定主机调试器的 IPv4 地址。

端口：<端口> 对于网络调试，指定要在主机调试器上进行通信的端口。必须是 49152 或以上。

BUSPARAMS：<Bus.Device.Function> 定义调试设备的 PCI 总线、设备和函数编号。例如，0.25.0 描述总线 0、设备 25、函数 0 上的调试设备。这些值显示在“常规”选项卡上的“位置”下的设备管理器中。

网络调试示例

以下命令在端口 50000 上通过调试器主机 192.168.1.2 将虚拟机监控程序调试程序设置设置为网络调试：

C:\> bcdedit /hypervisorsettings NET HOSTIP:192.168.1.2 PORT:50000 BUSPARAMS:0.25.0
Key=2steg4fzbj2sz.23418vzkd4ko3.1g34ou07z4pev.1sp3yo9yz874p

使用返回的密钥连接到目标。

可以使用 BCDEdit /set 命令修改这些网络调试设置。

虚拟机监控程序hostip IP 地址（仅在虚拟机监控程序debugtype 为 Net 时使用）若要通过网络连接调试虚拟机监控程序，请指定主机调试器的 IPv4 地址。有关对 Hyper-V 进行调试的信息，请参阅使用 Hyper-V 创建虚拟机。

hypervisorhostport [ 端口 ]
（仅在虚拟机监控程序为 Net 时使用）对于网络调试，指定要在主机调试器上通信的端口。必须是 49152 或以上。

hypervisorbusparams Bus.Device.Function
定义调试设备的 PCI 总线、设备和功能号。例如，0.25.0 描述总线 0、设备 25、函数 0 上的调试设备。这些值显示在“常规”选项卡上的“位置”下的设备管理器中。

虚拟机监控程序密钥<>（仅当虚拟机监控程序debugtype 为 Net 时使用）对于网络调试，指定用于加密连接的密钥。 [0-9] 和 [a-z] 仅允许。

hypervisordhcp [ 是 | 否 ]
控制虚拟机监控程序所使用的网络调试器使用 DHCP。将此选项设置为不强制使用自动专用 IP 地址 (APIPA) 获取本地链接 IP 地址。

串行调试

<debugtype>Serial
指定用于调试的串行连接。指定“串行”选项时，还可以设置 hypervisordebugport 和 hypervisorbaudrate 选项。

DEBUGPORT：<port> For SERIAL debug，指定要用作调试端口的串行端口。

BAUDRATE：<baud> 对于串行调试，指定要用于调试的波特率。

bcdedit /set hypervisordebugtype serial
bcdedit /set hypervisordebugport 1
bcdedit /set hypervisorbaudrate 115200
bcdedit /set hypervisordebug on
bcdedit /set hypervisorlaunchtype auto

串行调试示例

以下命令显示当前的虚拟机监控程序设置。

C:\>bcdedit /hypervisorsettings
isolatedcontext         Yes
hypervisordebugtype     Serial
hypervisordebugport     1
hypervisorbaudrate      115200
The operation completed successfully.

以下命令将虚拟机监控程序调试程序设置设置为在 115,200 波特处通过 COM1 进行串行调试。

bcdedit /hypervisorsettings SERIAL DEBUGPORT:1 BAUDRATE:115200

1394 调试

重要

1394 传输可用于 Windows 10 版本 1607 及更低版本。它在 Windows 的更高版本中不可用。应将项目转换为其他传输，例如使用以太网的 KDNET。

<debugtype>1394
指定用于调试的 IEEE 1394 (FireWire) 连接。使用此选项时， 还应设置通道 选项。

CHANNEL：<channel>

对于 1394 调试，指定要用于调试的 1394 通道。

应使用 BCDEdit /set 命令设置以下相关选项。

hypervisorbusparams Bus.Device.Function
定义调试设备的 PCI 总线、设备和功能号。例如，1.5.0 描述调试设备的总线 1、设备 5、功能 0。这些值显示在“常规”选项卡上的“位置”下的设备管理器中。

此命令不会为任何特定的 OS 加载程序条目启用或禁用虚拟机监控程序调试程序。若要为特定 OS 加载程序条目启用虚拟机监控程序调试程序，请使用 bcdedit /set <identifier> HYPERVISORDEBUG ON。

有关标识符的信息，请运行“bcdedit /？ ID”。

另请参阅

BCDEdit /set 命令。

BCDEdit 选项参考

通过