リモートの IIS コンピューター上の Visual Studio 2017 で ASP.NET Core をリモート デバッグする

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

このガイドでは、Visual Studio ASP.NET Core を設定して構成し、それを IIS に配置し、Visual Studio からリモート デバッガーをアタッチする方法について説明します。 ASP.NET 4.8 をリモート デバッグするには、「IIS コンピューター上の ASP.NET のリモート デバッグ」を参照してください。 Azure を使用して、IIS に配置し、デバッグすることもできます。 Azure App Service の場合、「Azure での ASP.NET Core のリモート デバッグ」を参照するか、Visual Studio Enterprise の場合、スナップショット デバッガー (.NET 4.6.1 が必要) を使用します。

必須コンポーネント

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

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

• Windows Server 2022 および IIS 10
• Windows Server 2019 および IIS 10
• Windows Server 2016 および IIS 10

ネットワーク要件

プロキシ経由で接続された 2 台のコンピューター間のデバッグはサポートされていません。 待機時間の長い接続や低帯域幅の接続 (ダイヤルアップ インターネットなど)、または国や地域をまたぐインターネット経由のデバッグは推奨されません。それらは失敗したり、過度に低速になったりするおそれがあります。 詳細な要件の一覧については、「要件」を参照してください。

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

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

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

• デバッグできるようにアプリが IIS で正しく設定、デプロイ、実行されていることを確認するためのヘルプが必要な場合は、この記事のすべての手順に従ってください。

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

1. 新しい ASP.NET Core Web アプリケーションを作成します。

   Visual Studio で、[ファイル]>[スタート ウィンドウ] の順に選択してから、[新しいプロジェクトの作成] を選択します。 検索ボックスに「Web アプリ」と入力してから、言語として C# を選択します。次に、[ASP.NET Core Web アプリケーション (Model-View-Controller)] を選択して、[次へ] を選択します。 次の画面で、プロジェクトに「MyASPApp」という名前を指定し、 [次へ] を選択します。

   推奨されるターゲット フレームワークまたは .NET 8 を選択し、[作成] を選択します。 バージョンは、サーバーにインストールされているバージョンと一致している必要があります。

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 Core をインストールする

1. ホスト システムに .NET Core ホスティング バンドルをインストールします。 このバンドルをインストールすることで、.NET Core ランタイム、.NET Core ライブラリ、ASP.NET Core モジュールがインストールされます。 詳細な手順については、IIS への発行に関するページを参照してください。

   現在の .NET Core ホスティング バンドルについては、ASP.NET Core ホスティング バンドルをインストールしてください。

   注意

   以前に IIS をインストールしている場合は、ASP.NET Core と共に ASP.NET Core IIS モジュールがインストールされます。 それ以外の場合は、ASP.NET Core IIS モジュールを手動でインストールします。

   .NET Core 2 の場合は、.NET Core Windows Server ホスティングをインストールします。

   注意

   システムにインターネット接続が設定されていない場合は、.NET Core Windows Server ホスティング バンドルをインストールする前に、 Microsoft Visual C++ 2015 再頒布可能パッケージ を入手してインストールしてください。

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

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

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

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

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

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

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

注意

発行設定をインポートするのではなく Web 配置を手動で構成する場合は、サーバー上のアプリ フォルダーが正しい値とアクセス許可で構成されていることを確認する必要があります (ASP.NET Web サイトの構成に関するセクションを参照してください)。

ASP.NET Core Web サイトを構成する

1. IIS マネージャーの左側のウィンドウで、 [接続] の [アプリケーション プール] を選択します。 DefaultAppPool を開き、 [.NET CLR バージョン] を [マネージド コードなし] に設定します。 これは ASP.NET Core に必要です。 既定の Web サイトで DefaultAppPool が使用されます。

2. DefaultAppPool を停止して再起動します。

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

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

注意

