Overview of the .NET Upgrade Assistant

You might have apps that currently run on the .NET Framework that you're interested in porting to .NET 6. The .NET Upgrade Assistant tool can assist with this process. This article provides:

  • An overview of the .NET Upgrade Assistant.
  • How to install the .NET Upgrade Assistant.

What is the .NET Upgrade Assistant

The .NET Upgrade Assistant is a command-line tool that can be run on different kinds of .NET Framework apps. It's designed to assist with upgrading .NET Framework apps to .NET 6. After running the tool, in most cases the app will require additional effort to complete the migration. The tool includes the installation of analyzers that can assist with completing the migration.

Currently the tool supports the following .NET Framework app types:

  • .NET Framework Windows Forms apps
  • .NET Framework WPF apps
  • .NET Framework server-side WCF apps
  • .NET Native UWP apps
  • .NET Framework ASP.NET MVC apps
  • .NET Framework console apps
  • .NET Framework class libraries

The tool also supports projects that use these code languages:

  • C#
  • Visual Basic.NET

The .NET Upgrade Assistant is currently prerelease and is receiving frequent updates. If you discover problems using the tool, report them in the tool's GitHub repository.

Install the .NET Upgrade Assistant

This section describes how to install the .NET Upgrade Assistant. You can also follow a step-by-step guided tutorial.


Installation steps

The .NET Upgrade Assistant is a .NET tool that is installed globally with the following command:

dotnet tool install -g upgrade-assistant

Similarly, because the .NET Upgrade Assistant is installed as a .NET tool, it can be easily updated by running:

dotnet tool update -g upgrade-assistant


Installing this tool may fail if you've configured additional NuGet feed sources. Use the --ignore-failed-sources parameter to treat those failures as warnings instead of errors:

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

See also