リモートの IIS コンピューター上の ASP.NET のリモート デバッグ

IIS に配置されている ASP.NET アプリケーションをデバッグするには、アプリを配置したコンピューターにリモート ツールをインストールして実行し、Visual Studio から実行中のアプリにアタッチします。

このガイドでは、ASP.NET MVC 4.8 アプリケーションを設定して構成し、それを IIS に配置し、Visual Studio からリモート デバッガーをアタッチする方法について説明します。

必須コンポーネント

この記事に記載されている手順を実行するには、Visual Studio 2019 以降のバージョンが必要です。

これらの手順は、次のサーバー構成でテストされています。

• Windows Server 2022 および IIS 10
• Windows Server 2012 R2 および IIS 8 (Windows Server 2008 R2 では、サーバーの手順が異なります)

ネットワーク要件

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

アプリは既に IIS で実行されていますか?

この記事には、Windows サーバー上で IIS の基本構成を設定し、Visual Studio からアプリを配置する手順が含まれています。 これらの手順は、サーバーに必要なコンポーネントがインストールされていること、アプリが正しく実行できること、リモート デバッグの準備ができていることを確認するために含まれています。

• アプリが IIS で実行されていて、リモート デバッガーをダウンロードしてデバッグを開始するだけの場合は、「Windows Server 上でリモート ツールをダウンロードしてインストールする」を参照してください。

• アプリが IIS で正しく設定、配置、および実行されていることを確かめてデバッグできるようにするためにヘルプが必要な場合は、このトピックのすべての手順に従ってください。

Visual Studio コンピューター上で ASP.NET 4.8 アプリケーションを作成する

1. MVC の ASP.NET アプリケーションを新規作成します。

   Visual Studio で、[ファイル]>[スタート ウィンドウ] の順に選択してから、[新しいプロジェクトの作成] を選択します。 検索ボックスに「asp.net フレームワーク」と入力して、[ASP.NET Web アプリケーション (.NET Framework)] を選択します。 表示されるダイアログ ボックスで、プロジェクトに「MyASPApp」という名前を付け、[ASP.NET Framework 4.8] を選択してから [作成] を選択します。

   [MVC] を選択し、 [作成] を選択します。

2. Controllers フォルダー内の HomeController.cs ファイルを開き、Privacy メソッドの return View; ステートメントにブレークポイントを設定してください。

   以前のテンプレートでは、Privacy.cshtml.cs ファイルを開き、OnGet メソッドにブレークポイントを設定してください。

Windows Server に IIS をインストールして構成する

ここでは、IIS の基本的な構成に関する手順のみを説明します。 詳細情報や Windows デスクトップ マシンへのインストールについては、IIS への発行に関する記事または「ASP.NET 3.5 および ASP.NET 4.5 を使用する IIS 8.0」を参照してください。

Windows Server オペレーティング システムの場合は、サーバー マネージャーの [管理] リンクまたは [ダッシュボード] リンクから役割と機能の追加ウィザードを使用します。 [サーバーの役割] のステップで、 [Web サーバー (IIS)] チェック ボックスをオンにします。

(Windows Server 2022) 表示されるダイアログ ボックスで、[機能の追加] を選択して IIS 管理コンソールを追加します。

[役割サービス] のステップで、希望する IIS の役割サービスを選択するか、既定の役割サービスをそのまま使用します。 発行設定と Web 配置を使用して配置を有効にする場合は、次の機能が選択されていることを確認してください。

• IIS 管理スクリプトおよびツール
• Management Service
• IIS 管理コンソール

確認のステップを経て Web サーバーの役割とサービスをインストールします。 Web サーバー (IIS) の役割をインストールした後、サーバーと IIS の再起動は必要ありません。

Windows Server 上でブラウザーのセキュリティ設定を更新する

以前のバージョンの Windows Server を使用している場合、一部の Web サーバー コンポーネントをダウンロードできるようにするには、信頼されたサイトとして一部のドメインを追加することが必要な場合があります。 信頼済みサイトを追加するには、[インターネット オプション] > [セキュリティ] > [信頼済みサイト] > [サイト] に移動します。 次のドメインを追加します。

• microsoft.com
• go.microsoft.com
• download.microsoft.com
• iis.net

ソフトウェアをダウンロードすると、さまざまな Web サイトのスクリプトとリソースを読み込むためのアクセス許可を付与する要求を受け取る場合があります。 これらのリソースの一部は必須ではありませんが、プロセスを簡略化するために、プロンプトが表示されたら [追加] を選択します。

