175 lines
6.6 KiB
Groff
175 lines
6.6 KiB
Groff
.\" Automatically generated by Pandoc 2.1.3
|
|
.\"
|
|
.TH "dotnet\-install scripts" "1" "" "" ".NET Core"
|
|
.hy
|
|
.SH dotnet\-install scripts reference
|
|
.SH NAME
|
|
.PP
|
|
\f[C]dotnet\-install.ps1\f[] | \f[C]dotnet\-install.sh\f[] \- Script used to install the .NET Core CLI tools and the shared runtime.
|
|
.SH SYNOPSIS
|
|
.PP
|
|
Windows:
|
|
.PP
|
|
\f[C]dotnet\-install.ps1\ [\-Channel]\ [\-Version]\ [\-InstallDir]\ [\-Architecture]\ [\-SharedRuntime]\ [\-DryRun]\ [\-NoPath]\ [\-AzureFeed]\ [\-ProxyAddress]\ [\-\-Verbose]\ [\-\-Help]\f[]
|
|
.PP
|
|
macOS/Linux:
|
|
.PP
|
|
\f[C]dotnet\-install.sh\ [\-\-channel]\ [\-\-version]\ [\-\-install\-dir]\ [\-\-architecture]\ [\-\-shared\-runtime]\ [\-\-dry\-run]\ [\-\-no\-path]\ [\-\-azure\-feed]\ [\-\-verbose]\ [\-\-help]\f[]
|
|
.SH DESCRIPTION
|
|
.PP
|
|
The \f[C]dotnet\-install\f[] scripts are used to perform a non\-admin installation of the .NET Core SDK, which includes the .NET Core CLI tools and the shared runtime.
|
|
.PP
|
|
We recommend that you use the stable version that is hosted on .NET Core main website.
|
|
The direct paths to the scripts are:
|
|
.IP \[bu] 2
|
|
https://dot.net/v1/dotnet\-install.sh (bash, UNIX)
|
|
.IP \[bu] 2
|
|
https://dot.net/v1/dotnet\-install.ps1 (Powershell, Windows)
|
|
.PP
|
|
The main usefulness of these scripts is in automation scenarios and non\-admin installations.
|
|
There are two scripts: One is a PowerShell script that works on Windows.
|
|
The other script is a bash script that works on Linux/macOS.
|
|
Both scripts have the same behavior.
|
|
The bash script also reads PowerShell switches, so you can use PowerShell switches with the script on Linux/macOS systems.
|
|
.PP
|
|
The installation scripts download the ZIP/tarball file from the CLI build drops and proceed to install it in either the default location or in a location specified by \f[C]\-InstallDir|\-\-install\-dir\f[].
|
|
By default, the installation scripts download the SDK and install it.
|
|
If you wish to only obtain the shared runtime, specify the \f[C]\-\-shared\-runtime\f[] argument.
|
|
.PP
|
|
By default, the script adds the install location to the $PATH for the current session.
|
|
Override this default behavior by specifying the \f[C]\-\-no\-path\f[] argument.
|
|
.PP
|
|
Before running the script, install the required dependencies.
|
|
.PP
|
|
You can install a specific version using the \f[C]\-\-version\f[] argument.
|
|
The version must be specified as a 3\-part version (for example, 1.0.0\-13232).
|
|
If omitted, it uses the \f[C]latest\f[] version.
|
|
.SH OPTIONS
|
|
.PP
|
|
\f[C]\-Channel\ <CHANNEL>\f[]
|
|
.PP
|
|
Specifies the source channel for the installation.
|
|
The possible values are:
|
|
.IP \[bu] 2
|
|
\f[C]Current\f[] \- Current release
|
|
.IP \[bu] 2
|
|
\f[C]LTS\f[] \- Long\-Term Support channel (current supported release)
|
|
.IP \[bu] 2
|
|
Two\-part version in X.Y format representing a specific release (for example, \f[C]2.0\f[] or \f[C]1.0\f[])
|
|
.IP \[bu] 2
|
|
Branch name [for example, \f[C]release/2.0.0\f[], \f[C]release/2.0.0\-preview2\f[], or \f[C]master\f[] for the latest from the \f[C]master\f[] branch (\[lq]bleeding edge\[rq] nightly releases)]
|
|
.PP
|
|
The default value is \f[C]LTS\f[].
|
|
For more information on .NET support channels, see the .NET Core Support Lifecycle topic.
|
|
.PP
|
|
\f[C]\-Version\ <VERSION>\f[]
|
|
.PP
|
|
Represents a specific build version.
|
|
The possible values are:
|
|
.IP \[bu] 2
|
|
\f[C]latest\f[] \- Latest build on the channel (used with the \f[C]\-Channel\f[] option)
|
|
.IP \[bu] 2
|
|
\f[C]coherent\f[] \- Latest coherent build on the channel; uses the latest stable package combination (used with Branch name \f[C]\-Channel\f[] options)
|
|
.IP \[bu] 2
|
|
Three\-part version in X.Y.Z format representing a specific build version; supersedes the \f[C]\-Channel\f[] option.
|
|
For example: \f[C]2.0.0\-preview2\-006120\f[]
|
|
.PP
|
|
If omitted, \f[C]\-Version\f[] defaults to \f[C]latest\f[].
|
|
.PP
|
|
\f[C]\-InstallDir\ <DIRECTORY>\f[]
|
|
.PP
|
|
Specifies the installation path.
|
|
The directory is created if it doesn't exist.
|
|
The default value is \f[I]%LocalAppData%.dotnet\f[].
|
|
Note that binaries are placed directly in the directory.
|
|
.PP
|
|
\f[C]\-Architecture\ <ARCHITECTURE>\f[]
|
|
.PP
|
|
Architecture of the .NET Core binaries to install.
|
|
Possible values are \f[C]auto\f[], \f[C]x64\f[], and \f[C]x86\f[].
|
|
The default value is \f[C]auto\f[], which represents the currently running OS architecture.
|
|
.PP
|
|
\f[C]\-SharedRuntime\f[]
|
|
.PP
|
|
If set, this switch limits installation to the shared runtime.
|
|
The entire SDK isn't installed.
|
|
.PP
|
|
\f[C]\-DryRun\f[]
|
|
.PP
|
|
If set, the script won't perform the installation; but instead, it displays what command line to use to consistently install the currently requested version of the .NET Core CLI.
|
|
For example if you specify version \f[C]latest\f[], it displays a link with the specific version so that this command can be used deterministically in a build script.
|
|
It also displays the binary's location if you prefer to install or download it yourself.
|
|
.PP
|
|
\f[C]\-NoPath\f[]
|
|
.PP
|
|
If set, the prefix/installdir are not exported to the path for the current session.
|
|
By default, the script will modify the PATH, which makes the CLI tools available immediately after install.
|
|
.PP
|
|
\f[C]\-AzureFeed\f[]
|
|
.PP
|
|
Specifies the URL for the Azure feed to the installer.
|
|
It isn't recommended that you change this value.
|
|
The default is \f[C]https://dotnetcli.azureedge.net/dotnet\f[].
|
|
.PP
|
|
\f[C]\-ProxyAddress\f[]
|
|
.PP
|
|
If set, the installer uses the proxy when making web requests.
|
|
(Only valid for Windows)
|
|
.PP
|
|
\f[C]\-\-verbose\f[]
|
|
.PP
|
|
Display diagnostics information.
|
|
.PP
|
|
\f[C]\-\-help\f[]
|
|
.PP
|
|
Prints out help for the script.
|
|
.SH EXAMPLES
|
|
.PP
|
|
Install the latest long\-term supported (LTS) version to the default location:
|
|
.PP
|
|
Windows:
|
|
.PP
|
|
\f[C]\&./dotnet\-install.ps1\ \-Channel\ LTS\f[]
|
|
.PP
|
|
macOS/Linux:
|
|
.PP
|
|
\f[C]\&./dotnet\-install.sh\ \-\-channel\ LTS\f[]
|
|
.PP
|
|
Install the latest version from 2.0 channel to the specified location:
|
|
.PP
|
|
Windows:
|
|
.PP
|
|
\f[C]\&./dotnet\-install.ps1\ \-Channel\ 2.0\ \-InstallDir\ C:\\cli\f[]
|
|
.PP
|
|
macOS/Linux:
|
|
.PP
|
|
\f[C]\&./dotnet\-install.sh\ \-\-channel\ 2.0\ \-\-install\-dir\ ~/cli\f[]
|
|
.PP
|
|
Install the 1.1.0 version of the shared runtime:
|
|
.PP
|
|
Windows:
|
|
.PP
|
|
\f[C]\&./dotnet\-install.ps1\ \-SharedRuntime\ \-Version\ 1.1.0\f[]
|
|
.PP
|
|
macOS/Linux:
|
|
.PP
|
|
\f[C]\&./dotnet\-install.sh\ \-\-shared\-runtime\ \-\-version\ 1.1.0\f[]
|
|
.PP
|
|
Obtain script and install .NET Core CLI one\-liner examples:
|
|
.PP
|
|
Windows:
|
|
.PP
|
|
\f[C]\@powershell\ \-NoProfile\ \-ExecutionPolicy\ unrestricted\ \-Command\ "&([scriptblock]::Create((Invoke\-WebRequest\ \-useb\ \[aq]https://dot.net/v1/dotnet\-install.ps1\[aq])))\ <additional\ install\-script\ args>"\f[]
|
|
.PP
|
|
macOS/Linux:
|
|
.PP
|
|
\f[C]curl\ \-sSL\ https://dot.net/v1/dotnet\-install.sh\ |\ bash\ /dev/stdin\ <additional\ install\-script\ args>\f[]
|
|
.SS See also
|
|
.PP
|
|
\&.NET Core releases
|
|
.PD 0
|
|
.P
|
|
.PD
|
|
\&.NET Core Runtime and SDK download archive
|
|
.SH AUTHORS
|
|
blackdwarf.
|