BCDEdit /hypervisorsettings

Der Befehl /hypervisorsettings legt die Hypervisordebuggereinstellungen für das System fest oder zeigt diese an.

Um eine einzelne Hypervisordebuggereinstellung festzulegen, verwenden Sie bcdedit /set {hypervisorsettings} <type> <value>. Weitere Informationen zum Set-Befehl finden Sie unter BCDEdit /set.

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

<debugtype> : Gibt den Typ des Debuggers an. <Der Debugtyp> kann einer von NET, SERIAL oder 1394 sein, wie unten beschrieben.

Hinweis

Vor dem Festlegen von BCDEdit-Optionen müssen Sie möglicherweise BitLocker und den sicheren Start auf dem Computer deaktivieren oder anhalten.

Netzwerkdebuggen

<debugtype>NET
Gibt eine Ethernet-Netzwerkverbindung zum Debuggen an. Wenn diese Option verwendet wird, muss die OPTION HOSTIP auch durch Angabe der IPv4-Adresse des Hostdebuggers festgelegt werden.

HOSTIP:<ip> Die IP-Adresse wird nur verwendet, wenn der HypervisordebugtypeNet ist. Gibt zum Debuggen des Hypervisors über eine Netzwerkverbindung die IPv4-Adresse des Hostdebuggers an.

PORT:<port> Gibt für das Netzwerkdebuggen den Port an, mit dem im Hostdebugger kommuniziert werden soll. Sollte 49152 oder höher sein.

BUSPARAMS:<Bus.Device.Function> Definiert die PCI-Bus-, Geräte- und Funktionsnummern des Debuggeräts. Beispielsweise beschreibt 0.25.0 das Debuggerät auf Bus 0, Gerät 25, Funktion 0. Diese Werte werden in Geräte-Manager unter Speicherort auf der Registerkarte Allgemein angezeigt.

Beispiel für das Netzwerkdebuggen

Der folgende Befehl legt die Hypervisordebuggereinstellungen auf Netzwerkdebuggen mit einem Debuggerhost auf 192.168.1.2 fest, der an Port 50000 kommuniziert:

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

Verwenden Sie den schlüssel, der zurückgegeben wird, um eine Verbindung mit dem Ziel herzustellen.

Diese Netzwerkdebugeinstellungen können mit dem Befehl BCDEdit /set geändert werden.

hypervisorhostipIP-Adresse (wird nur verwendet, wenn der HypervisordebugtypeNet ist.) Gibt zum Debuggen des Hypervisors über eine Netzwerkverbindung die IPv4-Adresse des Hostdebuggers an. Informationen zum Debuggen von Hyper-V finden Sie unter Erstellen eines virtuellen Computers mit Hyper-V.

hypervisorhostport [ port ]
(Wird nur verwendet, wenn der HypervisordebugtypeNet ist.) Gibt für das Netzwerkdebuggen den Port an, mit dem im Hostdebugger kommuniziert werden soll. Sollte 49152 oder höher sein.

hypervisorbusparamsBus.Device.Function
Definiert die PCI-Bus-, Geräte- und Funktionsnummern des Debuggeräts. Beispielsweise beschreibt 0.25.0 das Debuggerät auf Bus 0, Gerät 25, Funktion 0. Diese Werte werden in Geräte-Manager unter Speicherort auf der Registerkarte Allgemein angezeigt.

hypervisorusekey<key> (Wird nur verwendet, wenn hypervisordebugtypeNet ist.) Für das Netzwerkdebuggen gibt den Schlüssel an, mit dem die Verbindung verschlüsselt werden soll. [0-9] und [a-z] sind nur zulässig.

hypervisordhcp [ ja | nein ]
Steuert die Verwendung von DHCP durch den Netzwerkdebugger, der mit dem Hypervisor verwendet wird. Wenn Sie dies auf "no" festlegen, wird die Verwendung der automatischen privaten IP-Adressierung (APIPA) erzwungen, um eine IP-Adresse für einen lokalen Link abzurufen.

Serielles Debuggen

<debugtype>Serial
Gibt eine serielle Verbindung zum Debuggen an. Wenn die Option Serial angegeben ist, legen Sie auch die Optionen hypervisordebugport und hypervisorbaudrate fest.

DEBUGPORT:<port> Gibt den seriellen Port an, der als Debugport verwendet werden soll.

BAUDRATE:<baud> Gibt für seriales Debuggen die Baudrate an, die für das Debuggen verwendet werden soll.

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

Beispiel für serielles Debuggen

Der folgende Befehl zeigt die aktuellen Hypervisoreinstellungen an.

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

Der folgende Befehl legt die Hypervisordebuggereinstellungen auf serielles Debuggen über COM1 auf 115.200 Baud fest.

bcdedit /hypervisorsettings SERIAL DEBUGPORT:1 BAUDRATE:115200

1394 Debuggen

Wichtig

Der Transport 1394 ist für die Verwendung in Windows 10, Version 1607 und früher verfügbar. Es ist in höheren Versionen von Windows nicht verfügbar. Sie sollten Ihre Projekte auf andere Transporte umstellen, z. B. KDNET mit Ethernet.

<debugtype>1394
Gibt eine IEEE 1394-Verbindung (FireWire) für das Debuggen an. Wenn diese Option verwendet wird, sollte auch die Kanaloption festgelegt werden.

CHANNEL:<channel>

Gibt für 1394-Debuggen den 1394-Kanal an, der für das Debuggen verwendet werden soll.

Die folgende zugehörige Option sollte mit dem Befehl BCDEdit /set festgelegt werden.

hypervisorbusparamsBus.Device.Function
Definiert die PCI-Bus-, Geräte- und Funktionsnummern des Debuggeräts. Beispielsweise beschreibt 1.5.0 das Debuggerät auf Bus 1, Gerät 5, Funktion 0. Diese Werte werden in Geräte-Manager unter Speicherort auf der Registerkarte Allgemein angezeigt.

Kommentare

Mit diesem Befehl wird der Hypervisordebugger für einen bestimmten Betriebssystemladeprogrammeintrag nicht aktiviert oder deaktiviert. Verwenden Sie bcdedit /set <identifier> HYPERVISORDEBUG ON, um den Hypervisordebugger für einen bestimmten Betriebssystemladeprogrammeintrag zu aktivieren.

Um Informationen zu Bezeichnern zu erhalten, führen Sie "bcdedit /? ID".

Weitere Informationen

BCDEdit /set-Befehl .

BCDEdit-Optionen – Referenz