dotnet-installer/Documentation/manpages/sdk/dotnet-migrate.1

.\" Automatically generated by Pandoc 2.2.1
.\"
.TH "dotnet migrate command \- .NET Core CLI" "1" "" "" ".NET Core"
.hy
.SH dotnet migrate
.PP
.SH NAME
.PP
\f[C]dotnet\ migrate\f[] \- Migrates a Preview 2 .NET Core project to a .NET Core SDK 1.0 project.
.SH SYNOPSIS
.IP
.nf
\f[C]
dotnet\ migrate\ [<SOLUTION_FILE|PROJECT_DIR>]\ [\-\-format\-report\-file\-json]\ [\-r|\-\-report\-file]\ [\-s|\-\-skip\-project\-references]\ [\-\-skip\-backup]\ [\-t|\-\-template\-file]\ [\-v|\-\-sdk\-package\-version]\ [\-x|\-\-xproj\-file]
dotnet\ migrate\ [\-h|\-\-help]
\f[]
.fi
.SH DESCRIPTION
.PP
The \f[C]dotnet\ migrate\f[] command migrates a valid Preview 2 \f[I]project.json\f[]\-based project to a valid .NET Core SDK 1.0 \f[I]csproj\f[] project.
.PP
By default, the command migrates the root project and any project references that the root project contains.
This behavior is disabled using the \f[C]\-\-skip\-project\-references\f[] option at runtime.
.PP
Migration can be performed on the following assets:
.IP \[bu] 2
A single project by specifying the \f[I]project.json\f[] file to migrate.
.IP \[bu] 2
All of the directories specified in the \f[I]global.json\f[] file by passing in a path to the \f[I]global.json\f[] file.
.IP \[bu] 2
A \f[I]solution.sln\f[] file, where it migrates the projects referenced in the solution.
.IP \[bu] 2
On all subdirectories of the given directory recursively.
.PP
The \f[C]dotnet\ migrate\f[] command keeps the migrated \f[I]project.json\f[] file inside a \f[C]backup\f[] directory, which it creates if the directory doesn't exist.
This behavior is overridden using the \f[C]\-\-skip\-backup\f[] option.
.PP
By default, the migration operation outputs the state of the migration process to standard output (STDOUT).
If you use the \f[C]\-\-report\-file\ <REPORT_FILE>\f[] option, the output is saved to the file specify.
.PP
The \f[C]dotnet\ migrate\f[] command only supports valid Preview 2 \f[I]project.json\f[]\-based projects.
This means that you cannot use it to migrate DNX or Preview 1 \f[I]project.json\f[]\-based projects directly to MSBuild/csproj projects.
You first need to manually migrate the project to a Preview 2 \f[I]project.json\f[]\-based project and then use the \f[C]dotnet\ migrate\f[] command to migrate the project.
.SS Arguments
.PP
\f[C]PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR\f[]
.PP
The path to one of the following:
.IP \[bu] 2
a \f[I]project.json\f[] file to migrate.
.IP \[bu] 2
a \f[I]global.json\f[] file: the folders specified in \f[I]global.json\f[] are migrated.
.IP \[bu] 2
a \f[I]solution.sln\f[] file: the projects referenced in the solution are migrated.
.IP \[bu] 2
a directory to migrate: recursively searches for \f[I]project.json\f[] files to migrate inside the specified directory.
.PP
Defaults to current directory if nothing is specified.
.SH OPTIONS
.PP
\f[C]\-\-format\-report\-file\-json\ <REPORT_FILE>\f[]
.PP
Output migration report file as JSON rather than user messages.
.PP
\f[C]\-h|\-\-help\f[]
.PP
Prints out a short help for the command.
.PP
\f[C]\-r|\-\-report\-file\ <REPORT_FILE>\f[]
.PP
Output migration report to a file in addition to the console.
.PP
\f[C]\-s|\-\-skip\-project\-references\ [Debug|Release]\f[]
.PP
Skip migrating project references.
By default, project references are migrated recursively.
.PP
\f[C]\-\-skip\-backup\f[]
.PP
Skip moving \f[I]project.json\f[], \f[I]global.json\f[], and \f[I]*.xproj\f[] to a \f[C]backup\f[] directory after successful migration.
.PP
\f[C]\-t|\-\-template\-file\ <TEMPLATE_FILE>\f[]
.PP
Template csproj file to use for migration.
By default, the same template as the one dropped by \f[C]dotnet\ new\ console\f[] is used.
.PP
\f[C]\-v|\-\-sdk\-package\-version\ <VERSION>\f[]
.PP
The version of the sdk package that's referenced in the migrated app.
The default is the version of the SDK in \f[C]dotnet\ new\f[].
.PP
\f[C]\-x|\-\-xproj\-file\ <FILE>\f[]
.PP
The path to the xproj file to use.
Required when there is more than one xproj in a project directory.
.SH EXAMPLES
.PP
Migrate a project in the current directory and all of its project\-to\-project dependencies:
.PP
\f[C]dotnet\ migrate\f[]
.PP
Migrate all projects that \f[I]global.json\f[] file includes:
.PP
\f[C]dotnet\ migrate\ path/to/global.json\f[]
.PP
Migrate only the current project and no project\-to\-project (P2P) dependencies.
Also, use a specific SDK version:
.PP
\f[C]dotnet\ migrate\ \-s\ \-v\ 1.0.0\-preview4\f[]
.SH AUTHORS
mairaw.