次の方法で共有

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

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

重要

.NET アップグレード アシスタントは正式に非推奨です。 代わりに GitHub Copilot アプリのモダン化チャット エージェント を使用します。これは、Visual Studio 2026 および Visual Studio 2022 17.14.16 以降に含まれています。 このエージェントは、プロジェクトと依存関係を分析し、ターゲットの推奨事項と自動コード修正を使用して段階的な移行計画を作成し、各変更をコミットして検証またはロールバックできるようにします。 プロジェクト ファイルの更新、非推奨の API の置き換え、ビルドの問題の解決など、一般的な移植タスクが自動化されるため、手動作業を減らすことで、より迅速に最新化できます。

前提条件

メソッド

.NET アップグレード アシスタントは、Visual Studio 拡張機能または .NET グローバル ツールとしてインストールできます。

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

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

Visual Studio 拡張機能

次の手順では、Visual Studio 拡張機能をインストールします。

ヒント

Visual Studio の 拡張機能の管理 機能を使用する代わりに、Visual Studio Marketplaceから拡張機能インストーラーをダウンロードして実行できます。

  1. Visual Studio を開きます。

    [最近使ったアイテムを開く] \ [作業の開始] ウィンドウが開いた場合は、[コードなしでContinueリンクを選択します。

  2. Extensions>Manage Extensions メニューを選択して、Extension Manager ウィンドウを開きます。

  3. [参照] タブを選択します。

  4. 検索ボックスに「 .NET アップグレード アシスタント 」と入力します。

  5. .NET アップグレード アシスタント項目を選択し、Install を選択します。

    .NET アップグレード アシスタントを表示している Visual Studio の [拡張機能の管理] ウィンドウ。

  6. 拡張機能のダウンロードが完了したら、Visual Studio を閉じて自動的にインストールを開始します。

    .NET アップグレード アシスタント拡張機能のインストールのプロンプト。

  7. Modifyを選択し、指示に従って拡張機能をインストールします。

.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 アップグレード アシスタントが Visual Studio 拡張機能としてインストールされているかどうかを確認するには、2 つの方法があります。 最も簡単な方法は、ソリューション エクスプローラー ウィンドウで任意の .NET または .NET Framework プロジェクトを右クリックし、アップグレード メニュー項目を確認することです。

    もう 1 つの方法は、 Extensions>Manage Extensions メニューを選択して Extension Manager ウィンドウを開く方法です。 次に、 [インストール ] タブを選択し、インストールされている拡張機能の一覧で見つけます。

  • .NET グローバル ツール

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

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

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

dotnet tool install -g --ignore-failed-sources upgrade-assistant
  • Last updated on