Windows Server に ASP.NET 4.8 をインストールする

ASP.NET を IIS にインストールするための詳細な情報が必要な場合は、「ASP.NET 3.5 と ASP.NET 4.5を使用する IIS 8.0」を参照してください。

1. サーバー マネージャーの左側のペインで、 [IIS] を選択します。 サーバーを右クリックし、[役割と機能の追加] を選択します。

2. ウィザードで、[機能] セクションに進み、ASP.NET 4.8 をインストールします。

   

   注意

   Windows Server 2008 R2 を使用している場合は、次のコマンドを使用して、代わりに ASP.NET 4 をインストールしてください。

   C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir

3. システムを再起動します (または、コマンド プロンプトから net stop was /y の後に続けて net start w3svc を実行して、システム PATH への変更を適用します)。

配置オプションを選択する

IIS へのアプリの配置についてヘルプが必要な場合は、これらのオプションを検討してください。

• IIS で発行設定ファイルを作成し、Visual Studio に設定をインポートして配置します。 シナリオによっては、この方法でアプリを迅速に配置できます。 発行設定ファイルを作成すると、IIS でアクセス許可が自動的に設定されます。

• ローカル フォルダーに発行し、適切な方法で出力を IIS 上の準備されたアプリ フォルダーにコピーすることで配置します。

(省略可能) 発行設定ファイルを使用してデプロイする

このオプションを使用すると、発行設定ファイルを作成し、それを Visual Studio にインポートすることができます。

Windows Server に Web 配置をインストールして構成する

Web 配置は、UI から発行設定ファイルの作成を有効にする追加の構成機能を提供しています。

1. [IIS 管理スクリプトおよびツール] をまだインストールしていない場合は、今すぐインストールします。

   [サーバーの役割の選択]>[Web Server (IIS)]>[管理ツール] の順に移動して、 [IIS 管理スクリプトおよびツール] の役割を選択し、 [次へ] をクリックしてその役割をインストールします。

   

   発行設定ファイルの作成を有効にするには、このスクリプトとツールが必要です。

   管理サービスと IIS 管理コンソールもインストールしてください (既にインストールされている可能性があります)。

2. Windows Server で、Web 配置 4.0 をダウンロードします。

3. Web 配置インストール プログラムを実行し、一般的なインストールではなく [完全] インストールを選択してください。

   完全インストールでは、発行設定ファイルを生成するために必要なコンポーネントが取得されます。 (代わりに [カスタム] を選択すると、次の図に示すようにコンポーネントの一覧が表示されます。)

   

4. (省略可能) [コントロール パネル] > [システムとセキュリティ] > [管理ツール] > [サービス] を開くことで、Web 配置が正常に実行されていることを確認した後、以下を確認します。

   • Web Deployment Agent Service が実行されている (古いバージョンではサービス名が異なります)。

   • Web 管理サービスが実行されている。

   いずれかのエージェント サービスが実行されていない場合は、Web Deployment Agent サービスを再起動します。

   Web Deployment Agent サービスがまったく表示されない場合は、[コントロール パネル] > [プログラム] > [プログラムのアンインストール] の順に移動し、[Microsoft Web Deploy <バージョン>] を見つけます。 インストールの [変更] を選び、Web 配置コンポーネントに [ローカル ハード ドライブにインストール] を選択していることを確認します。 インストールの変更手順を完了します。

Windows Server 上の IIS に発行設定ファイルを作成する

1. IIS 管理コンソールを閉じて、もう一度開き、UI の更新された構成オプションを表示します。

2. IIS で [既定の Web サイト] を右クリックして、 [展開]>[Web 配置による発行の有効化] の順に選びます。

   

   [配置] メニューが表示されない場合は、前のセクションを参照して Web 配置が実行されていることを確認します。

3. [Web 配置による発行の有効化] ダイアログ ボックスで、この設定を確認します。

