Dotnet-Installationsskripts Verweis

name

dotnet-install.ps1 | dotnet-install.sh: Skript für die Installation des .NET SDK und der Shared Runtime

Übersicht

Windows:

dotnet-install.ps1 [-Architecture <ARCHITECTURE>] [-AzureFeed]
    [-Channel <CHANNEL>] [-DryRun] [-FeedCredential]
    [-InstallDir <DIRECTORY>] [-JSonFile <JSONFILE>]
    [-NoCdn] [-NoPath] [-ProxyAddress] [-ProxyBypassList <LIST_OF_URLS>]
    [-ProxyUseDefaultCredentials] [-Quality <QUALITY>] [-Runtime <RUNTIME>]
    [-SkipNonVersionedFiles] [-UncachedFeed] [-Verbose]
    [-Version <VERSION>]

Get-Help ./dotnet-install.ps1

Linux/macOS:

dotnet-install.sh  [--architecture <ARCHITECTURE>] [--azure-feed]
    [--channel <CHANNEL>] [--dry-run] [--feed-credential]
    [--install-dir <DIRECTORY>] [--jsonfile <JSONFILE>]
    [--no-cdn] [--no-path] [--quality <QUALITY>]
    [--runtime <RUNTIME>] [--runtime-id <RID>]
    [--skip-non-versioned-files] [--uncached-feed] [--verbose]
    [--version <VERSION>]

dotnet-install.sh --help

Das Bash-Skript liest auch PowerShell-Schalter, sodass Sie PowerShell-Schalter mit dem Skript auf Linux/macOS-Systemen verwenden können.

Beschreibung

Die dotnet-install-Skripts führen eine Nicht-Administrator-Installation des .NET SDK durch, das die .NET-CLI und die Shared Runtime enthält. Es gibt zwei Skripts:

  • Ein PowerShell-Skript, das unter Windows verwendet werden kann
  • Ein Bash-Skript für Linux/macOS

Hinweis

.NET sammelt Telemetriedaten. Weitere Informationen über die Sammlung von Telemetriedaten sowie darüber, wie diese deaktiviert wird, finden Sie unter .NET-SDK-Telemetrie.

Zweck

Diese Skripts sind für die Verwendung in Continuous Integration-Szenarios (CI) konzipiert, in denen Folgendes zutrifft:

  • Das SDK muss ohne Benutzerinteraktion und ohne Administratorrechte installiert werden.

  • Die SDK-Installation muss nicht für mehrere CI-Ausführungen beibehalten werden.

    Die typische Sequenz für Ereignisse lautet folgendermaßen:

    • Die CI wird ausgelöst.
    • Die CI installiert das SDK mithilfe eines dieser Skripts.
    • Die CI schließt ihre Aufgaben ab und bereinigt temporäre Daten einschließlich der SDK-Installation.

Verwenden Sie die Installationsprogramme anstatt dieser Skripts, um eine Entwicklungsumgebung einzurichten oder um Apps auszuführen.

Es wird empfohlen, die stabile Version der Skripts zu verwenden:

Skriptverhalten

Beide Skripts weisen das gleiche Verhalten auf. Sie 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.

In der Standardeinstellung laden die Installationsskripts das SDK herunter und installieren es. Wenn Sie nur die freigegebene Laufzeit abrufen möchten, geben Sie das -Runtime|--runtime-Argument an.

In der Standardeinstellung fügt das Skript den Installationsort dem $PATH für die aktuelle Sitzung hinzu. Überschreiben Sie dieses Standardverhalten, indem sie das -NoPath|--no-path-Argument angeben. Das Skript legt die Umgebungsvariable DOTNET_ROOT nicht fest.

Bevor Sie das Skript ausführen, installieren Sie die erforderlichen Abhängigkeiten.

Installieren Sie eine bestimmte Version mithilfe des Arguments -Version|--version. Die Version muss als dreiteilige Versionsnummer (z. B. 2.1.0) angegeben werden. Wenn die Version nicht angegeben wird, installiert das Skript die latest-Version.

Die Installationsskripts aktualisieren die Registrierung unter Windows nicht. Sie laden nur die gezippten Binärdateien herunter und kopieren sie in einen Ordner. Wenn Sie möchten, dass die Registrierungsschlüsselwerte aktualisiert werden, verwenden Sie die .NET-Installer.

