.server (デバッグ サーバーの作成)

(その .server コマンドはデバッグ・サーバーを起動し、現在のデバッグ・セッションへのリモート接続を可能にする。

.server npipe:pipe=PipeName[,hidden][,password=Password][,IcfEnable] 
.server tcp:port=Socket[,hidden][,password=Password][,ipversion=6][,IcfEnable] 
.server tcp:port=Socket,clicon=Client[,password=Password][,ipversion=6] 
.server com:port=COMPort,baud=BaudRate,channel=COMChannel[,hidden][,password=Password] 
.server spipe:proto=Protocol,{certuser=Cert|machuser=Cert},pipe=PipeName[,hidden][,password=Password] 
.server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket[,hidden][,password=Password] 
.server ssl:proto=Protocol,{certuser=Cert|machuser=Cert},port=Socket,clicon=Client[,password=Password] 

パラメーター

PipeName
NPIPEまたはSPIPEプロトコルを使用する場合 PipeName はパイプの名前となる文字列である。 各パイプ名は、一意のデバッグサーバーを識別する必要がある。 パイプ名を再利用しようとすると、エラーメッセージが表示されます。 PipeName にスペースまたは引用符を含めることはできません。 PipeName には数値を含めることができる printf-xや%dのようなスタイルのフォーマットコード。 デバッガはこれをデバッガのプロセスIDに置き換える。 コロンで区切ってポートの範囲を指定することもできる。

Socket
TCPまたはSSLプロトコルを使用する場合 ソケット はソケットポート番号である。

コロンで区切ってポートの範囲を指定することもできる。 デバッガは、この範囲内の各ポートが空いているかどうかをチェックする。 空きポートが見つかり、エラーが発生しなければ、デバッグ・サーバーが作成される。 デバッグ・クライアントは、サーバーへの接続に使われる実際のポートを指定しなければならない。 実際のポートを決定するには、以下のいずれかの方法を使用する。 デバッグ・サーバーの検索; このデバッグ・サーバーが表示されると、ポートの後にコロンで区切られた2つの数字が続く。 最初の数字は実際に使用されるポートで、2番目は無視できる。 例えば、ポートがport=51:60と指定され、実際にポート53が使用された場合、検索結果は「port=53:60」と表示される。 (を使用している場合 clicon パラメータを使用して逆接続を確立する場合、デバッグクライアントはこの方法でポートの範囲を指定できるが、サーバーは実際に使用されるポートを指定しなければならない)。

clicon=Client
TCPまたはSSLプロトコルが使用され、かつ クリコン パラメータが指定された場合は 逆接続 が開かれる。 これは、クライアントがコンタクトを開始するのではなく、デバッグサーバーがデバッグクライアントに接続しようとすることを意味します。 これは、ファイアウォールが通常の方向への接続を妨げている場合に便利です。 Client は、デバッグ・クライアントが存在する、または作成されるマシンのネットワーク名を指定します。 最初の2つのバックスラッシュ(◆)はオプションである。

いつ clicon を使用する場合、デバッグサーバーが作成される前にデバッグクライアントを開始するのがベストですが、通常の順序（サーバーがクライアントの前）でも構いません。 別のデバッガーがアクティブなサーバーをすべて表示する場合、逆接続サーバーは表示されません。

COMPort
COMプロトコル使用時, COMPort は、使用するCOMポートを指定する。 接頭辞COMは任意である（例えば、"com2 "と "2 "のどちらでもよい）。

BaudRate
COMプロトコルを使用する場合 ボーレート 接続のボーレートを指定します。 ハードウェアがサポートするボーレートであれば、どのボーレートでも許可される。

COMChannel
COMプロトコルを使用する場合 COMチャンネル は、デバッグ・クライアントとの通信に使用する COM チャンネルを指定します。 これは0から254までの任意の値である。

プロトコル
SSLまたはSPIPEプロトコルが使用されている場合 Protocol はセキュアチャネル(S-Channel)プロトコルを指定する。 文字列 tls1、pct1、ssl2、または ssl3 のいずれかを指定できます。

Cert
SSL または SPIPE プロトコルを使用している場合、Cert は、証明書を指定します。 証明書の名前または証明書の拇印 (証明書のスナップインによって指定された 16 進数の文字列) のいずれかを指定できます。 構文 certuser=Cert を使用すると、デバッガーはシステムのストア (既定のストア) で証明書を検索します。 構文 machuser=Cert を使用すると、デバッガーはマシンのストアで証明書を検索します。 指定した証明書は、サーバー認証をサポートする必要があります。

非表示
別のデバッガーがすべてのアクティブなサーバーを表示するときに、サーバーが表示されないようにします。

password=Password
デバッグ・セッションに接続するために、デバッグ・クライアントに指定されたパスワードを要求する。 パスワード は12文字までの任意の英数字文字列である。

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

IcfEnable
インターネット接続ファイアウォールがアクティブな場合に、デバッガーが、TCP または名前付きパイプ通信に必要なポート接続を有効にできるようにします。 既定では、インターネット接続ファイアウォールはこれらのプロトコルで使用されるポートを無効にします。 いつ IcfEnable が TCP 接続で使用されている場合、デバッガーは Windows に Socket パラメーターで指定されたポートを開かせます。 IcfEnable が名前付きパイプ接続で使用されている場合、デバッガーは Windows に名前付きパイプに使用されるポート (ポート 139 および 445) を開かせます。 接続が終了しても、デバッガはこれらのポートを閉じない。

環境

項目	説明
モード	ユーザー モード、カーネル モード
対象	ライブ、クラッシュ ダンプ
プラットフォーム	すべて

追加情報

デバッグ・サーバーの起動方法の詳細については、以下を参照のこと デバッグサーバーの起動. 例については、以下を参照のこと クライアントとサーバーの例.

解説

このコマンドは、現在のデバッガーをデバッグ・サーバーに変える。 これは、デバッガーがすでに実行されている後にサーバーを起動することができます コマンドラインオプション は、デバッガーが起動したときにのみ発行できる。

これは、デバッグ・クライアントが現在のデバッグ・セッションに接続することを許可する。 異なるオプションを使用して複数のサーバーを起動し、異なる種類のデバッグクライアントがセッションに参加できるようにすることが可能であることに注意すること。