4. [設定] をクリックします。

   [結果] パネルで、出力に特定のユーザーに付与されているアクセス権が示され、 .publishsettings のファイル拡張子が付いたファイルがダイアログ ボックスで示されている場所に作成されています。

   <?xml version="1.0" encoding="utf-8"?>
   <publishData>
     <publishProfile
       publishUrl="https://myhostname:8172/msdeploy.axd"
       msdeploySite="Default Web Site"
       destinationAppUrl="http://myhostname:80/"
       profileName="Default Settings"
       publishMethod="MSDeploy"
       userName="myhostname\myusername" />
   </publishData>
   

   ご利用の Windows Server と IIS の構成によって、XML ファイルには異なる値が表示されます。 表示される値に関する詳細のいくつかを次に示します。

   • publishUrl 属性で参照されている msdeploy.axd ファイルは、Web 配置用に動的に作成された HTTP ハンドラー ファイルです。 (テスト目的で、通常、http://myhostname:8172 も動作します。)

   • publishUrl ポートは、Web 配置の既定値であるポート 8172 に設定されます。

   • destinationAppUrl ポートは、IIS の既定値であるポート 80 に設定されます。

   • 後の手順で Visual Studio でホスト名を使用してリモート ホストに接続できない場合は、ホスト名の代わりにサーバーの IP アドレスでテストします。

     注意

     Azure VM で実行されている IIS に発行する場合は、ネットワーク セキュリティ グループに Web 配置ポートと IIS 用のポートを開く必要があります。 詳細については、仮想マシンへのポートを開く方法に関するページを参照してください。

5. Visual Studio を実行しているコンピューターにこのファイルをコピーします。

Visual Studio で発行設定をインポートして配置する

1. Visual Studio で ASP.NET プロジェクトを開いているコンピューターで、ソリューション エクスプローラーのプロジェクトを右クリックし、 [発行] を選択します。

   以前に発行プロファイルを構成してある場合、 [発行] ウィンドウが表示されます。 [新規] または [新しいプロファイルの作成] をクリックします。

2. プロファイルをインポートするオプションを選択します。

   [発行] ダイアログ ボックスで [プロファイルのインポート] をクリックします。

   

3. 前のセクションで作成した発行設定ファイルの場所に移動します。

4. [発行設定ファイルのインポート] ダイアログで、前のセクションで作成したプロファイルに移動して選択し、 [開く] をクリックします。

   [完了] をクリックして発行プロファイルを保存し、 [発行] をクリックします。

   Visual Studio で配置プロセスを開始します。[出力] ウィンドウに進行状況と結果が表示されます。

   配置エラーが発生した場合は、[その他の処理]>[編集] をクリックして設定を編集します。 設定を変更し、 [検証] をクリックして新しい設定をテストします。 ホスト名が見つからない場合は、[サーバー] と [参照先 URL] の両方のフィールドにホスト名ではなく IP アドレスを入力してみてください。

   

アプリが正常に配置されたら、自動的に起動されます。 アプリが配置後に起動しない場合は、IIS でアプリを起動して、正しく実行されていることを確認します。

準備ができたら、デバッグ構成に切り替えます。

(省略可能) ローカル フォルダーに発行して配置する

PowerShell、RoboCopy を使用してアプリを IIS にコピーする場合、またはファイルを手動でコピーする場合は、このオプションを使用してアプリを配置できます。

Windows Server コンピューター上で ASP.NET Web サイトを構成する

1. Windows エクスプローラーを開き、新しいフォルダー C:\Publish を作成します。後でここに ASP.NET プロジェクトを配置します。

2. インターネット インフォメーション サービス (IIS) マネージャーをまだ開いていない場合は開きます (サーバー マネージャーの左側のペインで、 [IIS] を選択します。 サーバーを右クリックして [インターネット インフォメーション サービス (IIS) マネージャー] を選択します。)

3. 左側のペインの [接続] で、 [サイト] に移動します。

4. [既定の Web サイト] を選択し、 [基本設定] を選択して、 [物理パス] を C:\Publish に設定します。

5. [既定の Web サイト] ノードを右クリックして、 [アプリケーションの追加] を選択します。

6. [エイリアス] フィールドを「MyASPApp」に設定し、既定のアプリケーション プール (DefaultAppPool) のままにして [物理パス] を C:\ Publish に設定します。

7. [接続] の [アプリケーション プール] を選択します。 DefaultAppPool を開き、[アプリケーション プール] フィールドを [ASP.NET v4.0] に設定します (ASP.NET 4.5 はアプリケーション プールのオプションではありません)。

8. IIS マネージャーでサイトを選択した状態で、[アクセス許可の編集] を選択し、IUSR、IIS_IUSRS、またはアプリケーション プール用に構成されたユーザーが、読み取りと実行の権限を持つ承認済みユーザーであることを確認します。

   これらのアクセス権を持つユーザーが 1 人も表示されない場合は、読み取りおよび実行アクセス権を持つユーザーとして IUSR を追加する手順を実行します。

Visual Studio からローカル フォルダーに発行してアプリを発行および配置する

ファイル システムやその他のツールを使用して、アプリを発行および配置することもできます。

ASP.NET 4.8 の場合は、web.config ファイルに正しいバージョンの .NET が一覧表示されていることを確認します。

• ASP.NET 4.8 をターゲットとしている場合は、このバージョンの値が web.config ファイルに一覧表示されていることを確認します。

      <system.web>
        <compilation debug="true" targetFramework="4.8" />
        <httpRuntime targetFramework="4.8" />
        <httpModules>
          <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" />
        </httpModules>
      </system.web>
      ```
  
  

• 4.8 ではなく ASP.NET 4 をインストールする場合、バージョン値は web.config ファイルで 4.0 として指定する必要があります。

アプリを発行して配置するには、これらの手順に従います。

1. ソリューション エクスプローラーで、プロジェクト ノードを右クリックし、[発行] (Web Forms の場合は [Web アプリの発行]) を選択します。

   以前に発行プロファイルを構成してある場合、 [発行] ウィンドウが表示されます。 [新しいプロファイル] をクリックします。

2. [発行] ダイアログ ボックスで [フォルダー] を選択し、 [参照] をクリックして、新しいフォルダー C:\Publish を作成します。

   

   [完了] をクリックし、発行プロファイルを保存します。

   

   [完了] をクリックし、発行プロファイルを保存します。

3. デバッグ構成に切り替えます。

   [編集] を選択してプロファイルを編集し、 [設定] を選択します。 [デバッグ] 構成を選択し、[ファイル公開] オプションの [ターゲットで追加ファイルを削除する] を選択します。

   

   注意

   リリース ビルドを使用する場合は、発行時に web.config ファイルでデバッグを無効にします。

4. [発行] をクリックします。

   アプリケーションによって、プロジェクトの [デバッグ] 構成がローカル フォルダーに発行されます。 出力ウィンドウに進行状況が表示されます。

5. Visual Studio コンピューターの ASP.NET プロジェクト ディレクトリを、Windows Server コンピューター上の ASP.NET アプリ用に構成されたローカル ディレクトリ (この例では C:\Publish) にコピーします。 このチュートリアルでは、手動でコピーすることを想定していますが、PowerShell、Xcopy、Robocopy などの他のツールを使用することもできます。

   注意事項

   コードの変更やリビルドが必要な場合は、再発行してこの手順を繰り返す必要があります。 リモート コンピューターにコピーした実行可能ファイルは、ローカルのソースとシンボルに正確に一致している必要があります。 これを行わないと、プロセスをデバッグしようとしたときに Visual Studio で cannot find or open the PDB file の警告が表示されます。

6. Windows Server 上のブラウザーでアプリを開いて、アプリを正しく実行できることを確認します。

   アプリが正常に動作しない場合は、サーバーにインストールされている ASP.NET のバージョンと Visual Studio マシンのバージョンが一致していないか、IIS または Web サイトの構成に問題がある可能性があります。 前述の手順を再確認してください。

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

Visual Studio のバージョンと一致するバージョンのリモート ツールをダウンロードします。

Visual Studio マシンではなく、デバッグするリモート デバイスまたはサーバーで、次の表のリンクから適切なバージョンのリモート ツールをダウンロードしてインストールします。

• ご使用のバージョンの Visual Studio に対応したリモート ツールの最新の更新版をダウンロードしてください。 以前のバージョンのリモート ツールには、新しいバージョンの Visual Studio との互換性がありません。 (たとえば、Visual Studio 2019 を使用している場合は、Visual Studio 2019 用のリモート ツールの最新の更新プログラムをダウンロードします。このシナリオでは、Visual Studio 2022 用のリモート ツールをダウンロードしないでください)。
• インストール先のマシンと同じアーキテクチャを持つリモート ツールをダウンロードします。 たとえば、x64 オペレーティング システムを実行しているリモート コンピューター上で x86 アプリケーションをデバッグする場合は、x64 のリモート ツールをインストールします。 ARM64 オペレーティング システムで x86、ARM、または x64 アプリケーションをデバッグするには、ARM64 リモート ツールをインストールします。

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

Windows Server 上でリモート デバッガーを設定する

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

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

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

2. リモート デバッガーを初めて (またはその構成を完了する前に) 開始すると、リモート デバッグ構成ウィザードが表示されます。

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

   

   

   Windows Web Services API がインストールされていない場合 (これは、Windows Server 2008 R2 でのみ発生します) は、 [インストール] ボタンを選択します。

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

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

   次に、[リモート デバッグの構成] を選択してリモート デバッガーを起動します。

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

   

   

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

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

<Remote debugger installation directory>\msvsmon.exe

リモート デバッガーをサービスとして実行する方法の詳細については、サービスとしてのリモート デバッガーの実行に関するページを参照してください。

Visual Studio コンピューターから ASP.NET アプリケーションにアタッチする

4. 更新 を選択します。

   [選択可能なプロセス] ウィンドウにプロセスがいくつか表示されます。

   プロセスが表示されない場合は、リモート コンピューター名ではなく IP アドレスを使用してみてください (ポートは必須です)。 コマンド ラインで ipconfig を使用すると、IPv4 アドレスを取得できます。

   [検索] ボタンを使用する場合は、サーバーで発信 UDP ポート 3702 を開く必要があります。

5. [すべてのユーザーからのプロセスを表示する] をオンにします。

6. プロセス名の最初の文字を入力すると、ASP.NET 4.5 用の w3wp.exe をすばやく見つけることができます。

   w3wp.exe と表示されているプロセスが複数ある場合は、 [ユーザー名] 列を確認します。 一部のシナリオでは、 [ユーザー名] 列に IIS APPPOOL\DefaultAppPool などのアプリ プール名が表示されます。 アプリ プールが表示される場合、正しいプロセスを特定する簡単な方法は、デバッグするアプリ インスタンスの新しい名前付きアプリ プールを作成することです。[ユーザー名] 列で簡単に見つけられるようになります。

   

   

7. 添付を選択します。

8. リモート コンピューターの Web サイトを開きます。 ブラウザーで、http://<リモート コンピューター名> に移動します。

   ASP.NET の Web ページが表示されるはずです。

9. 実行中の ASP.NET アプリケーションで、[プライバシー] ページへのリンクを選択してください。

   Visual Studio で、ブレークポイントにヒットするはずです。

   ブレークポイントをアタッチできない、またはヒットできない場合は、「リモート デバッグのトラブルシューティング」を参照してください。

IIS 展開のトラブルシューティング

• ホスト名を使用してホストに接続できない場合は、代わりに IP アドレスを試してみてください。
• リモート サーバーで必要なポートが開かれていることを確認します。
• ご自分のアプリで使用している ASP.NET のバージョンが、サーバーにインストールしたバージョンと同じであることを確認します。 ご自分のアプリでは、 [プロパティ] ページでバージョンを表示および設定できます。 アプリに別のバージョンを設定するには、そのバージョンがインストールされている必要があります。
• アプリを開こうとしたとき、証明書の警告が表示される場合は、サイトを信頼することを選択します。 警告を既に閉じてしまった場合は、プロジェクトの発行プロファイル (*.pubxml ファイル) を編集し、<AllowUntrustedCertificate>true</AllowUntrustedCertificate> 要素を追加します (テスト用のみ)。
• 配置が完了したら、IIS でアプリを起動し、正しく配置されたことをテストします。
• Visual Studio の [出力] ウィンドウで状態情報を確認し、エラー メッセージを確認します。

Windows Server で必要なポートを開く

ほとんどの設定では、ASP.NET とリモート デバッガーのインストールによって必要なポートが開かれます。 ただし、ポートが開いているかどうかを確認する必要がある場合があります。

必要なポート:

• 80: IIS に必要です。

• 4024: Visual Studio 2019 からのリモート デバッグに必要です (詳細については、「リモート デバッガーのポートの割り当て」を参照してください)。

• UDP 3702: (省略可能) 検出ポートを使うと、Visual Studio でリモート デバッガーにアタッチするときに [検索] ボタンを使用できます。

また、ASP.NET をインストールしている場合、これらのポートは既に開かれているはずです。

• 8172: (省略可能) Web 配置で Visual Studio からアプリを配置する場合に必要です。

ポートを開く

1. Windows サーバーでポートを開くには、[スタート] メニューを開き、「Windows Defender ファイアウォール」または「セキュリティが強化された Windows ファイアウォール」を検索します。

   Windows Defender ファイアウォールの場合は、[詳細設定] を選択します。

2. 次に、[受信規則] > [新しい規則] > [ポート] を選びます。 [次へ] を選択します。[特定のローカル ポート] にポート番号を入力し、[次へ] をクリックします。その後、[接続を許可する]、[次へ] の順に選択し、受信規則の名前 (IIS、Web Deploy、または msvsmon) を追加します。

   Windows ファイアウォールの構成の詳細については、「Windows ファイアウォールをリモート デバッグ用に構成する」を参照してください。

3. 他の必要なポートに対してさらにルールを作成します。