.NET Upgrade Assistant - Get Started
Intro
Purpose
Install and run the .NET Upgrade Assistant.
Prerequisites
None.
Time to Complete
10 minutes
Scenario
Install and run the .NET Upgrade Assistant global tool on your machine.
Install and run the .NET Upgrade Assistant.
None.
10 minutes
Install and run the .NET Upgrade Assistant global tool on your machine.
To start building .NET apps, download and install the .NET SDK.
Once you've installed, open a new command prompt and run the following command:
Once you've installed, open a new terminal and run the following command:
dotnet --version
If the installation succeeded, you should see version 9.0.100 or higher outputted:
9.0.100
If everything looks good, select the Continue button below to go to the next step.
If you receive a 'dotnet' is not recognized as an internal or external command error, make sure you opened a new command prompt. If quickly restarting your machine doesn't resolve the issue, use the I ran into an issue button to get help fixing the problem.
In your command prompt, run the following command to install the upgrade-assistant tool:
In your terminal, run the following commands to install the upgrade-assistant tool:
dotnet tool install -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
Now you're ready to run the tool. To upgrade your project, run the following command:
upgrade-assistant upgrade <Path to csproj to upgrade>
The tool also supports additional options. For full tool usage information, see the upgrade-assistant readme on GitHub.
Congratulations, you've installed and ran the .NET Upgrade Assistant!
Get detailed guides on how to upgrade your .NET Framework-based projects:
.NET Upgrade Assistant overview
Learn how to upgrade your applications to the latest .NET with existing tooling from Microsoft: