Dotnet-Installationsskripts Verweisdotnet-install scripts reference

NameName

dotnet-install.ps1 | dotnet-install.sh: Skript, mit dem die .NET Core-CLI-Tools und die freigegebene Laufzeit installiert werden.dotnet-install.ps1 | dotnet-install.sh - Script used to install the .NET Core CLI tools and the shared runtime.

ÜbersichtSynopsis

Windows:Windows:

dotnet-install.ps1 [-Channel] [-Version] [-InstallDir] [-Architecture] [-SharedRuntime] [-DryRun] [-NoPath] [-AzureFeed] [-ProxyAddress] [--Verbose] [--Help]

Mac OS/Linux:macOS/Linux:

dotnet-install.sh [--channel] [--version] [--install-dir] [--architecture] [--shared-runtime] [--dry-run] [--no-path] [--azure-feed] [--verbose] [--help]

BeschreibungDescription

Die dotnet-install-Skripts werden verwendet, um eine Nicht-Administrator-Installation des .NET Core-SDK durchzuführen, die die .NET Core-CLI-Tools und die freigegebene Laufzeit enthält.The dotnet-install 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.

Sie sollten die stabile Version verwenden, die auf der .NET Core-Hauptwebsite gehostet wird.We recommend that you use the stable version that is hosted on .NET Core main website. Die direkten Pfade zu den Skripts sind:The direct paths to the scripts are:

Diese Skripts sind vor allem in Szenarios für die Automatisierung und Nicht-Administrator-Installationen nützlich.The main usefulness of these scripts is in automation scenarios and non-admin installations. Es gibt zwei Skripts: Das eine ist ein PowerShell-Skript, das unter Windows funktioniert.There are two scripts: One is a PowerShell script that works on Windows. Das andere Skript ist ein Bash-Skript für Linux/macOS.The other script is a bash script that works on Linux/macOS. Beide Skripts weisen das gleiche Verhalten auf.Both scripts have the same behavior. Das Bash-Skript liest auch PowerShell-Schalter, sodass Sie PowerShell-Schalter mit dem Skript auf Linux/macOS-Systemen verwenden können.The bash script also reads PowerShell switches, so you can use PowerShell switches with the script on Linux/macOS systems.

Die Installationsskripts laden die ZIP/Tarball-Datei vom CLI-Build-Ablagespeicherort herunter und installieren sie entweder am Standardspeicherort oder an einem in -InstallDir|--install-dir angegebenen Speicherort.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 -InstallDir|--install-dir. In der Standardeinstellung laden die Installationsskripts das SDK herunter und installieren es.By default, the installation scripts download the SDK and install it. Wenn Sie nur die freigegebene Laufzeit abrufen möchten, geben Sie das --shared-runtime-Argument an.If you wish to only obtain the shared runtime, specify the --shared-runtime argument.

In der Standardeinstellung fügt das Skript den Installationsort dem $PATH für die aktuelle Sitzung hinzu.By default, the script adds the install location to the $PATH for the current session. Überschreiben Sie dieses Standardverhalten, indem sie das --no-path-Argument angeben.Override this default behavior by specifying the --no-path argument.

Bevor Sie das Skript ausführen, installieren Sie die erforderlichen Abhängigkeiten.Before running the script, install the required dependencies.

Installieren Sie eine bestimmte Version mithilfe des Arguments --version.You can install a specific version using the --version argument. Die Version muss als dreiteilige Version (z.B. 1.0.0-13232) angegeben werden.The version must be specified as a 3-part version (for example, 1.0.0-13232). Wenn nicht angegeben, wird die latest-Version verwendet.If omitted, it uses the latest version.

OptionenOptions

-Channel <CHANNEL>

Gibt den Quellkanal für die Installation an.Specifies the source channel for the installation. Mögliche Werte sind:The possible values are:

  • Current: Aktuelle VersionCurrent - Current release
  • LTS: Long Term Support-Kanal (aktuell unterstützte Versionen)LTS - Long-Term Support channel (current supported release)
  • Zweiteilige Version im X.Y-Format, das eine bestimmte Version darstellt (z.B. 2.0 oder 1.0)Two-part version in X.Y format representing a specific release (for example, 2.0 or 1.0)
  • Branchname [z.B. release/2.0.0, release/2.0.0-preview2, oder master für die neueste aus dem Branch master („topaktuelle“ nächtliche Versionen)]Branch name [for example, release/2.0.0, release/2.0.0-preview2, or master for the latest from the master branch ("bleeding edge" nightly releases)]

Der Standardwert ist LTS.The default value is LTS. Weitere Informationen zu .NET-Supportkanälen finden Sie unter dem Thema .NET Core Support Lifecycle.For more information on .NET support channels, see the .NET Core Support Lifecycle topic.

-Version <VERSION>

Stellt eine bestimmte Buildversion dar.Represents a specific build version. Mögliche Werte sind:The possible values are:

  • latest – der neueste Build auf dem Kanal (mit der -Channel-Option verwendet)latest - Latest build on the channel (used with the -Channel option)
  • coherent – neuester kohärenter Build auf dem Kanal; verwendet die neueste stabile Paketkombination (mit Branch-Name--Channel-Optionen verwendet)coherent - Latest coherent build on the channel; uses the latest stable package combination (used with Branch name -Channel options)
  • Dreiteilige Version im X.Y.Z-Format, die eine bestimmte Buildversion darstellt; sie hat Vorrang vor der -Channel-Option.Three-part version in X.Y.Z format representing a specific build version; supersedes the -Channel option. Beispiel: 2.0.0-preview2-006120For example: 2.0.0-preview2-006120

