{"id":45940,"date":"2023-06-01T12:21:00","date_gmt":"2023-06-01T19:21:00","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/dotnet\/?p=45940"},"modified":"2024-12-13T14:12:44","modified_gmt":"2024-12-13T22:12:44","slug":"upgrade-assistant-cli","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/dotnet\/upgrade-assistant-cli\/","title":{"rendered":"Announcing an update for .NET Upgrade Assistant with a new CLI tool!"},"content":{"rendered":"<p>We are happy to announce that we&#8217;ve released a new version of the <a href=\"https:\/\/learn.microsoft.com\/dotnet\/core\/porting\/upgrade-assistant-overview#upgrade-with-the-cli-tool\">Upgrade Assistant CLI tool<\/a>! Now you can port your applications from either Visual Studio or your command line and benefit from all the latest features and improvements of .NET!<\/p>\n<p>The .NET Upgrade Assistant is a tool that helps you upgrade your application to the latest .NET and migrate from older platforms such as Xamarin Forms and UWP to newer offerings. The same functionality is available from both the Visual Studio and command line experiences.<\/p>\n<h2>CLI Experience<\/h2>\n<p>We have just updated the <a href=\"https:\/\/learn.microsoft.com\/dotnet\/core\/porting\/upgrade-assistant-install#install-the-net-global-tool\">.NET Upgrade Assistant CLI tool<\/a> with a new engine used in the Visual Studio extension of Upgrade Assistant. Now you can port any type of app and leverage the power of AI in your upgrading journey.<\/p>\n<p><div style=\"width: 640px;\" class=\"wp-video\"><video class=\"wp-video-shortcode\" id=\"video-45940-1\" width=\"640\" height=\"360\" preload=\"metadata\" controls=\"controls\"><source type=\"video\/mp4\" src=\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2023\/05\/upgrade-assistant-cli.mp4?_=1\" \/><a href=\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2023\/05\/upgrade-assistant-cli.mp4\">https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2023\/05\/upgrade-assistant-cli.mp4<\/a><\/video><\/div><\/p>\n<p>To install this global .NET tool, use the following command:<\/p>\n<pre><code class=\"language-console\">    dotnet tool install -g upgrade-assistant<\/code><\/pre>\n<p>To update this tool to the latest available version, call:<\/p>\n<pre><code class=\"language-console\">    dotnet tool update -g upgrade-assistant<\/code><\/pre>\n<p>Now as the tool is installed, you can use it to port your applications. Navigate to the directory that contains the project you want to upgrade and call the command:<\/p>\n<pre><code class=\"language-console\">    upgrade-assistant upgrade<\/code><\/pre>\n<p>The CLI tool provides an interactive way of choosing which project to upgrade and which version of .NET to target. Use the arrow keys to select an item and press <code>Enter<\/code> to run the item.<\/p>\n<p>For more details, refer to our documentation:<\/p>\n<ul>\n<li><a href=\"https:\/\/learn.microsoft.com\/dotnet\/core\/porting\/upgrade-assistant-install#install-the-net-global-tool\">Installing the CLI tool<\/a><\/li>\n<li><a href=\"https:\/\/learn.microsoft.com\/dotnet\/core\/porting\/upgrade-assistant-overview#upgrade-with-the-cli-tool\">Using the CLI tool<\/a><\/li>\n<\/ul>\n<h2>Visual Studio experience<\/h2>\n<p>If you have read my previous blogs, <a href=\"https:\/\/devblogs.microsoft.com\/dotnet\/upgrade-assistant-now-in-visual-studio\/\">Upgrading your .NET projects with Visual Studio<\/a> and <a href=\"https:\/\/devblogs.microsoft.com\/dotnet\/upgrade-assistant-general-availability\/\">Announcing a new version of the .NET Upgrade Assistant with support for .NET MAUI and Azure Functions!<\/a>, you might be familiar with the Visual Studio extension for this tool. Once you <a href=\"https:\/\/learn.microsoft.com\/dotnet\/core\/porting\/upgrade-assistant-install#install-the-visual-studio-extension\">install it<\/a>, you can upgrade your projects by right-clicking on the project in the <strong>Solution Explorer<\/strong> window, and selecting <strong>Upgrade<\/strong>.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2023\/05\/upgrade-assistant-vsix.png\" alt=\".NET Upgrade Assistant in Visual Studio\" \/><\/p>\n<p>For more details, refer to our documentation:<\/p>\n<ul>\n<li><a href=\"https:\/\/learn.microsoft.com\/dotnet\/core\/porting\/upgrade-assistant-install\">Installing the Visual Studio tool<\/a><\/li>\n<li><a href=\"https:\/\/learn.microsoft.com\/dotnet\/core\/porting\/upgrade-assistant-overview#upgrade-with-the-cli-tool\">Using the Visual Studio tool<\/a><\/li>\n<\/ul>\n<h2>Give us feedback<\/h2>\n<p>Please give us your feedback so we can build the right tools for you! Fill out this <a href=\"https:\/\/www.surveymonkey.com\/r\/CX67DS8\">brief survey<\/a>.<\/p>\n<p>You can also <a href=\"https:\/\/learn.microsoft.com\/visualstudio\/ide\/suggest-a-feature\">file issues or feature requests from Visual Studio<\/a> by choosing <strong>Help<\/strong> | <strong>Send Feedback<\/strong>. Make sure to mention &#8220;Upgrade Assistant vsix&#8221; in the title.<\/p>\n<h2>Related links<\/h2>\n<ul>\n<li><a href=\"https:\/\/dotnet.microsoft.com\/platform\/upgrade-assistant\">.NET Upgrade Assistant website<\/a><\/li>\n<li><a href=\"https:\/\/learn.microsoft.com\/dotnet\/core\/porting\/upgrade-assistant-overview\">Documentation<\/a><\/li>\n<li><a href=\"https:\/\/youtu.be\/3mPb4KAbz4Y\">Video on how to use Visual Studio extension<\/a><\/li>\n<li><a href=\"https:\/\/www.youtube.com\/playlist?list=PLdo4fOcmZ0oWiK8r9OkJM3MUUL7_bOT9z\">Video series on Upgrade Assistant and ASP.NET<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>The new version of .NET Upgrade Assistant CLI tool is available with all the new features for upgrading your apps!<\/p>\n","protected":false},"author":365,"featured_media":45952,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[685,195,197,7509,7163,509],"tags":[7174,3267,7672],"class_list":["post-45940","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dotnet","category-dotnet-framework","category-aspnet","category-aspnetcore","category-winforms","category-wpf","tag-cli","tag-migration","tag-upgrade-assistant"],"acf":[],"blog_post_summary":"<p>The new version of .NET Upgrade Assistant CLI tool is available with all the new features for upgrading your apps!<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/45940","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/users\/365"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/comments?post=45940"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/45940\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media\/45952"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media?parent=45940"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/categories?post=45940"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/tags?post=45940"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}