次の方法で共有

スマート クライアントのアクティブ化

  • [アーティクル]

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

スマート クライアントを起動するには、-premote コマンド ライン オプションで CDB または WinDbg を起動するか、WinDbg グラフィカル インターフェイスを使用する方法の 2 つがあります。

大事な

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

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

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

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

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

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

Debugger -premote com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] [Options]

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

Debugger -premote npipe:server=Server,pipe=PipeName[,password=Password] [Options]

Debugger -premote tcp:server=Server,port=Socket[,password=Password][,ipversion=6] [Options]

Debugger -premote tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] [Options]

グラフィカル インターフェイスを使用してプロセス サーバーに接続するには、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]

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

パラメーター

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

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

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

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

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

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

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

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

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

注 サーバー コンピューターでファイルとプリンターの共有を有効にする必要がある場合があります。 コントロール パネルで、[ネットワークとインターネット > ネットワークと共有センター]> [共有の詳細設定]に移動します。 [ファイルとプリンターの共有オンにする] を選択します。

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

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

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

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

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

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

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

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

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

オプションの
追加のコマンド ライン パラメーターは、ここに配置できます。 完全な一覧については、「Command-Line オプションの」を参照してください。 CDB を使用している場合は、デバッグするプロセスを指定する必要があります。 WinDbg を使用している場合は、コマンド ラインまたはグラフィカル インターフェイスを使用してプロセスを指定できます。

プロセス サーバーは単にスマート クライアントのゲートウェイとして機能するため、追加の オプション は、ターゲット アプリケーションと同じコンピューターでユーザー モード デバッガーを起動する場合と同じになります。

.attach (プロセスにアタッチ) または .create (Create Process)-premote オプションを使用している場合、パラメーターは上記と同じです。

トラブルシューティング

次のメッセージが表示される場合: クライアントは、サーバー と同じバージョンのリモート処理プロトコルを使用していません。これは、接続しようとしている DbgSrv のバージョンが WinDbg のバージョンとは異なるプロトコル バージョンを使用していることを示します。

プロトコルの変更が行われるのは一般的ではありません。 これが発生した場合は、DbgSrv と WinDbg (クラシック) または WinDbg の使用可能な最新バージョンの対応するバージョンを使用していることを確認します。 最新バージョンのダウンロードについては、「Debugging Tools for Windows」を参照してください。