透過網路對 Windows 執行個體進行核心除錯

KDNET 彈性網路轉接器擴充性模組 (ENA) 是一種硬體驅動程式支援層，可透過 Amazon Elastic Compute Cloud 執行個體上的 ENA 透過網路進行 Windows 核心偵錯。您可以使用擴充模組搭配 Windows Debugger (WinDbg)，在執行 Windows 的 EC2 執行個體上執行核心層級偵錯。

核心偵錯可協助您診斷和疑難排解低階作業系統問題，例如 EC2 Windows 執行個體上的藍螢幕錯誤 (BSODs)、驅動程式故障和開機問題。

先決條件

開始前，請確定您具有下列項目：

兩個 EC2 Windows 執行個體，位於相同的子網路中：

如需啟動執行個體的詳細資訊，請參閱 開始使用 Amazon EC2。

主機和目標執行個體的安全群組必須允許用於 KDNET 除錯的連接埠上的傳入和傳出 UDP 流量 （建議範圍：50000–50039)。設定此項目最簡單的方法是建立具有傳入規則的安全群組，允許來自自身的 UDP 流量做為來源，然後將該安全群組連接至這兩個執行個體。如需詳細資訊，請參閱「Amazon VPC 使用者指南」中的安全群組規則。

除錯目標執行個體必須執行下列其中一個 Windows 版本 （或更新版本）：

Test-Path C:\Windows\system32\kd_02_1d0f.dll

步驟 1：在偵錯主機上安裝 Windows 偵錯工具

在 PowerShell 工作階段中執行下列命令，在偵錯主機執行個體上安裝 Windows 偵錯工具：

winget install microsoft.windbg

如需詳細安裝說明，請參閱 Microsoft 文件中的安裝 Windows Debugger。

安裝之後，請在 PowerShell 工作階段中執行下列命令，確認偵錯工具是否正常運作：

windbgx

WinDbg 視窗應開啟。如果安裝成功，您可以關閉視窗。

步驟 2：設定偵錯目標

在偵錯目標上，開啟提升的 PowerShell 工作階段，並使用下列步驟設定核心偵錯。

執行下列命令，列出連接至執行個體之 ENA 轉接器的匯流排、裝置和函數編號：

Get-NetAdapter -Physical |
    Where-Object -Property PnPDeviceID -Match -Value '^PCI\\VEN_1D0F&DEV_EC2[01]&' |
    Get-NetAdapterHardwareInfo |
    Select-Object InterfaceDescription, BusNumber, DeviceNumber, FunctionNumber |
    Format-List

Get-NetAdapter -Physical |
    Where-Object PnPDeviceID -Match '^PCI\\VEN_1D0F&DEV_EC2[01]&' |
    ForEach-Object {
        $adapter = $_
        $hwInfo = $adapter | Get-NetAdapterHardwareInfo
        $ipInfo = Get-NetIPAddress -InterfaceIndex $adapter.InterfaceIndex -AddressFamily IPv4
        [PSCustomObject]@{
            InterfaceDescription = $adapter.InterfaceDescription
            IPAddress            = $ipInfo.IPAddress
            BusNumber            = $hwInfo.BusNumber
            DeviceNumber         = $hwInfo.DeviceNumber
            FunctionNumber       = $hwInfo.FunctionNumber
        }
    } | Format-List

請注意用於從輸出除錯的 ENA 轉接器的 BusNumberDeviceNumber、 和 FunctionNumber值。

執行下列命令來設定核心偵錯。將預留位置值取代為您的特定組態：

bcdedit /debug on
bcdedit /set loadoptions FORCEHVTONOTSHAREDEBUGDEVICE
bcdedit /dbgsettings net hostip:host-private-ip port:port-number key:encryption-key busparams:b.d.f

(bcdedit /enum) -match "loadoptions"

其中：

bcdedit /bootdebug on

步驟 3：在偵錯主機上啟動偵錯工作階段

若要允許偵錯主機上的流量，您可以為 WinDbg 應用程式或特定 UDP 連接埠建立防火牆規則。

選項 1：允許 WinDbg 應用程式

執行下列命令來授權 WinDbg 可執行檔：

$WinDbgxPath = "$env:LocalAppData\Microsoft\WindowsApps\WinDbgX.exe"
New-NetFirewallRule -DisplayName "Allow Inbound KDNET Connection" -Action Allow -Program $WinDbgxPath

選項 2：允許特定的 UDP 連接埠

或者，您可以允許傳入 UDP 流量到為核心偵錯設定的連接埠。以您選擇的 KDNET 連接埠取代 port-number：

$DebugPort = port-number
New-NetFirewallRule -DisplayName "Allow Inbound KDNET Connection" -Direction Inbound -LocalPort $DebugPort -Protocol UDP -Action Allow

使用符合偵錯目標組態的連接埠和金鑰啟動 WinDbg。您可以指定 Microsoft WinDbg 命令列參考中記錄的其他核心偵錯選項，以符合您的使用案例。

windbgx -k net:port=port-number,key=encryption-key

WinDbg 會開啟並等待偵錯目標連線。

步驟 4：重新啟動偵錯目標

在偵錯目標上，重新啟動執行個體以啟動偵錯連線：

shutdown -r -t 0

偵錯目標重新啟動後，偵錯主機上的 WinDbg 會自動連線到目標。您現在可以使用 WinDbg 來檢查核心狀態、設定中斷點，以及診斷問題。

偵錯後清除偵錯設定

在偵錯目標上

完成偵錯後，請從偵錯目標移除核心偵錯組態，以還原正常的開機行為。在偵錯目標上，開啟提升的 PowerShell 工作階段並執行下列命令：

bcdedit /debug off
bcdedit /dbgsettings LOCAL
bcdedit /deletevalue loadoptions

如果您有 loadoptions 以外的現有 FORCEHVTONOTSHAREDEBUGDEVICE，您應該bcdedit /set loadoptions使用原始 執行 來還原設定loadoptions。

如果您已啟用開機偵錯，也請執行：

bcdedit /bootdebug off

重新啟動執行個體，讓變更生效。

在偵錯主機上

執行下列動作以移除防火牆規則：

Remove-NetFirewallRule -DisplayName "Allow Inbound KDNET Connection"

限制

ENA 的 KDNET 擴充功能模組目前不支援：

模組目前不支援啟用安全開機的執行個體。您可以在提升的 PowerShell 工作階段Confirm-SecureBootUEFI中執行 驗證狀態。如果輸出為 True，則安全開機為作用中。請注意，根據預設，具有「TPM」字首的所有 Amazon 提供的映像都已啟用安全開機。

其他備註

如果您在將除錯器連線至目標執行個體時遇到問題，請確認下列事項：

如需其他指引，請參閱 Microsoft 文件中的手動設定 KDNET 網路核心偵錯。