.NET アップグレード アシスタントをインストールする

この記事では、Visual Studio に .NET アップグレード アシスタントをインストールする方法、またはコマンド ライン インターフェイス (CLI) ツールを使用する方法について説明します。

前提条件

• Windows オペレーティング システム
• Visual Studio 2026（または Visual Studio 2022 バージョン 17.14.17 以降）
• .NET SDK 8 以降。

メソッド

.NET アップグレード アシスタントは Visual Studio に組み込まれているか、.NET グローバル ツールとしてインストールできます。

アップグレード アシスタントは、開いているソリューションまたはプロジェクトで Visual Studio 内で実行されます。 .NET グローバル ツールは、現在のディレクトリ以下のソリューションまたはプロジェクト ファイルで実行される対話型コンソール アプリケーションです。

Visual Studio でプロジェクトを開いてアップグレードする効率的なエクスペリエンスが必要な場合は、アップグレード アシスタントを使用します。

Visual Studio

次の手順では、Visual Studio でレガシ アップグレード アシスタントを有効にします。

1. Visual Studio を開きます。

   [最近開いたものを開く] \ [作業を開始]ウィンドウが開いた場合は、[コードなしで続行]リンクを選択します。

2. [ツール>オプション] メニューを選択すると、[オプション] ウィンドウが開きます。

3. すべての設定>プロジェクトとソリューション>Modernization に移動します。

4. [ 従来のアップグレード アシスタントを有効にする] 項目を選択します。

5. Visual Studio を再起動する

   

.NET グローバル ツール

次の手順では、.NET アップグレード アシスタントを .NET グローバル ツールとしてインストールします。 .NET アップグレード アシスタントは、 upgrade-assistant NuGet パッケージで配布されます。

1. パスに dotnet コマンドがあるコマンド プロンプトを開きます。

2. 次のコマンドを実行してツールをインストールします。

   dotnet tool install -g upgrade-assistant
   

   重要

   別の NuGet フィード ソースを構成している場合、このツールのインストールが失敗する可能性があります。 --ignore-failed-sources パラメーターを使用して、これらのエラーをエラーではなく警告として扱い、それらの他の NuGet フィード ソースをバイパスします。

   dotnet tool install -g --ignore-failed-sources upgrade-assistant
   

検証

次の情報は、.NET アップグレード アシスタントがインストールされていることを確認するのに役立ちます。

• Visual Studio

  .NET アップグレード アシスタントが有効になっているかどうかを確認するには、 ソリューション エクスプローラー ウィンドウで任意の .NET または .NET Framework プロジェクトを右クリックし、[ アップグレード ] メニュー項目を確認します。

• .NET グローバル ツール

  コマンド プロンプトを開き、 upgrade-assistant コマンドを実行します。 コマンド応答でコマンドが不明であることが示された場合、ツールが正しくインストールされなかったか、PATH にありません。

トラブルシューティング - .NET グローバル ツール

追加の NuGet フィード ソースを構成した場合、NuGet パッケージがフィードで使用できないことを示すエラーでインストールが失敗する可能性があります。 --ignore-failed-sources パラメーターを使用して、これらのエラーをエラーではなく警告として扱い、他の NuGet フィード ソースをバイパスします。

dotnet tool install -g --ignore-failed-sources upgrade-assistant