Wenn kein Wert angegeben ist, hat -Version den Standardwert latest.If omitted, -Version defaults to latest.

-InstallDir <DIRECTORY>

Gibt den Installationspfad an.Specifies the installation path. Das Verzeichnis wird erstellt, wenn es nicht vorhanden ist.The directory is created if it doesn't exist. Der Standardwert ist %LocalAppData%.dotnet.The default value is %LocalAppData%.dotnet. Beachten Sie, dass Binärdateien direkt im Verzeichnis platziert werden.Note that binaries are placed directly in the directory.

-Architecture <ARCHITECTURE>

Architektur der zu installierenden .NET Core-Binärdateien.Architecture of the .NET Core binaries to install. Mögliche Werte sind auto, x64 und x86.Possible values are auto, x64, and x86. Der Standardwert ist auto, was die derzeit ausgeführte Betriebssystemarchitektur darstellt.The default value is auto, which represents the currently running OS architecture.

-SharedRuntime

Wenn festgelegt, beschränkt dieser Schalter die Installation auf die freigegebene Laufzeit.If set, this switch limits installation to the shared runtime. Das gesamte SDK ist nicht installiert.The entire SDK isn't installed.

-DryRun

Wenn festgelegt, führt das Skript die Installation nicht aus. Es zeigt stattdessen an, welche Befehlszeile verwendet werden soll, um die derzeit erforderliche Version der .NET Core-CLI konsistent zu installieren.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. Wenn Sie z.B. Version latest angeben, wird eine Verbindung mit der bestimmten Version angezeigt, damit dieser Befehl deterministisch in einem Buildskript verwendet werden kann.For example if you specify version latest, it displays a link with the specific version so that this command can be used deterministically in a build script. Außerdem wird der Speicherort der Binärdatei angezeigt, wenn Sie sie selbst installieren oder herunterladen möchten.It also displays the binary's location if you prefer to install or download it yourself.

-NoPath

Falls festgelegt, wird das Präfix/Installdir für die aktuelle Sitzung nicht in den Pfad exportiert werden.If set, the prefix/installdir are not exported to the path for the current session. Standardmäßig wird das Skript den PFAD ändern. Somit werden die CLI-Tools sofort nach der Installation zur Verfügung gestellt.By default, the script will modify the PATH, which makes the CLI tools available immediately after install.

-AzureFeed

Gibt die URL für den Azure-Feed für den Installer an.Specifies the URL for the Azure feed to the installer. Es wird nicht empfohlen, diesen Wert zu ändern.It isn't recommended that you change this value. Die Standardeinstellung ist https://dotnetcli.azureedge.net/dotnet.The default is https://dotnetcli.azureedge.net/dotnet.

-ProxyAddress

Wenn festgelegt, verwendet das Installationsprogramm den Proxy bei der Durchführung von Webanfragen.If set, the installer uses the proxy when making web requests. (Nur gültig für Windows)(Only valid for Windows)

--verbose

Diagnoseinformationen anzeigen.Display diagnostics information.

--help

Druckt Hilfe für das Skript aus.Prints out help for the script.

BeispieleExamples

Installieren Sie die neueste langfristig unterstützte (Long-Term Supported, LTS) Version am Standardspeicherort:Install the latest long-term supported (LTS) version to the default location:

Windows:Windows:

./dotnet-install.ps1 -Channel LTS

Mac OS/Linux:macOS/Linux:

./dotnet-install.sh --channel LTS

Installieren Sie die aktuelle Version von Kanal 2.0 am angegebenen Speicherort:Install the latest version from 2.0 channel to the specified location:

Windows:Windows:

./dotnet-install.ps1 -Channel 2.0 -InstallDir C:\cli

Mac OS/Linux:macOS/Linux:

./dotnet-install.sh --channel 2.0 --install-dir ~/cli

Installieren Sie die Version 1.1.0 der freigegebenen Laufzeit:Install the 1.1.0 version of the shared runtime:

Windows:Windows:

./dotnet-install.ps1 -SharedRuntime -Version 1.1.0

Mac OS/Linux:macOS/Linux:

./dotnet-install.sh --shared-runtime --version 1.1.0

Rufen Sie das Skript ab, und installieren Sie die Beispiele für die .NET Core-CLI:Obtain script and install .NET Core CLI one-liner examples:

Windows:Windows:

@powershell -NoProfile -ExecutionPolicy unrestricted -Command "&([scriptblock]::Create((Invoke-WebRequest -useb 'https://dot.net/v1/dotnet-install.ps1'))) <additional install-script args>"

Mac OS/Linux:macOS/Linux:

curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin <additional install-script args>

Siehe auchSee also

.NET Core-Versionen .NET Core releases
Downloadarchiv von .NET Core Runtime und des SDK.NET Core Runtime and SDK download archive