BCDEdit /dbgsettings

發行項
02/07/2024

/dbgsettings 選項會設定或顯示電腦的目前全域調試程序設定。若要啟用或停用核心調試程式，請使用 BCDEdit /debug 選項。

注意

設定 BCDEdit 選項之前，您可能需要停用或暫停電腦上的 BitLocker 和安全開機。

bcdedit /dbgsettings NET HOSTIP:ip PORT:port [KEY:key] [nodhcp] [newkey] [/start startpolicy] [/noumex] 

bcdedit /dbgsettings LOCAL [/start startpolicy] [/noumex] 

bcdedit /dbgsettings SERIAL [DEBUGPORT:port] [BAUDRATE:baud] [/start startpolicy] [/noumex] 

bcdedit /dbgsettings USB [TARGETNAME:targetname] [/start startpolicy] [/noumex] 

bcdedit /dbgsettings 1394 [CHANNEL:channel] [/start startpolicy] [/noumex] NOTE: The 1394 TRANSPORT IS DEPRECATED

參數

NET

指定目標計算機和主計算機將使用乙太網路連線進行偵錯。使用此選項時，也必須包含 HOSTIP 和 PORT 參數。目標計算機必須具有 Windows 偵錯工具所支援的網路適配器。

HOSTIP：ip
針對網路偵錯，指定主機調試程式的IP位址。

KEY：key
針對網路偵錯，指定要用來加密連線的密鑰。 [0-9] 和 [a-z] 只允許。如果您已指定 newkey 參數，請勿指定此參數。

PORT：port
針對網路偵錯，指定要與主機調試程式通訊的埠。應該是 49152 或更高版本。

newkey
針對網路偵錯，指定應該為連線產生新的加密密鑰。如果您已指定 KEY 參數，請勿指定此參數。

nodhcp

設定 nodhcp 可防止使用 DHCP 來取得目標 IP 位址。這個選項很少需要，因為即使是小型路由器也提供 DHCP 的支援。只有在您知道網路上沒有 DHCP 伺服器時，才應該使用 nodhcp 選項。在大部分情況下，未設定此選項且已啟用 DHCP 時，KDNET 傳輸效果最佳。

busparams=Bus.Device.Function 指定目標控制器。總線會指定總線號碼、裝置指定裝置號碼，而 Function 會指定函式號碼。

若要指定總線參數，請開啟裝置管理員，並找出您要用於偵錯的網路適配器。開啟網路適配器的屬性頁，並記下總線號碼、裝置號碼和函式號碼。這些值會顯示在 [一般] 索引標籤的 [位置] 底下裝置管理員。在提升許可權的命令提示字元視窗中，輸入下列命令，其中 b、d 和 f 是十進位格式的總線、裝置和函式號碼：

bcdedit /set "{dbgsettings}" busparams b.d.f

如果您要手動設定調試程式連線，則必須指定總線參數。如需詳細資訊，請參閱手動設定 KDNET 網路核心偵錯和透過 USB 3.0 纜線手動設定 Kernel-Mode 偵錯。

範例

下列命令會將目標計算機設定為使用乙太網路連線進行偵錯，並指定主計算機的IP位址。此命令也會指定主計算機可用來連線到目標電腦的通訊埠號碼。

bcdedit /dbgsettings net hostip:10.125.5.10 port:50000

下列命令會將全域調試程式設定設定為使用 IPv6 與 2001：48：d8：2f：5e：c0：42：28：4f5b 通訊埠 50000 上的網路偵錯：

bcdedit /dbgsettings NET HOSTIPV6:2001:48:d8:2f:5e:c0:42:28:4f5b PORT:50000

重要

手動設定網路偵錯是複雜且容易出錯的程式。若要自動設定網路偵錯，請參閱自動設定 KDNET 網路核心偵錯。 強烈建議所有調試程式使用者使用 KDNET 公用程式。

如需手動設定的詳細資訊，請參閱手動設定 Kernel-Mode 透過網路纜線進行偵錯。

LOCAL

LOCAL 選項會將全域偵錯選項設定為本機偵錯。這是單一計算機上的核心模式偵錯。換句話說，調試程式會在正在偵錯的同一部計算機上執行。透過本機偵錯，您可以檢查狀態，但無法中斷進入會導致OS停止執行的核心模式進程。

範例

下列命令會將全域調試程式設定設為本機偵錯。

bcdedit /dbgsettings LOCAL