Web Platform Installer のサポートは、2022 年 7 月 1 日に終了しました。 詳細については、「Web Platform Installer - サポート終了と製品/アプリケーション フィードの終了」を参照してください。 Web 配置 4.0 を直接インストールして、発行設定ファイルを作成できます。

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 でアプリを起動して、正しく実行されていることを確認します。
• ASP.NET Core の場合、DefaultAppPool の [アプリケーション プール] フィールドが [No Managed Code] (マネージド コード なし) に設定されていることを確認します。

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

重要

リリース構成をデバッグする場合は、公開時に web.config ファイルでデバッグを無効にします。

1. [その他のオプション]>[編集] を選択してプロファイルを編集し、[設定] を選択します。
2. [保存] を選択して、アプリを再公開します。
3. [デバッグ] 構成を選択し、[ファイル公開] オプションの [ターゲットで追加ファイルを削除する] を選択します。

警告

ユーザー名とパスワードの資格情報 (基本認証) を使用することは、最も安全な認証方法ではありません。 可能な限り、別の方法を使用してください。 たとえば、Visual Studio からパッケージに発行し、コマンド ラインから WebDeploy.exe を使用してパッケージをデプロイすることを検討します。 この方法では、IIS マネージャーを使用して、Web サーバーに発行できる承認済みの Windows ユーザーを構成し、その Windows ユーザー アカウントで WebDeploy.exe 実行できます。 「 IIS 8.0 以降での Web 配置のインストールと構成を参照してください。 パスワード資格情報を使用する場合は、必ず強力なパスワードを使用し、パスワードが漏洩または共有されないように保護してください。

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

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

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

1. Windows エクスプローラーを開き、ASP.NET Core プロジェクトのデプロイに使用する新しいフォルダー C:\Publish を作成します。

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

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

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

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

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

7. [接続] の [アプリケーション プール] を選択します。 DefaultAppPool を開き、[アプリケーション プール] フィールドを [マネージ コードなし] に設定します。

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

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

重要

組み込みアカウントに関連するセキュリティ情報については、「 IIS 7 の組み込みユーザー アカウントとグループ アカウントの管理」を参照してください。

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

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

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 リモート ツールをインストールします。

バージョン	Link	メモ
Visual Studio 2022	リモート ツール	すべてのバージョンの Visual Studio 2022 と互換性があります。 デバイスのオペレーティング システム (x86、x64 (AMD64)、または ARM64) に一致するバージョンをダウンロードします。 古いバージョンの Windows Server でのリモート ツールのダウンロードについては、「ファイルのダウンロードのブロック解除」を参照してください。
Visual Studio 2019	リモート ツール	Visual Studio 2019 用のリモート ツールは My.VisualStudio.com で入手できます。 メッセージが表示されたら、無料の Visual Studio Dev Essentials プログラムに参加するか、または Visual Studio サブスクリプション ID でサインインします。 デバイスのオペレーティング システム (x86、x64 (AMD64)、または ARM64) に一致するバージョンをダウンロードします。 古いバージョンの Windows Server でのリモート ツールのダウンロードについては、「ファイルのダウンロードのブロック解除」を参照してください。
Visual Studio 2017	リモート ツール	Visual Studio 2017 用のリモート ツールは My.VisualStudio.com で入手できます。 メッセージが表示されたら、無料の Visual Studio Dev Essentials プログラムに参加するか、または Visual Studio サブスクリプション ID でサインインします。 デバイスのオペレーティング システム (x86、x64 (AMD64)、または ARM64) に一致するバージョンをダウンロードします。 Windows Server の場合、リモート ツールのダウンロードについては、ファイルのダウンロードのブロック解除に関するページを参照してください。
Visual Studio 2015	リモート ツール	Visual Studio 2015 用のリモート ツールは My.VisualStudio.com で入手できます。 メッセージが表示されたら、無料の Visual Studio Dev Essentials プログラムに参加するか、または Visual Studio サブスクリプション ID でサインインします。 Windows Server の場合、リモート ツールのダウンロードについては、ファイルのダウンロードのブロック解除に関するページを参照してください。
Visual Studio 2013	リモート ツール	Visual Studio 2013 ドキュメントのダウンロード ページ
Visual Studio 2012	リモート ツール	Visual Studio 2012 ドキュメントのダウンロード ページ

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

