/Upgrade (devenv.exe)
Applies to: Visual Studio Visual Studio for Mac
Note
This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
Updates the solution file and all of its project files, or the project file specified, to the current Visual Studio formats for these files.
Syntax
devenv {SolutionFile|ProjectFile} /Upgrade [/Out OutputFilename]
Arguments
SolutionFile
Required if you're upgrading an entire solution and its projects. The path and name of a solution file. You can enter just the name of the solution file, or a full path and the name of the solution file. If the folder or file named doesn't yet exist, it's created.
ProjectFile
Required if you're upgrading a single project. The path and name of a project file within the solution. You can enter just the name of the project file, or a full path and the name of the project file. If the folder or file named doesn't yet exist, it's created.
/Out
OutputFilenameOptional. The name of a file that you want to send the tool's output to. If the file already exists, the tool appends the output to the end of the file.
Remarks
Backups are automatically created and copied to a directory named Backup that's created in the current directory.
Source-controlled solutions or projects must be checked out before they can be upgraded.
Using the /Upgrade
switch doesn't open Visual Studio. Results of the upgrade can be seen in the Upgrade Report for the development language of the solution or project. No error or usage info is returned. For more information on upgrading projects in Visual Studio, see Port, Migrate, and Upgrade Visual Studio Projects.
Example
This example upgrades a solution file named "MyProject.sln".
devenv "%USERPROFILE%\source\repos\MyProject\MyProject.sln" /upgrade