KDNET ネットワーク カーネル デバッグの自動設定Setting Up KDNET Network Kernel Debugging Automatically

デバッグ ツールの Windows カーネルがネットワーク経由でデバッグをサポートします。Debugging Tools for Windows supports kernel debugging over a network. このトピックでは、デバッグ、kdnet.exe セットアップ ツールを使用して自動的にネットワークをセットアップする方法を説明します。This topic describes how to set up network debugging automatically using the kdnet.exe setup tool.

デバッガーを実行しているコンピューターが呼び出されます、ホスト コンピューター、デバッグ中のコンピューターを呼び出すと、対象のコンピュータします。The computer that runs the debugger is called the host computer, and the computer being debugged is called the target computer. 7 以降、ホスト コンピューターで Windows が実行する必要があり、8 またはそれ以降、ターゲット コンピューターで Windows が実行する必要があります。The host computer must be running Windows 7 or later, and the target computer must be running Windows 8 or later.

ホスト コンピューターの IP アドレスを決定します。Determining the IP Address of the Host Computer

  1. ターゲットとホスト Pc がネットワーク ハブに接続しているまたは、適切なネットワーク ケーブルを使用して切り替えることを確認します。Confirm that the target and host PCs are connected to a network hub or switch using an appropriate network cable.

  2. ホスト コンピューターでは、コマンド プロンプト ウィンドウを開き、入力IPConfig IP 構成を表示します。On the host computer, open a Command Prompt window and enter IPConfig to display the IP configuration.

  3. コマンドの出力では、イーサネット アダプターの IPv4 アドレスを見つけます。In the command output, locate the IPv4 address of the Ethernet adapter.

    ...
    
    Ethernet adapter Ethernet:
    ...
    
    IPv4 Address. . . . . . . . . . . : <YourHostIPAddress>
    ...
    
    
  4. デバッグに使用するネットワーク アダプターの IPv4 アドレスをメモしておきます。Make a note of the IPv4 address of the network adapter that you intend to use for debugging.

ホストとターゲット コンピューターを設定します。Setting Up the Host and Target Computers

Kdnet.exe ユーティリティを使用すると、次の手順では対象のコンピューターのデバッガーの設定を自動的に構成します。Use the kdnet.exe utility to automatically configure the debugger settings on the target PC, by following these steps.

  1. Windows デバッグ ツールがホスト システム上にインストールされていることを確認します。Confirm that the Windows Debugging Tools are installed on the host system. ダウンロードして、デバッガー ツールのインストールについては、次を参照してください。デバッグ ツールの Windows にダウンロードします。For information on downloading and installing the debugger tools, see Download Debugging Tools for Windows.

  2. 検索、 kdnet.exeVerifiedNICList.xmlファイル。Locate the kdnet.exe and VerifiedNICList.xml files. 既定では、これらはここにします。By default, they are located here.

    C:\Program Files (x86)\Windows Kits\10\Debuggers\x64
    

    注意

    次の手順では、両方の Pc に、ターゲットとホストの両方で Windows の 64 ビット バージョンが実行されていることを前提としています。These directions assumes that both PCs are running a 64 bit version of Windows on both the target and host. 場合はそうでない、最適な方法では、ターゲットを実行しているホストでツールの同じ「ビット数」を実行します。If that is not the case, the best approach is to run the same "bitness" of tools on the host that the target is running. たとえば、ターゲットは、32 ビット Windows を実行している、ホスト上の 32 のバージョンのデバッガーを実行します。For example, if the target is running 32-bit Windows, run a 32 version of the debugger on the host. 詳細については、次を参照してください。 32 ビットまたは 64 ビット デバッグ ツールを選択するします。For more information, see Choosing the 32-Bit or 64-Bit Debugging Tools.

  3. ホスト コンピューターでは、2 つのファイルをネットワーク共有にコピーまたはつまみのドライブでは、ターゲット コンピューター上で使用できるようにします。On the host computer, copy the two files to a network share or thumb drive, so that they will be available on the target computer.

  4. 対象のコンピューターに C:\KDNET ディレクトリおよびコピーを作成、 kdnet.exeVerifiedNICList.xmlファイルをそのディレクトリにします。On the target computer, create a C:\KDNET directory and copy the kdnet.exe and VerifiedNICList.xml files to that directory.

    重要

    ブート情報を変更する kdnet を使用する前に、テスト用のコンピューターの BitLocker とセキュア ブートなどの Windows セキュリティ機能を一時的に中断する必要があります。Before using kdnet to change boot information you may need to temporarily suspend Windows security features such as BitLocker and Secure Boot on the test PC. テストが完了すると、これらのセキュリティ機能を再度有効にし、適切なセキュリティ機能を無効にするテスト PC を管理します。Re-enable these security features when testing is complete and appropriately manage the test PC, when the security features are disabled.

  5. ターゲット コンピューターで、管理者としてコマンド プロンプト ウィンドウを開きます。On the target computer, open a Command Prompt window as Administrator. ターゲット コンピューターに、サポートされているネットワーク アダプターがあることを確認するには、このコマンドを入力します。Enter this command to verify that the target computer has a supported network adapter.

    C:\KDNET>kdnet
    Network debugging is supported on the following NICs:
    busparams=1.0.0, Broadcom NetXtreme Gigabit Ethernet, Plugged in.  
    This Microsoft hypervisor supports using KDNET in guest VMs.
    
  6. Kdnet からの出力にそのネットワーク アダプターに示すよう、ターゲットがサポートされている、進むことができます。As the output from kdnet indicates that network adapter on the target is supported, we can proceed.

  7. このコマンドをホスト システムの IP アドレスを設定して生成された一意の接続キー型です。Type this command to set the IP address of the host system and generated a unique connection key. IP アドレスまたはホスト システムの名前を使用します。Use the IP address or the name of the host system. 各ターゲット/ホスト ペアリングの一意のポート アドレスを選択と連携 50000 50039 の推奨される範囲内です。Pick a unique port address for each target/host pair that you work with, with in the recommended range of 50000-50039.

    C:\>kdnet <HostComputerIPAddress> <YourDebugPort> 
    
    Enabling network debugging on Intel(R) 82577LM Gigabit Network Connection.
    Key=2steg4fzbj2sz.23418vzkd4ko3.1g34ou07z4pev.1sp3yo9yz874p
    
  8. 返されたキーをメモ帳の .txt ファイルにコピーします。Copy the returned key into a notepad .txt file.

