共用方式為


BCDEdit /dbgsettings

/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

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

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

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

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

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

nodhcp

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

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

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

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

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

範例

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

bcdedit /dbgsettings net hostip:10.125.5.10 port:50000

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

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

重要

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

如需手動設定的詳細資訊,請參閱 手動透過網路纜線設定內核模式偵錯。

如需透過 USB 模擬乙太網路的資訊,請參閱 使用 KDNET 透過 USB EEM 設定內核模式偵錯

LOCAL

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

範例

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

bcdedit /dbgsettings LOCAL

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

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

串行

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

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

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

範例

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

bcdedit /dbgsettings serial debugport:1 baudrate:115200

如需詳細資訊,請參閱 手動透過序列纜線設定內核模式偵錯。

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。

一般調試程序設定

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

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

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

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

註解

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

下表顯示 dbgsettings 的預設值。

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

另請參閱

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

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