スマート クライアントのアクティブ化 (カーネル モード)

KD 接続サーバーがアクティブ化されたら、別のコンピューターにスマート クライアントを作成し、デバッグ セッションを開始できます。

スマート クライアントを起動するには、kdsrvカーネル プロトコルを使用して KD または WinDbg を起動するか、WinDbg グラフィカル インターフェイスを使用する方法の 2 つがあります。

KD 接続サーバーで使用されるリモート転送プロトコルを指定する必要があります。 KD 接続サーバーとターゲット コンピューターの間の実際のカーネル接続のプロトコルを指定することも、既定値を使用することもできます。

大事な

リモート デバッグを使用する場合は、セキュリティに関する重要な考慮事項があります。 セキュア モードの有効化に関する情報を含む詳細については、「Security During Remote Debugging」および「Security Considerations for Windows Debugging Tools」を参照してください。

スマート クライアントを起動するための一般的な構文は、使用されるプロトコルによって異なります。 次のオプションがあります。

推奨される接続方法と、いくつかの追加のセキュリティ

Debugger -k kdsrv:server=@{spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password]},trans=@{ConnectType} [Options]

セキュリティで保護されていない接続方法の を する

Debugger -k kdsrv:server=@{npipe:server=Server,pipe=PipeName[,password=Password]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{tcp:server=Server,port=Socket[,password=Password][,ipversion=6]},trans=@{ConnectType} [Options]

Debugger -k kdsrv:server=@{tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6]},trans=@{ConnectType} [Options]

グラフィカル インターフェイスを使用して KD 接続サーバーに接続するには、WinDbg が休止モードである必要があります。コマンド ライン パラメーターなしで開始されているか、前のデバッグ セッションを終了している必要があります。 ファイルを選択する |リモート スタブ メニュー コマンドに接続します。 [リモート スタブ サーバーへの接続] ダイアログ ボックスが表示されたら、[接続文字列 テキスト ボックスに次のいずれかの文字列を入力します。

推奨される接続方法と、いくつかの追加のセキュリティ

spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] 

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password] 

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password] 

com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

セキュリティで保護されていない接続方法の を する

npipe:server=Server,pipe=PipeName[,password=Password] 

tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 

tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 

または、[参照] ボタンを使用して、アクティブな KD 接続サーバーを見つけることもできます。

上記のコマンドのパラメーターには、次の値を指定できます。

デバッガーの
KD または WinDbg を指定できます。

Server
これは、KD 接続サーバーが作成されたコンピューターのネットワーク名または IP アドレスです。2 つの初期円記号 (\) はコマンド ラインでは省略可能ですが、WinDbg ダイアログ ボックスでは使用できません。

pipe=PipeName
NPIPE または SPIPE プロトコルを使用する場合、pipeName は、KD 接続サーバーの作成時にパイプに指定された名前です。

サーバー コンピューターにアクセスできるアカウントを使用してクライアント コンピューターにログオンしていない場合は、ユーザー名とパスワードを指定する必要があります。 クライアント コンピューターのコマンド プロンプト ウィンドウで、次のコマンドを入力します。

net use \\Server\ipc$ /user:UserName

ここで、Server はサーバー コンピューターの名前、UserName はサーバー コンピューターにアクセスできるアカウントの名前です。

メッセージが表示されたら、UserNameのパスワードを入力します。

このコマンドが成功したら、-k kdsrv を使用するか、WinDbg グラフィカル インターフェイスを使用して、スマート クライアントをアクティブ化できます。

port=ソケット
TCP または SSL プロトコルを使用する場合、ソケット は、KD 接続サーバーの作成時に使用されたのと同じソケット ポート番号です。

clicon を する
KD 接続サーバーが逆接続を介してスマート クライアントへの接続を試行することを指定します。 クライアントは、サーバーが cliconを使用している場合にのみ、clicon 使用する必要があります。 ほとんどの場合、逆接続を使用すると、KD 接続サーバーの前にスマート クライアントが開始されます。

port=COMPort
COM プロトコルを使用する場合、COMPort は、使用する COM ポートを指定します。 プレフィックス "COM" は省略可能です。たとえば、"com2" と "2" の両方を使用できます。

ボー=BaudRate
COM プロトコルを使用する場合、BaudRate は、KD 接続サーバーの作成時に選択したボー レートと一致する必要があります。

channel=COMChannel
COM プロトコルを使用する場合、COMChannel は、KD 接続サーバーの作成時に選択したチャネル番号と一致する必要があります。

proto=プロトコル
SSL または SPIPE プロトコルを使用する場合、プロトコル は、KD 接続サーバーの作成時に使用されるセキュリティで保護されたプロトコルと一致する必要があります。

証明書 の
SSL または SPIPE プロトコルを使用する場合は、KD 接続サーバーの作成時に使用された同一の certuser=Cert または のCert パラメーターを使用する必要があります。

password=Password
KD 接続サーバーの作成時にパスワードを使用した場合、スマート クライアントを作成するには、パスワード を指定する必要があります。 元のパスワードと一致する必要があります。 パスワードでは大文字と小文字が区別されます。 間違ったパスワードが指定されている場合、エラー メッセージは "エラー 0x80004005" を指定します。

ipversion=6
(Windows 6.6.07 以前のデバッグ ツールのみ)TCP を使用してインターネットに接続するときに、デバッガーでバージョン 4 ではなく IP バージョン 6 を使用するように強制します。 Windows Vista 以降のバージョンでは、デバッガーは IP バージョン 6 の自動既定値を試み、このオプションを不要にします。

trans=@{ConnectType}
ターゲットに接続する方法をデバッガーに指示します。 次のカーネル接続プロトコルが許可されています。

com:port=ComPort,baud=BaudRate 
usb2:targetname=String 
com:pipe,port=\\VMHost\pipe\PipeName[,resets=0][,reconnect]
com:modem 

これらのプロトコルの詳細については、「デバッグのセットアップ」を参照してください。 これらのプロトコルのパラメーターは省略できます。たとえば、trans=@{com:} などです。デバッガーは、KdSrv が実行されているコンピューター上の環境変数で指定された値に既定で設定されます。

オプションの
追加のコマンド ライン パラメーターは、ここに配置できます。 完全な一覧については、「Command-Line オプションの」を参照してください。

KD 接続サーバーは単にスマート クライアントのゲートウェイとして機能するため、追加の オプション は、KdSrv が実行されているコンピューターでカーネル デバッガーを起動する場合と同じになります。 この例外は、スマート クライアントが実行されているコンピューター上のパスとしてパスまたはファイル名を指定するオプションです。