Visual Studioでの C++ Projectのリモート デバッグ

別のコンピューターでVisual Studio アプリケーションをデバッグするには、アプリを展開するコンピューターにリモート ツールをインストールして実行し、Visual Studioからリモート コンピューターに接続するようにprojectを構成してから、アプリを展開して実行します。

リモートデバッガーコンポーネント Remote_debugger_components

ユニバーサル Windows アプリ (UWP) のリモート デバッグの詳細については、「インストールされているアプリ パッケージ をデバッグするを参照してください。

必要条件

リモート デバッガーは、Windows 7 以降および Windows Server 2008 Service Pack 2 以降のバージョンの Windows Server でサポートされています。 要件の完全な一覧については、「要件」を参照してください。

リモート ツールをダウンロードしてインストールする

Visual Studio コンピューターではなく、デバッグ対象のリモート デバイスまたはサーバーで、次の表のリンクから正しいバージョンのリモート ツールをダウンロードしてインストールします。

• リモート ツールをインストールするコンピューターと同じアーキテクチャでダウンロードします。 たとえば、64 ビット オペレーティング システムを実行しているリモート コンピューターで 32 ビット アプリをデバッグする場合は、64 ビット リモート ツールをインストールします。
• ARM64 デバイスでARM64EC アプリケーションをリモート デバッグする場合は、ARM64 リモート ツールをインストールしてから、それらのツールと共にインストールされる x64 リモート デバッガーを起動します。 これは、Program Files (x86)\Microsoft Visual Studio<version>\Common7\IDE\Remote Debugger\x64 にあります。

リモート デバッガーを実行するには、リモート ツールをインストールするのではなく、リモート コンピューターに msvsmon.exe をコピーします。 ただし、リモート デバッガー構成ウィザード (rdbgwiz.exe) は、リモート ツールをインストールする場合にのみ使用できます。 リモート デバッガーをサービスとして実行する場合は、構成にウィザードを使用することが必要になる場合があります。 詳細については、「(省略可能) リモート デバッガーをサービスとして構成する」を参照してください。

リモート デバッガーを設定する

リモート デバッガーをインストールしたら、次の手順に従います。

1. リモート コンピューターで、の [スタート] メニューから リモート デバッガー を見つけて起動します。

   リモート コンピューターに対する管理アクセス許可がない場合は、リモート デバッガー アプリを右クリックし、[管理者 として実行]選択します。 それ以外の場合は、通常どおりに起動するだけです。

   管理者として実行されているプロセス、または別のユーザー アカウント (IIS など) で実行しているプロセスにアタッチする場合は、リモート デバッガー アプリを右クリックし、[管理者として実行] 選択。 詳細については、「リモート デバッガーを管理者として実行する」を参照してください。

2. リモート デバッガーを初めて起動するとき (またはリモート デバッガーを構成する前)、リモート デバッグ構成 ウィザードが表示されます。

   ほとんどのシナリオでは、[ リモート デバッグの構成] を選択します。

   リモート デバッガー構成のスクリーンショット。リモート デバッガーの構成

   ほとんどのシナリオでは、ウィザードの [Windows ファイアウォール の構成] ページに移動するまで、[次の ] を選択します。

   リモート デバッガー構成のスクリーンショット。リモート デバッガーの構成

3. リモート ツールを使用するネットワークの種類を少なくとも 1 つ選択します。 コンピューターがドメイン経由で接続されている場合は、最初の項目を選択する必要があります。 コンピューターがワークグループまたはホームグループ経由で接続されている場合は、必要に応じて 2 番目または 3 番目の項目を選択します。

   次に、[完了] を選択してリモート デバッガーを起動します。

4. 構成が完了すると、リモート デバッガーの ウィンドウが表示されます。

   リモート デバッガー ウィンドウリモート デバッガー ウィンドウのスクリーンショット

   リモート デバッガー ウィンドウリモート デバッガー ウィンドウのスクリーンショット

   これで、リモート デバッガーは接続を待機しています。 表示されているサーバー名とポート番号を使用して、Visual Studioでリモート接続の構成を設定します。

