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] [-Runtime] [-DryRun] [-NoPath] [-Verbose] [-AzureFeed] [-UncachedFeed] [-NoCdn] [-FeedCredential] [-ProxyAddress] [-ProxyUseDefaultCredentials] [-SkipNonVersionedFiles] [-Help]

Mac OS/Linux:macOS/Linux:

dotnet-install.sh [--channel] [--version] [--install-dir] [--architecture] [--runtime] [--dry-run] [--no-path] [--verbose] [--azure-feed] [--uncached-feed] [--no-cdn] [--feed-credential] [--runtime-id] [--skip-non-versioned-files] [--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: eines für PowerShell unter Windows und ein Bash-Skript für Linux/macOS.There are two scripts: one is a PowerShell script that works on Windows, and the other 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 --runtime-Argument an.If you wish to only obtain the shared runtime, specify the --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 three-part version (for example, 1.0.0-13232). Wenn nicht angegeben, wird die latest-Version verwendet.If not provided, 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 – Aktuelles Release.Current - Most current release.
    • LTS: Long Term Support-Kanal (aktuell unterstütztes Release).LTS - Long-Term Support channel (most 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.Branch name. Zum Beispiel release/2.0.0, release/2.0.0-preview2 or master (für nächtliche Releases).For example, release/2.0.0, release/2.0.0-preview2, or master (for nightly releases).

    Der Standardwert ist LTSsein.The default value is LTS. Weitere Informationen zu .NET-Supportkanälen finden Sie auf der Seite .NET-Supportrichtlinie.For more information on .NET support channels, see the .NET Support Policy page.

  • -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 Branchname--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-006120.For example: 2.0.0-preview2-006120.

    Wenn nichts angegeben ist, wird für -Version standardmäßig latest verwendet.If not specified, -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%\Microsoft\dotnet.The default value is %LocalAppData%\Microsoft\dotnet. Binärdateien werden direkt im Verzeichnis platziert.Binaries are placed directly in this directory.

  • -Architecture <ARCHITECTURE>

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

  • -SharedRuntime

    Hinweis

    Dieser Parameter ist veraltet und wird in einer zukünftigen Version des Skripts möglicherweise entfernt.This parameter is obsolete and may be removed in a future version of the script. Die empfohlene Alternative ist die Runtime-Option.The recommended alternative is the Runtime option.

    Es werden nur die freigegebenen Runtimebestandteile installiert und nicht das gesamte SDK.Installs just the shared runtime bits, not the entire SDK. Dies entspricht dem Angeben von -Runtime dotnet.This is equivalent to specifying -Runtime dotnet.

  • -Runtime <RUNTIME>

    Es wird nur die freigegebene Runtime installiert und nicht das gesamte SDK.Installs just the shared runtime, not the entire SDK. Mögliche Werte sind:The possible values are:

    • dotnet – die freigegebene Runtime von Microsoft.NETCore.App.dotnet - the Microsoft.NETCore.App shared runtime.
    • aspnetcore – die freigegebene Runtime von Microsoft.AspNetCore.App.aspnetcore - the Microsoft.AspNetCore.App shared runtime.
  • -DryRun

    Wenn festgelegt, führt das Skript die Installation nicht aus.If set, the script won't perform the installation. Es zeigt stattdessen an, welche Befehlszeile verwendet werden soll, um die derzeit erforderliche Version der .NET Core-CLI konsistent zu installieren.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

    Wenn festgelegt, wird der Installationsordner nicht in den Pfad für die aktuelle Sitzung exportiert.If set, the installation folder isn't 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 modifies the PATH, which makes the CLI tools available immediately after install.

  • -Verbose

    Es werden Diagnoseinformationen angezeigt.Displays diagnostics information.

  • -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 nicht zu ändern.We recommended that you don't change this value. Der Standardwert ist https://dotnetcli.azureedge.net/dotnetsein.The default value is https://dotnetcli.azureedge.net/dotnet.

  • -UncachedFeed

    Ermöglicht das Ändern der URL für den nicht zwischengespeicherten Feed, der von diesem Installer verwendet wird.Allows changing the URL for the uncached feed used by this installer. Es wird nicht empfohlen, diesen Wert nicht zu ändern.We recommended that you don't change this value.

  • -NoCdn

    Deaktiviert das Herunterladen aus dem Azure Content Delivery Network (CDN) und verwendet den nicht zwischengespeicherten Feed direkt.Disables downloading from the Azure Content Delivery Network (CDN) and uses the uncached feed directly.

  • -FeedCredential

    Wird als Abfragezeichenfolge zum Anfügen an den Azure-Feed verwendet.Used as a query string to append to the Azure feed. Ermöglicht das Ändern der URL, um nicht öffentliche Blob Storage-Konten verwenden zu können.It allows changing the URL to use non-public blob storage accounts.

  • -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)

  • ProxyUseDefaultCredentials

    Wenn festgelegt, verwendet der Installer bei Verwendung der Proxyadresse die Anmeldeinformationen des aktuellen Benutzers.If set, the installer uses the credentials of the current user when using proxy address. (Nur gültig für Windows)(Only valid for Windows)

  • -SkipNonVersionedFiles

    Die Installation nicht versionierte Dateien, wie dotnet.exe, wird übersprungen, falls diese bereits vorhanden sind.Skips installing non-versioned files, such as dotnet.exe, if they already exist.

  • -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 -Runtime dotnet -Version 1.1.0
    

    Mac OS/Linux:macOS/Linux:

    ./dotnet-install.sh --runtime dotnet --version 1.1.0
    
  • Rufen Sie das Skript ab und installieren Sie die Version 2.1.2 hinter einem Unternehmensproxy (nur Windows):Obtain script and install the 2.1.2 version behind a corporate proxy (Windows only):

    Invoke-WebRequest 'https://dot.net/v1/dotnet-install.ps1' -Proxy $env:HTTP_PROXY -ProxyUseDefaultCredentials -OutFile 'dotnet-install.ps1';
    ./dotnet-install.ps1 -InstallDir '~/.dotnet' -Version '2.1.2' -ProxyAddress $env:HTTP_PROXY -ProxyUseDefaultCredentials;
    
  • 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 "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; &([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