Aktualisieren oder dotnetup entfernen

Hinweis

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

In diesem Artikel wird beschrieben, wie Sie das dotnetup Tool selbst verwalten. Informationen zum Aktualisieren oder Entfernen der .NET SDKs und Runtimes, die von dotnetup verwaltet werden, finden Sie unter Installationen aktualisieren.

Überprüfen Sie die dotnetup-Version

Version von dotnetup anzeigen:

dotnetup --version

Führen Sie zum Anzeigen des Commits, der Architektur, des Laufzeitbezeichners und der überprüften Installationen folgendes aus:

dotnetup --info

Dotnetup aktualisieren

dotnetup verfügt nicht über einen Befehl zum Aktualisieren von sich selbst. Führen Sie zum Aktualisieren dotnetupdas Downloadskript erneut aus. Das Skript ersetzt die vorhandene dotnetup ausführbare Datei im Installationsverzeichnis.

Führen Sie unter macOS oder Linux Folgendes aus:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

Führen Sie auf Windows Folgendes aus:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

Das Skript installiert standardmäßig den neuesten preview Build. Wenn Sie den daily Build oder ein benutzerdefiniertes Installationsverzeichnis verwenden, übergeben Sie die gleichen Optionen, die Sie für die erste Installation verwendet haben. Zum Beispiel unter macOS oder Linux:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily --install-dir /opt/dotnetup

Unter Windows:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily -InstallDir C:\tools\dotnetup"

Durch ein Update dotnetup werden Ihre Installationen, Ihre Umgebungskonfiguration oder Ihre nachverfolgten Installationsspezifikationen nicht geändert.

Dotnetup entfernen

Führen Sie die folgenden Schritte in der angegebenen Reihenfolge aus, um dotnetup und alles, was es verwaltet, zu entfernen.

1. Finden Sie Ihre Installationsstämme

Listen Sie die Installationswurzeln auf, die dotnetup nachverfolgt:

dotnetup list

Notieren Sie jeden Installationsstamm, der sich nicht im dotnetup-Datenverzeichnis befindet. Sie löschen diese Ordner in einem späteren Schritt.

2. Entfernen Sie die Umgebungskonfiguration

Entfernen Sie die Änderungen, die DOTNET_ROOT an PATH und dotnetup vorgenommen hat:

dotnetup env clear

Im shell-Modus führen Sie diesen Befehl in der Shell aus, deren Profil dotnetup geändert wurde, oder wählen Sie diese Shell mit der Option --shell aus. Im everywhere Modus unter Windows ändert dieser Befehl das System PATH und erfordert erhöhte Rechte.

Dieser Befehl entfernt keine SDKs oder Laufzeiten. Weitere Informationen finden Sie unter Entfernen der Umgebungskonfiguration.

3. Löschen Sie die Installationsstamm- und Datenverzeichnisse

Löschen Sie jedes Installationsverzeichnis, das Sie in Schritt 1 aufgezeichnet haben.

Löschen Sie dann das Dotnetup-Datenverzeichnis. Dieses Verzeichnis enthält das Standard-Installationsverzeichnis, das Manifest, die Konfigurationsdatei und den Downloadcache.

Betriebssystem Standarddatenverzeichnis
Windows %LOCALAPPDATA%\dotnetup
macOS ~/Library/Application Support/dotnetup
Linux $XDG_DATA_HOME/dotnetup, oder ~/.local/share/dotnetup wenn XDG_DATA_HOME nicht festgelegt ist

Wenn Sie die Umgebungsvariable DOTNET_DOTNETUP_DATA_DIR setzen, löschen Sie stattdessen dieses Verzeichnis und entfernen Sie dann die Variable.

4. Löschen Sie die ausführbare Datei „dotnetup“

Löschen Sie das Verzeichnis, das die dotnetup ausführbare Datei enthält. Standardmäßig installiert das Downloadskript dotnetup in ~/.dotnetup. Wenn Sie dieses Verzeichnis PATH manuell hinzugefügt haben, entfernen Sie diesen Eintrag aus Ihrem Shellprofil oder aus Ihren Benutzerumgebungsvariablen.

Öffnen Sie ein neues Terminal, um die aktualisierte Umgebung zu verwenden.

Siehe auch