Optionen

  • -Architecture|--architecture <ARCHITECTURE>

    Architektur der zu installierenden .NET-Binärdateien. Mögliche Werte sind <auto>, amd64, x64, x86, arm64 und arm. Der Standardwert ist <auto>, was die derzeit ausgeführte Betriebssystemarchitektur darstellt.

  • -AzureFeed|--azure-feed

    Gibt die URL für den Azure-Feed für den Installer an. Es wird nicht empfohlen, diesen Wert nicht zu ändern. Der Standardwert ist https://dotnetcli.azureedge.net/dotnet.

  • -Channel|--channel <CHANNEL>

    Gibt den Quellkanal für die Installation an. Mögliche Werte sind:

    • Current – Aktuelles Release.
    • LTS: Long Term Support-Kanal (aktuell unterstütztes Release).
    • Zweiteilige Version im A.B-Format, das eine bestimmte Version darstellt (z. B. 2.1 oder 3.0).
    • Dreiteilige Version im A.B.Cxx-Format, das ein bestimmtes SDK-Release (z. B. 5.0.1xx oder 5.0.2xx). Verfügbar seit Release 5.0.

    Der version-Parameter überschreibt den channel-Parameter, wenn eine andere Version als latest verwendet wird.

    Der Standardwert ist LTS. Weitere Informationen zu .NET-Supportkanälen finden Sie auf der Seite .NET-Supportrichtlinie.

  • -DryRun|--dry-run

    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-CLI konsistent zu installieren. 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. Außerdem wird der Speicherort der Binärdatei angezeigt, wenn Sie sie selbst installieren oder herunterladen möchten.

  • -FeedCredential|--feed-credential

    Wird als Abfragezeichenfolge zum Anfügen an den Azure-Feed verwendet. Ermöglicht das Ändern der URL, um nicht öffentliche Blob Storage-Konten verwenden zu können.

  • --help

    Druckt Hilfe für das Skript aus. Gilt nur für das Bash-Skript. Verwenden Sie Get-Help ./dotnet-install.ps1 für PowerShell.

  • -InstallDir|--install-dir <DIRECTORY>

    Gibt den Installationspfad an. Das Verzeichnis wird erstellt, wenn es nicht vorhanden ist. Der Standardwert lautet %LocalAppData%\Microsoft\dotnet unter Windows und $HOME/.dotnet unter Linux/macOS. Binärdateien werden direkt im Verzeichnis platziert.

  • -JSonFile|--jsonfile <JSONFILE>

    Gibt einen Pfad zu einer global.json-Datei an, die zur Bestimmung der SDK-Version verwendet wird. Die Datei global.json muss einen Wert für sdk:version haben.

  • -NoCdn|--no-cdn

    Deaktiviert das Herunterladen aus dem Azure Content Delivery Network (CDN) und verwendet den nicht zwischengespeicherten Feed direkt.

  • -NoPath|--no-path

    Wenn festgelegt, wird der Installationsordner nicht in den Pfad für die aktuelle Sitzung exportiert. Standardmäßig ändert das Skript den Pfad (PATH), wodurch die .NET-CLI sofort nach der Installation zur Verfügung steht.

  • -ProxyAddress

    Wenn festgelegt, verwendet das Installationsprogramm den Proxy bei der Durchführung von Webanfragen. (Nur gültig für Windows)

  • -ProxyBypassList <LIST_OF_URLS>

    Wenn diese Einstellung mit ProxyAddressfestgelegt ist, wird eine Liste mit durch Trennzeichen getrennten URLs bereitstellt, die den Proxy umgehen. (Nur gültig für Windows)

  • ProxyUseDefaultCredentials

    Wenn festgelegt, verwendet der Installer bei Verwendung der Proxyadresse die Anmeldeinformationen des aktuellen Benutzers. (Nur gültig für Windows)

  • -Quality|--quality <QUALITY>

    Lädt den neuesten Build der angegebenen Qualität im Kanal herunter. Mögliche Werte sind: daily, signed, validated, preview, GA. Funktioniert nur in Kombination mit channel. Gilt nicht für aktuelle und LTS-Kanäle und wird ignoriert, wenn einer dieser Kanäle verwendet wird.

    Verwenden Sie für eine SDK-Installation channel im A.B- oder A.B.Cxx-Format. Verwenden Sie für eine Laufzeitinstallation channel im A.B-Format.

    Der version-Parameter überschreibt die channel- und quality-Parameter, wenn eine andere version als latest verwendet wird.

    Verfügbar seit Release 5.0.

  • -Runtime|--runtime <RUNTIME>

    Es wird nur die freigegebene Runtime installiert und nicht das gesamte SDK. Mögliche Werte sind:

    • dotnet – die freigegebene Runtime von Microsoft.NETCore.App.
    • aspnetcore – die freigegebene Runtime von Microsoft.AspNetCore.App.
    • windowsdesktop – die freigegebene Runtime von Microsoft.WindowsDesktop.App.
  • --runtime-id <RID> [Veraltet]

    Gibt den Runtimebezeichner an, für den die Tools installiert werden. Verwenden Sie linux-x64 für portable Linux-Distributionen. (Nur für Linux/macOS und Versionen von .NET Core 2.1 gültig.)

    --os <OPERATING_SYSTEM>

    Hiermit wird das Betriebssystem angegeben, für das die Tools installiert werden. Die folgenden Werte sind möglich: osx, linux, linux-musl, freebsd und rhel.6. (Nur .NET Core 2.1 und höher gültig.)

    Der Parameter ist optional und sollte nur verwendet werden, wenn er für die Außerkraftsetzung des Betriebssystems erforderlich ist, das vom Skript erkannt wurde.

  • -SharedRuntime|--shared-runtime

    Hinweis

    Dieser Parameter ist veraltet und wird in einer zukünftigen Version des Skripts möglicherweise entfernt. Die empfohlene Alternative ist die -Runtime|--runtime-Option.

    Es werden nur die freigegebenen Runtimebestandteile installiert und nicht das gesamte SDK. Diese Option entspricht der Angabe von -Runtime|--runtime dotnet.

  • -SkipNonVersionedFiles|--skip-non-versioned-files

    Die Installation nicht versionierte Dateien, wie dotnet.exe, wird übersprungen, falls diese bereits vorhanden sind.

  • -UncachedFeed|--uncached-feed

    Ermöglicht das Ändern der URL für den nicht zwischengespeicherten Feed, der von diesem Installer verwendet wird. Es wird nicht empfohlen, diesen Wert nicht zu ändern.

  • -Verbose|--verbose

    Es werden Diagnoseinformationen angezeigt.

  • -Version|--version <VERSION>

    Stellt eine bestimmte Buildversion dar. Mögliche Werte sind:

    • latest – der neueste Build auf dem Kanal (mit der -Channel-Option verwendet).
    • Dreiteilige Version im X.Y.Z-Format, die eine bestimmte Buildversion darstellt; sie hat Vorrang vor der -Channel-Option. Beispiel: 2.0.0-preview2-006120.

    Wenn nichts angegeben ist, wird für -Version standardmäßig latest verwendet.

