dotnetup-Übersicht

Hinweis

dotnetup befindet sich in der öffentlichen Vorschau. Die Features und das Verhalten können sich vor der allgemeinen Verfügbarkeit ändern.

dotnetup ist ein plattformübergreifender Toolchain-Manager für .NET-Installationen auf Benutzerebene. Es installiert .NET SDKs und Laufzeiten, ohne in ein vom System verwaltetes .NET Verzeichnis zu schreiben. Außerdem werden die von Ihnen ausgewählten Installationsanforderungen nachverfolgt, damit das Programm die zugehörigen Dateien später aktualisieren oder entfernen kann.

Verwenden Sie dotnetup, um:

  • Installieren Sie stabile, Preview-, tägliche oder bestimmte .NET-Versionen.
  • Verwalten Sie mehrere SDK- und Laufzeitanforderungen in einer verwalteten Installation.
  • Installieren Sie das SDK, das für die nächstgelegenen global.json Datei erforderlich ist.
  • Aktualisieren Sie verfolgte Kanäle, ohne die genauen Versionsanforderungen zu ändern.
  • Konfigurieren Sie, wie Terminals und Anwendungen die verwaltete dotnet finden.
  • Führen Sie die verwaltete dotnet aus, ohne PATH zu ändern.

Start

Führen Sie das interaktive Setup aus:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: Terminal Mode (Suggested)

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>
Setup complete!

Das Setup fragt, welcher SDK-Kanal installiert werden soll und wie Sie auf den Befehl für verwalteten Code dotnet zugreifen möchten.

Installieren Sie für ein präzises, nichtinteraktives Setup ein SDK, und konfigurieren Sie die aktuelle Shell:

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set shell
dotnet and dotnetup are on your PATH.
To apply the change to this terminal now, run:
<shell-specific command>
Or open a new terminal.

> dotnetup list
Installations (managed by dotnetup):

  <default-installation-root>

    Tracked channels:
      SDK latest  (source: explicit)

    Installed versions:
      SDK <resolved-version>  (<architecture>)

Total: 1

> dotnet --version
<resolved-version>

Wenn Sie Ihr Shellprofil nicht ändern möchten, verwenden Sie den Weiterleitungsbefehl:

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set none
dotnetup is on your PATH. dotnet is not — run it with 'dotnetup dotnet <command>'.
Open a new terminal for the change to take effect.

> dotnetup dotnet --version
<resolved-version>

Der Modus, die aufgelöste Version, die Architektur, der Installationspfad und der Shell-Befehl hängen von Ihrem System und den verfügbaren Versionen ab.

Wie dotnetup .NET verwaltet

dotnetup verfolgt die von Ihnen angeforderten SDK-Installationen. Diese Nachverfolgung ermöglicht es dotnetup, viele Installationen gleichzeitig zu aktualisieren. Außerdem ermöglicht dotnetup, unbenutzte oder nicht mehr unterstützte Installationen sicher zu entfernen.

Weitere Informationen finden Sie unter Funktionsweise von dotnetup.

Zielsetzung Artikel
Entscheiden, ob dotnetup zu Ihrem Szenario passt Wann dotnetup verwendet werden sollte
Installieren Sie dotnetup und führen Sie das erste Setup aus Erste Schritte mit dotnetup
Kanäle, Installationsverzeichnisse und Nachverfolgung verstehen Funktionsweise von dotnetup
Verwenden Sie das Repository global.json Verwalten von Repository-SDK-Anforderungen
SDKs und Runtimes installieren Installation von .NET-Komponenten
Installationen aktualisieren oder entfernen Installationen aktualisieren
dotnetup selbst aktualisieren oder entfernen dotnetup aktualisieren oder entfernen
Konfigurieren Sie PATH und DOTNET_ROOT dotnetup-Umgebung verwalten
Vorschau oder tägliche Builds ausprobieren Verwenden Sie Vorschau- und tägliche Builds
Häufige Probleme beheben Problembehandlung bei dotnetup
Erfahren Sie, welche Daten dotnetup sammelt dotnetup-Telemetrie
Befehlssyntax nachschlagen dotnetup-Befehlsreferenz

Availability

dotnetup ist als öffentliche Vorschau verfügbar. Befehle, Optionen und Verhalten können sich zwischen Vorschauversionen ändern, und der Supportlebenszyklus für die allgemein verfügbare Version ist nicht abgeschlossen.

Zum Installieren dotnetup siehe Erste Schritte mit dotnetup. Führen Sie nach der Installation dotnetup --version aus, um die Version zu bestätigen, und dotnetup --help, um die verfügbaren Befehle anzuzeigen.

  • Zuletzt aktualisiert um