注意

• ARM デバイスで Windows 10 以降のアプリをデバッグするには、最新バージョンのリモート ツールで使用できる ARM64 を使用します。
• Windows RT デバイスで Windows 10 アプリをデバッグするには、ARM を使用します。これは、Visual Studio 2015 リモート ツールのダウンロードでのみ使用できます。
• ARM64 オペレーティング システムで x64 アプリをデバッグするには、ARM64 リモート ツールと共にインストールされる x64 の msvsmon.exe を実行します。

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

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

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

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

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

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

   

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

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

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

   

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

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

<Remote debugger installation directory>\msvsmon.exe

注意

追加のユーザーのアクセス許可を追加し、認証モード、またはリモート デバッガーのポート番号を変更する必要がある場合は、「リモート デバッガーを構成する」を参照してください。

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

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

Visual Studio 2022 バージョン 17.10 Preview 2 以降では、[プロセスにアタッチ] ダイアログ ボックスが変更されています。 以前のダイアログ ボックスに合った手順が必要な場合は、Visual Studio 2019 ビュー (記事の左上のバージョン セレクター) に切り替えます。

1. Visual Studio コンピューター上で、デバッグしようとしているソリューション (この記事のすべての手順を実行している場合は、MyASPApp) を開きます。

2. Visual Studio で、デバッグ > プロセスにアタッチ(Ctrl + Alt + P) を選択します。

   ヒント

   Visual Studio 2017 以降のバージョンで以前にアタッチしたものと同じプロセスに再アタッチするには、[デバッグ] > [プロセスに再アタッチする] (Shift+Alt+P) を使用します。

3. [接続の種類] を [リモート] (Windows) に設定します。

   [接続ターゲット] オプションが表示されます。

   [接続ターゲット] を <[リモート コンピューター名]> に設定し、Enter キーを押します。

   Visual Studio で必要なポートがコンピューター名に追加されていることを確認します (<リモート コンピューター名>:port という形式で表示されます)。

   Visual Studio 2022 では、<リモート コンピューター名>:4026 が表示されます

   ポートは必須です。 ポート番号が表示されない場合は、手動で追加します。

4. 更新 を選択します。

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

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

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

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

6. プロセス名の最初の文字を入力すると、アプリをすばやく見つけることができます。

   • IIS でインプロセス ホスティング モデルを使用している場合は、正しい w3wp.exe プロセスを選択します。 .NET Core 3 以降では、このプロセスが既定です。

   • それ以外の場合は、dotnet.exe プロセスを選択します (これはアウト プロセス ホスティング モデルです)。

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

   

7. 添付を選択します。

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

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

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

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

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

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

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

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

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

注意

Azure VM では、ネットワーク セキュリティ グループを使用してポートを開く必要があります。

必要なポート:

• 80: IIS (HTTP) に必要です。

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

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

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

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

ポートを開く

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

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

2. 次に、[受信の規則] > [新しい規則] > [ポート] を選び、[次へ] を選択します。 (UDP 3702 の場合は、代わりに [送信規則] を選択します)。

3. [特定のローカル ポート] にポート番号を入力し、[次へ] を選択します。

4. [接続を許可する] を選択し、[次へ] を選択します。

5. ポートに対して有効にする 1 つ以上のネットワークの種類を選択し、[次へ] を選択します。

   選ぶ種類には、リモート コンピューターが接続しているネットワークが含まれている必要があります。

6. 受信規則の名前 (例えば、IIS、 Web 配置、または msvsmon など) を追加し、[完了]を選択します。

   [受信の規則] または [送信の規則] の一覧に新しい規則が表示されます。

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

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