Using WinDbg Using WinDbg

ホスト コンピューターでは、WinDbg を開きます。On the host computer, open WinDbg. ファイル] メニューの [選択カーネル デバッグします。On the File menu, choose Kernel Debug. カーネル デバッグ ダイアログ ボックスで、開く、 Netタブ。実際のポート番号と以前に保存したをメモ帳の .txt ファイルでキーを貼り付けます。In the Kernel Debugging dialog box, open the Net tab. Paste in your port number and key that you saved to in the notepad .txt file earlier. [OK] をクリックします。Click OK.

コマンド プロンプト ウィンドウを開き、次のコマンドを入力して、WinDbg セッションを開始することもできます、 、上で選択したポートとkdnet 上記によって返されたキーします。You can also start a WinDbg session by opening a Command Prompt window and entering the following command, where is the port you selected above, and is the key that was returned by kdnet above. 以前に保存したをメモ帳の .txt ファイルでそのキーを貼り付けます。Paste in the key in that you saved to in the notepad .txt file earlier.

windbg -k net:port=<YourDebugPort>,key=<YourKey> 

WinDbg のポートにアクセスを許可するポートをファイアウォール経由でアクセスするための WinDbg に関する求められたら、 3 つすべての異なるネットワークの種類。If you are prompted about allowing WinDbg to access the port through the firewall, allow WinDbg to access the port for all three of the different network types.

windows セキュリティの警告 - windows ファイアウォールがこのアプリの一部の機能をブロックします。windows security alert - windows firewall has blocked some features of this app

対象の PC を再起動します。 Restarting the Target PC

デバッガーを接続すると、対象のコンピュータを再起動します。Once the debugger is connected, reboot the target computer. 管理者のコマンド プロンプトから次のコマンドを使用することは、PC を再起動する方法の 1 つです。One way to do restart the PC, is to use this command from an administrator's command prompt.

shutdown -r -t 0 

トラブルシューティングのヒントTroubleshooting Tips

アプリケーションのデバッグを許可するファイアウォールを通過する必要があります。Debugging application must be allowed through firewall

デバッガー、ファイアウォール経由のアクセスが必要です。The debugger must have access through the firewall. コントロール パネルを使用すると、ファイアウォール経由のアクセスを許可します。Use Control Panel to allow access through the firewall.

  1. 開いているコントロール パネルの [>システムとセキュリティ] をクリックアプリを Windows ファイアウォールを通過できますします。Open Control Panel > System and Security and click Allow an app through Windows Firewall.

  2. アプリケーションの一覧で探しますWindows GUI のシンボリック デバッガーWindows カーネル デバッガーします。In the list of applications, locate Windows GUI Symbolic Debugger and Windows Kernel Debugger.

  3. これら 2 つのアプリケーションを許可するチェック ボックスを使用して3 つすべての種類の異なるネットワーク ファイアウォールを経由します。Use the check boxes to allow those two applications all three of the different network types through the firewall.

  4. 下へスクロールし、をクリックしてOKは、ファイアウォールの変更を保存します。Scroll down and click OK, to save the firewall changes. デバッガーを再起動します。Restart the debugger.

    windows のコントロール パネルのファイアウォールの構成が Windows GUI のシンボリック デバッガーと Windows カーネル デバッガーを有効になっている次の 3 つネットワークの種類のすべての表示

Ping を使用して、接続をテストするにはUse Ping to test connectivity

場合は、デバッガーは、タイムアウトになると、接続していないのターゲット PC に、ping コマンドを使用して、接続を確認します。If the debugger times out and does not connect, use the ping command on the target PC to verify connectivity.

C:\>Ping <HostComputerIPAddress> 

ネットワーク デバッグ用にポートを選択します。Choosing a Port for Network Debugging

デバッガーでは、タイムアウトになると、接続していないの場合は、50000 の既定のポート番号は既に使用またはブロックされているため、その可能性があります。If the debugger times out and does not connect, it could be because the default port number of 50000 is already in use or it is blocked.

任意のポート番号は 49152 ~ 65535 から選択できます。You can choose any port number from 49152 through 65535. 推奨される範囲では、50000 ~ 50039 です。The recommended range is between 50000 and 50039. 選択したポートを排他アクセスのホスト コンピューターで実行されているデバッガーでは開けません。The port that you choose will be opened for exclusive access by the debugger running on the host computer.

  ネットワーク デバッグに使用できるポート番号の範囲は、会社のネットワーク ポリシーによって制限される可能性があります。Note  The range of port numbers that can be used for network debugging might be limited by your company's network policy. 会社のポリシーがネットワークのデバッグに使用できるポートの範囲を制限するかどうかを判断するには、ネットワーク管理者に確認します。To determine whether your company's policy limits the range of ports that can be used for network debugging, check with your network administrators.

サポートされているネットワーク アダプターSupported Network Adapters

Kdnet.exe を実行すると、そのネットワーク アダプターがサポートされていないことと、「このマシンの Nic のいずれかのネットワークのデバッグはサポートされていません」の場合は表示されます。If "Network debugging is not supported on any of the NICs in this machine" is displayed when you run kdnet.exe, it means that the network adapter is not supported.

ホスト コンピューターは、任意のネットワーク アダプターを使用できますが、ターゲット コンピューターが Windows のツールをデバッグでサポートされているネットワーク アダプターを使用する必要があります。The host computer can use any network adapter, but the target computer must use a network adapter that is supported by Debugging Tools for Windows. サポートされているネットワーク アダプターの一覧は、次を参照してください。イーサネット Nic を Windows 10 でのネットワーク カーネル デバッグのサポートされているイーサネット Nic を Windows 8.1 でのネットワーク カーネル デバッグのサポートされているします。For a list of supported network adapters, see Supported Ethernet NICs for Network Kernel Debugging in Windows 10 and Supported Ethernet NICs for Network Kernel Debugging in Windows 8.1.

関連トピックRelated topics

Windows 10 でのデバッグ ネットワーク カーネルのイーサネット Nic をサポートSupported Ethernet NICs for Network Kernel Debugging in Windows 10

Windows 8.1 でのデバッグ ネットワーク カーネルのイーサネット Nic をサポートSupported Ethernet NICs for Network Kernel Debugging in Windows 8.1

KDNET のネットワーク カーネル デバッグを手動での設定Setting Up KDNET Network Kernel Debugging Manually