LOCAL 選項適用於 Windows 8.0和 Windows Server 2012 和更新版本。

如需手動設定本機核心模式偵錯的詳細資訊，請參閱手動設定單一計算機的本機核心偵錯。

串行

指定目標計算機和主計算機將使用序列連線進行偵錯。使用此選項時，應該指定 DEBUGPORT 和 BAUDRATE 參數。

BAUDRATE：baud
指定要使用的傳輸速率。這是選擇性參數。傳輸的有效值為 9600、19200、38400、57600 和 115200。默認的傳輸速率為 115200 bps。

DEBUGPORT：port
指定要作為偵錯埠的序列埠。這是選擇性的設定。默認埠為 1 (COM 1) 。

範例

下列命令會將目標計算機設定為使用序列連線進行偵錯。此命令也會指定偵錯連線將使用 COM1 和 115,200 的傳輸速率。

bcdedit /dbgsettings serial debugport:1 baudrate:115200

如需詳細資訊，請參閱手動透過序列纜線設定 Kernel-Mode 偵錯。

USB

指定目標計算機和主計算機將使用USB 2.0或USB 3.0連線進行偵錯。使用此選項時，也必須包含 TTNAME 參數。

TARGETNAME：targetname
指定要用於目標名稱的字串值。請注意，TargetName 不一定是目標計算機的正式名稱;它可以是您建立的任何字串，只要符合下列限制：

字串不能包含 TargetName 中任何大小寫組合中的「debug」。例如，如果您在 targetname 中的任何位置使用「DeBug」或「DEBUG」，偵錯將無法正常運作。
字串中唯一的字元是連字元 ( ) 、底線 (_) 、數位0到9，以及字母 A 到 Z (大寫或小寫) 。
字串的最大長度為 24 個字元。

範例

下列命令會將目標計算機設定為使用USB連線進行偵錯。此命令也會指定主計算機可用來連線到目標計算機的目標名稱。

bcdedit /dbgsettings usb targetname:myTarget

如需詳細資訊，請參閱：

1394

重要

1394 傳輸可用於 Windows 10 1607 版和更早版本。它不適用於較新版本的 Windows。您應該使用乙太網路將項目轉換為其他傳輸，例如 KDNET。如需該傳輸的詳細資訊，請參閱自動設定 KDNET 網路核心偵錯。

指定目標計算機和主計算機將使用 IEEE 1394 (FireWire) 連線進行偵錯。使用此選項時，也可以包含 CHANNEL 參數。

CHANNEL：channel
(只有在連線類型為 1394.) 指定要使用的 1394 通道時才會使用。通道的值必須是介於 0 到 62 之間的十進位整數，且必須符合主電腦所使用的通道號碼。此參數中指定的通道不取決於適配卡上選擇的實體 1394 埠。通道的預設值為 0。

如需詳細資訊，請參閱手動透過 1394 纜線設定 Kernel-Mode 偵錯。

一般調試程序設定

/startstartpolicy
這個選項會指定除錯程式啟動原則。下表顯示 startpolicy 的選項。

選項	Description
使用中	指定核心調試程式為作用中。
AUTOENABLE	指定發生例外狀況或其他重大事件時，會自動啟用核心調試程式。在那之前，調試程序處於作用中狀態，但已停用。
DISABLE	指定當您輸入 kdbgctrl 以清除 enable 區塊時，會啟用核心調試程式。在那之前，調試程序處於作用中狀態，但已停用。

如果未指定啟動原則，則 ACTIVE 是預設值。

/noumex
指定核心調試程式忽略使用者模式例外狀況。根據預設，核心調試程式會中斷特定使用者模式例外狀況，例如STATUS_BREAKPOINT和STATUS_SINGLE_STEP。只有在沒有附加至進程的使用者模式調試程式時， /noumex 參數才有效。

註解

/dbgsettings 選項會設定偵錯設定，但不會啟用偵錯。您必須使用 /debug 選項來啟用特定開機項目的偵錯。如果沒有針對特定開機專案指定的偵錯設定，則會使用預設偵錯設定。

下表顯示 dbgsettings 的預設值。

dbgsetting 參數	預設值
debugtype	本機
debugstart	使用中
noumex	是

另請參閱

如需 Windows 偵錯工具的相關信息，請參閱 Windows 偵錯。

如需設定和設定內核模式偵錯會話的相關信息，請參閱手動設定 Kernel-Mode 偵錯和自動設定 KDNET 網路核心偵錯。