Beispiele

  • Installieren Sie die neueste langfristig unterstützte (Long-Term Supported, LTS) Version am Standardspeicherort:

    Windows:

    ./dotnet-install.ps1 -Channel LTS
    

    Mac OS/Linux:

    ./dotnet-install.sh --channel LTS
    
  • Installieren Sie die neueste Vorschauversion des SDK 6.0.1xx am angegebenen Speicherort:

    Windows:

    ./dotnet-install.ps1 -Channel 6.0.1xx -Quality preview -InstallDir C:\cli
    

    Mac OS/Linux:

    ./dotnet-install.sh --channel 6.0.1xx --quality preview --install-dir ~/cli
    
  • Installieren Sie die Version 3.0.0 der Shared Runtime:

    Windows:

    ./dotnet-install.ps1 -Runtime dotnet -Version 3.0.0
    

    Mac OS/Linux:

    ./dotnet-install.sh --runtime dotnet --version 3.0.0
    
  • Rufen Sie das Skript ab und installieren Sie die Version 2.1.2 hinter einem Unternehmensproxy (nur Windows):

    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 einzeiligen Beispiele für die .NET-CLI:

    Windows:

    # Run a separate PowerShell process because the script calls exit, so it will end the current PowerShell session.
    &powershell -NoProfile -ExecutionPolicy unrestricted -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; &([scriptblock]::Create((Invoke-WebRequest -UseBasicParsing 'https://dot.net/v1/dotnet-install.ps1'))) <additional install-script args>"
    

    Mac OS/Linux:

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

Siehe auch