デバッグ クライアントのアクティブ化
デバッグ サーバーがアクティブ化されたら、別のコンピューターでデバッグ クライアントを起動し、デバッグ セッションに接続できます。
デバッグ クライアントを起動するには、-remote コマンド ライン オプションを使用するか、WinDbg グラフィカル インターフェイスを使用する方法の 2 つがあります。
クライアントのプロトコルは、サーバーのプロトコルと一致している必要があります。 デバッグ クライアントを開始するための一般的な構文は、使用されるプロトコルによって異なります。 次のオプションがあります。
推奨される接続方法と、いくつかの追加のセキュリティ
Debugger -remote spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password]
Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password]
Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]
セキュリティで保護されていない接続方法の を
Debugger -remote npipe:server=Server,pipe=PipeName[,password=Password]
Debugger -remote tcp:server=Server,port=Socket[,password=Password][,ipversion=6]
Debugger -remote tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6]
Debugger -remote com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password]
グラフィカル インターフェイスを使用してリモート デバッグ セッションに接続するには、WinDbg が休止モードである必要があります。つまり、コマンド ライン パラメーターなしで開始されているか、前のデバッグ セッションを終了している必要があります。 ファイルを選択する |リモート セッション メニュー コマンドに接続するか、Ctrl + R ショートカット キーを押します。 [リモート デバッガー セッションへの接続] ダイアログ ボックスが表示されたら、[接続文字列 テキスト ボックスに次のいずれかの文字列を入力します。
推奨される接続方法と、いくつかの追加のセキュリティ
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]
セキュリティで保護されていない接続方法の を
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]
com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password]
または、[参照] ボタンを使用して、アクティブなデバッグ サーバーを見つけることもできます。
大事な
リモート デバッグを使用する場合は、セキュリティに関する重要な考慮事項があります。 セキュア モードの有効化に関する情報を含む詳細については、「Security During Remote Debugging」および「Security Considerations for Windows Debugging Tools」を参照してください。
パラメーター
上記のコマンドのパラメーターには、次の値を指定できます。
デバッガーの
これは、デバッグ クライアントで使用されるデバッガーと同じである必要はありません。WinDbg、KD、CDB はすべて、デバッガーを介したリモート デバッグのために交換可能です。
Server
これは、デバッグ サーバーが作成されたコンピューターのネットワーク名または IP アドレスです。 2 つの初期円記号 (\) はコマンド ラインでは省略可能ですが、WinDbg ダイアログ ボックスでは使用できません。
pipe=PipeName
NPIPE または SPIPE プロトコルを使用する場合、PipeName は、サーバーの作成時にパイプに指定された名前です。
サーバー コンピューターにアクセスできるアカウントを使用してクライアント コンピューターにログオンしていない場合は、ユーザー名とパスワードを指定する必要があります。 クライアント コンピューターのコマンド プロンプト ウィンドウで、次のコマンドを入力します。
net use \\Server\ipc$ /user:UserName
ここで、Server はサーバー コンピューターの名前、UserName はサーバー コンピューターにアクセスできるアカウントの名前です。
メッセージが表示されたら、UserNameのパスワードを入力します。
このコマンドが成功したら、-remote コマンド ライン オプションを使用するか、WinDbg グラフィカル インターフェイスを使用して、デバッグ クライアントをアクティブ化できます。
注 サーバー コンピューターでファイルとプリンターの共有を有効にする必要がある場合があります。 コントロール パネルで、[ネットワークとインターネット > ネットワークと共有センター]> [共有の詳細設定]に移動します。 [ファイルとプリンターの共有
port=ソケット
TCP または SSL プロトコルを使用する場合、ソケット は、サーバーの作成時に使用されたのと同じソケット ポート番号です。
clicon を
デバッグ サーバーが逆接続を介してクライアントへの接続を試行することを指定します。 クライアントは、サーバーが clicon
port=COMPort
COM プロトコルを使用する場合、COMPort は、使用する COM ポートを指定します。 プレフィックス "COM" は省略可能です。たとえば、"com2" と "2" の両方を使用できます。
ボー=BaudRate
COM プロトコルを使用する場合、BaudRate は、サーバーの作成時に選択したボー レートと一致する必要があります。
channel=COMChannel
COM プロトコルを使用する場合、COMChannel は、サーバーの作成時に選択したチャネル番号と一致する必要があります。
proto=プロトコル
SSL または SPIPE プロトコルを使用する場合、プロトコル は、サーバーの作成時に使用されるセキュリティで保護されたプロトコルと一致する必要があります。
証明書 の
SSL または SPIPE プロトコルを使用する場合は、サーバーの作成時に使用された証明書
password=Password
サーバーの作成時にパスワードを使用した場合、デバッグ クライアントを作成するには、パスワード を指定する必要があります。 元のパスワードと一致する必要があります。 パスワードでは大文字と小文字が区別されます。 間違ったパスワードが指定されている場合、エラー メッセージは "エラー 0x80004005" を指定します。パスワードの長さは 12 文字以下にする必要があります。
ipversion=6
(Windows 6.6.07 以前のデバッグ ツールのみ)TCP を使用してインターネットに接続するときに、デバッガーでバージョン 4 ではなく IP バージョン 6 を使用するように強制します。 Windows Vista 以降のバージョンでは、デバッガーは IP バージョン 6 の自動既定値を試み、このオプションを不要にします。
新しいデバッグ セッションを開始するために使用されるコマンド ライン オプション (-pなど) は、デバッグ クライアントでは使用できませんが、サーバーでのみ使用できます。 構成オプション (-nなど) は、クライアントまたはサーバーから機能します。