リモート デバッガーを停止するには、[ファイル] 選択します。 の [スタート] メニューまたはコマンド ラインから再起動できます。

<Remote debugger installation directory>\msvsmon.exe

C++ projectのリモート デバッグ

次の手順では、projectのパスは C:\remotetemp で、リモート コンピューターの名前は MySurface です。

1. CppConsoleApp 名前の C++ コンソール アプリケーションを作成する

2. アプリケーション内で簡単にアクセスできる場所にブレークポイントを設定しましょう。例えば、 関数が含まれている が良いでしょう。

3. Solution Explorerで、projectを右クリックし、Properties を選択します。 デバッグ タブを開きます。

4. [起動するデバッガー] を [リモート Windows デバッガー] に設定します。

   Visual Studio Solution Explorerプロパティの [デバッグ] タブのスクリーンショット。[起動するデバッガー] プロパティは、リモート Windows Debugger.

5. プロパティに次の変更を加えます。

   設定	価値
   リモート コマンド	C:\remotetemp\CppConsoleApp.exe
   作業ディレクトリ	C:\remotetemp
   リモート サーバー名	MySurface:portnumber
   接続	Windows認証を使用するリモート接続
   デバッガーの種類	ネイティブのみ
   展開ディレクトリ	C:\remotetemp
   展開するその他のファイル	$(ProjectDir)\data

   他のフォルダーを展開し、フォルダー内のすべてのファイルを同じフォルダーに展開する場合は、フォルダー名を指定します。

   プロパティの詳細については、「C++ デバッグ構成のProject設定を参照してください。

6. Solution Explorerで、ソリューションを右クリックし、 Configuration Managerを選択します。

7. デバッグ 構成の場合は、[展開] チェック ボックスをオンにします。

   

8. デバッグを開始 (デバッグ デバッグを開始), または (F5).

9. 実行可能ファイルは、リモート コンピューターに自動的に展開されます。

10. メッセージが表示されたら、ネットワーク資格情報を入力してリモート コンピューターに接続します。

    必要な資格情報は、ネットワークのセキュリティ構成に固有です。 たとえば、ドメイン コンピューターでは、セキュリティ証明書を選択するか、ドメイン名とパスワードを入力します。 ドメイン以外のコンピューターでは、正しいパスワードと共に、マシン名と有効なユーザー アカウント名 ( MySurface\ など) を入力できます。

11. Visual Studio コンピューターでは、ブレークポイントで実行が停止していることがわかります。

    ヒント

    または、別の手順としてファイルをデプロイすることもできます。 Solution Explorer,project ノードを右クリックし、Deploy を選択します。

    アプリケーションに必要なコード以外のファイルがある場合は、リモート Windows デバッガーが選択された [デバッガーのプロパティ] ページの [展開する追加ファイル] でセミコロンで区切られた一覧で指定できます。

    または、projectにファイルを含め、各ファイルの Content プロパティを YesProperties ページに設定することもできます。 これらのファイルは、[リモート Windows デバッガー] が選択された [デバッガー] プロパティ ページで指定した [配置ディレクトリ] にコピーされます。 展開ディレクトリのサブフォルダーにファイルをコピーする必要がある場合は、アイテムの種類を [ファイルのコピー] に変更し、その他のプロパティを指定することもできます。

リモート シンボルを使用したデバッグの設定

Visual Studio コンピューターで生成したシンボルを使用してコードをデバッグできる必要があります。 ローカル シンボルを使用すると、リモート デバッガーのパフォーマンスが向上します。

リモート シンボルを使用する必要がある場合は、シンボル検索パスに Windows ファイル共有を追加して、Visual Studioでリモート シンボルを指定する必要があります。

関連コンテンツ

• Visual Studio でのデバッグ
• デバッガーを初めて見ること
• リモート デバッグ用の Windows ファイアウォールの構成
• リモートデバッガーポートの割り当て
• リモート IIS コンピューターでの ASP.NET のデバッグ
• リモートデバッグエラーとトラブルシューティング