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

Führen Sie Folgendes aus, um die ausführbare Datei des eigenständigen dotnetup am vorhandenen Speicherort zu aktualisieren:

dotnetup self update

Dieser Befehl ist in dotnetup 0.3.0 Preview-Builds verfügbar. Er wählt den Veröffentlichungskanal aus der installierten Versionsbezeichnung aus. Offizielle tägliche Builds verwenden auch das preview Label, also geben Sie den Kanal explizit an, um auf täglichen Builds zu bleiben:

dotnetup self update --channel daily

Um von einem neueren täglichen Build zur neuesten öffentlichen Vorschau zurückzukehren, führen Sie Folgendes aus:

dotnetup self update --channel preview --force

--force kann die ausführbare Datei auf eine frühere Version zurücksetzen oder erneut installieren. Informationen zu Befehlsoptionen und Einschränkungen finden Sie unter dotnetup self update.

Ein Update von dotnetup ändert Ihre .NET-Installationen, Ihre Umgebungskonfiguration oder die nachverfolgten Installationsspezifikationen nicht.

Ältere Version aktualisieren oder die ausführbare Datei wiederherstellen

Wenn Ihre Version self update nicht erkennt oder die ausführbare Datei nicht mehr gestartet wird, führen Sie das Downloadskript erneut aus. Das Skript ersetzt die vorhandene ausführbare Datei im ausgewählten 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"

Updatebenachrichtigungen konfigurieren

Nach erfolgreichen interaktiven Installations- und Updatebefehlen kann dotnetup Sie benachrichtigen, dass ein neuerer Build verfügbar ist. Die Mitteilung führt nicht zur Installation des Updates.

Um Benachrichtigungen zu deaktivieren, führen Sie Folgendes aus:

dotnetup self update --update-notifications false

Um Benachrichtigungen erneut zu aktivieren, verwenden Sie --update-notifications true. Informationen zum Überprüfungshäufigkeits- und Ausgabeverhalten finden Sie unter Update-Benachrichtigungen.

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 Installationsstammverzeichnisse

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 von dotnetup vorgenommenen Änderungen PATH und DOTNET_ROOT:

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

  • Zuletzt aktualisiert um