.server (デバッグ サーバーの作成)
.server コマンドはデバッグ サーバーを起動し、現在のデバッグ セッションへのリモート接続を許可します。
大事な
リモート デバッグを使用する場合は、セキュリティに関する重要な考慮事項があります。 セキュア モードの有効化に関する情報を含む詳細については、「Windows デバッグ ツールのセキュリティに関する考慮事項」を参照してください。
推奨される接続方法と、いくつかの追加のセキュリティ
.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]
セキュリティで保護されていない接続方法の を
.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]
パラメーター
PipeName
NPIPE または SPIPE プロトコルを使用する場合、PipeName はパイプの名前として機能する文字列です。 各パイプ名は、一意のデバッグ サーバーを識別する必要があります。 パイプ名を再利用しようとすると、エラー メッセージが表示されます。
PipeName には、スペースまたは引用符を含めることはできません。
PipeName には、%x や %dなどの数値 printfスタイルの書式コードを含めることができます。 デバッガーはこれをデバッガーのプロセス ID に置き換えます。 このような 2 つ目のコードは、デバッガーのスレッド ID に置き換えられます。
ソケット
TCP または SSL プロトコルを使用する場合、ソケット はソケット ポート番号です。
コロンで区切ってポートの範囲を指定することもできます。 デバッガーは、この範囲内の各ポートをチェックして、空きがあるかどうかを確認します。 空きポートが検出され、エラーが発生しない場合は、デバッグ サーバーが作成されます。 デバッグ クライアントは、サーバーへの接続に使用される実際のポートを指定する必要があります。 実際のポートを確認するには、「デバッグ サーバーの検索
clicon=クライアント
TCP または SSL プロトコルを使用し、clicon パラメーターを指定すると、リバース接続 が開きます。 つまり、デバッグ サーバーは、クライアントが連絡先を開始するのではなく、デバッグ クライアントに接続しようとします。 これは、通常の方向の接続を妨げているファイアウォールがある場合に役立ちます。
クライアント は、デバッグ クライアントが存在するか、作成されるコンピューターのネットワーク名を指定します。 2 つの最初の円記号 (\\) は省略可能です。
clicon
COMPort
COM プロトコルを使用する場合、COMPort は、使用する COM ポートを指定します。 プレフィックス COM は省略可能です (たとえば、"com2" と "2" の両方を使用できます)。
BaudRate
COM プロトコルを使用する場合、BaudRate は、接続を実行するボー レートを指定します。 ハードウェアでサポートされているボー レートは許可されます。
COMChannel の
COM プロトコルを使用する場合、COMChannel は、デバッグ クライアントとの通信に使用する COM チャネルを指定します。 これには、0 ~ 254 の任意の値を指定できます。
プロトコル
SSL または SPIPE プロトコルを使用する場合、プロトコル は、セキュア チャネル (S チャネル) プロトコルを指定します。 これには、tls1、pct1、ssl2、または ssl3 のいずれかの文字列を指定できます。
証明書 の
SSL または SPIPE プロトコルを使用する場合は、証明書
非表示の を
別のデバッガーがすべてのアクティブ なサーバーを表示するときに、サーバーが表示されないようにします。
password=Password
デバッグ セッションに接続するには、指定したパスワードを指定するデバッグ クライアントが必要です。
パスワード には、最大 12 文字の任意の英数字文字列を使用できます。
ipversion=6
(Windows 6.6.07 以前のデバッグ ツールのみ)TCP を使用してインターネットに接続するときに、デバッガーでバージョン 4 ではなく IP バージョン 6 を使用するように強制します。 Windows Vista 以降のバージョンでは、デバッガーは IP バージョン 6 の自動既定値を試み、このオプションを不要にします。
IcfEnable の
インターネット接続ファイアウォールがアクティブな場合に、デバッガーで TCP または名前付きパイプ通信に必要なポート接続を有効にします。 既定では、インターネット接続ファイアウォールは、これらのプロトコルで使用されるポートを無効にします。 IcfEnable
環境
| アイテム | 形容 |
|---|---|
| モード | ユーザー モード、カーネル モード |
| ターゲット | ライブ、クラッシュ ダンプ |
| プラットフォーム | すべての |
追加情報
デバッグ サーバーを起動する方法の詳細については、「デバッグ サーバーのアクティブ化
備考
このコマンドは、現在のデバッガーをデバッグ サーバーに変換します。 これにより、デバッガーが既に実行された後にサーバーを起動できますが、-server コマンド ライン オプション はデバッガーの起動時にのみ発行できます。
これにより、デバッグ クライアントは現在のデバッグ セッションに接続できます。 異なるオプションを使用して複数のサーバーを起動し、さまざまな種類のデバッグ クライアントをセッションに参加させることができることに注意してください。
大事な
TCP、NPIPE、または COM プロトコルでパスワードを使用すると、パスワードが暗号化されないため、保護の量はごくわずかです。 SSL または SPIPE プロトコルと共にパスワードを使用すると、パスワードが暗号化されます。 セキュリティで保護されたリモート セッションを確立する場合は、SSL または SPIPE プロトコルを使用する必要があります。