Document dotnet sln migrate

[tdykstra]

Description

Document CLI command dotnet sln migrate.

Page URL

https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-sln

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/tools/dotnet-sln.md

Document Version Independent Id

60d50636-8086-8d92-9ccc-60b7cecd714a

Article author

@tdykstra

Metadata

• ID: b5b0701a-2043-4ac8-567a-03c1e35161b2
• PlatformId: 6b2a77a5-71c8-eacc-f857-b8530675b01f
• Service: dotnet-fundamentals

Related Issues

---

Associated WorkItem - 372806

[baronfel]

Here's some data for the migrate command:

>dotnet sln migrate --help
Description:
  Generate a .slnx file from a .sln file.

Usage:
  dotnet solution [<SLN_FILE>] migrate

Arguments:
  <SLN_FILE>  The solution file to operate on. If not specified, the command will search the current directory for one. [default: E:\Code\Scratch\foobar\]

Options:
  -?, -h, --help  Show command line help.

When the migration happens, the current directory will be searched for a *.sln file and convert it to a *.slnx file. If a matching slnx exists you'll get an error. If you pass in a slnx file directly, that will also give an error.

After the migration, you can build/etc the newly-created slnx file and can delete the older sln file at will.

Note that today, you can't double-click an slnx and open it in VS.