Nachverfolgte .NET-Installationen mit dotnetup aktualisieren

Hinweis

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

dotnetup speichert den angeforderten Kanal separat von der aufgelösten Version. Ein Update löst jeden fortlaufenden Kanal erneut auf.

Diese Updates aktualisieren die ausführbare Datei dotnetup nicht. Um das Tool selbst zu aktualisieren, verwenden Sie dotnetup self update.

Aktualisierungsbereich auswählen

Verwenden Sie einen der folgenden Befehle:

# Update all tracked SDK and runtime requirements.
dotnetup update

# Update SDK requirements only.
dotnetup sdk update

# Update SDK and runtime requirements.
dotnetup sdk update --all

# Update runtime requirements only.
dotnetup runtime update

Laufzeitupdates umfassen die Kern-.NET- und ASP.NET Core-Laufzeiten. Auf Windows enthalten sie auch Windows Desktoplaufzeitanforderungen.

Beschränken des Installationsstammverzeichnisses

Standardmäßig kann ein Update Anforderungen für alle Roots im ausgewählten Manifest verarbeiten. Verwenden Sie --install-path, um den Vorgang einzuschränken:

dotnetup update --install-path D:\tools\dotnet

Repositorydateien aktualisieren

SDK-Anforderungen können global.json als Quelle verwenden. Führen Sie Folgendes aus, um die neu aufgelöste SDK-Version wieder in jede Quelldatei zu schreiben:

dotnetup sdk update --update-global-json

Ohne diese Option installiert dotnetup das Update, bearbeitet aber nicht die Repositorydatei.

Eine Aktualisierung verarbeitet gespeicherte Abhängigkeiten, bevor die Garbage Collection geänderte global.json-Quellen neu lädt. Nachdem Sie das global.json eines Repositorys geändert haben, führen Sie dotnetup sdk install in diesem Repository aus, bevor Sie die gespeicherten Anforderungen aktualisieren. Andernfalls verarbeitet das erste Update möglicherweise noch die vorherige Anforderung.

Updateverhalten verstehen

  • Genaue SDK- und Laufzeitversionen werden übersprungen – sie wurden explizit festgelegt, sodass sie nie aktualisiert werden können.
  • Jede Installationsanforderung wird unabhängig voneinander verarbeitet.
  • Die Verarbeitung aller Installationsanforderungen wird nach einem einzelnen Fehler fortgesetzt.
  • Der Befehl meldet einen Fehler, nachdem alle verbleibenden Installationsanforderungen verarbeitet wurden.
  • Erfolgreiche Updates führen Garbage Collection aus – ein Bereinigungsprozess, der alle installierten Komponenten entfernt, die von keiner Ihrer konfigurierten Installationsanforderungen tatsächlich benötigt werden.
  • Eine installierte Version bleibt bestehen, wenn sie weiterhin von einer anderen Anforderung benötigt wird.

Überprüfen des Ergebnisses

Nachverfolgungsstatus und Installationen auf dem Datenträger überprüfen:

dotnetup list

Für maschinenlesbare Ausgabe:

dotnetup list --format json

Nachverfolgte Anforderung entfernen

Um eine SDK-Anforderung zu entfernen, übergeben Sie den gespeicherten Kanal oder die genaue Version:

dotnetup sdk uninstall 10.0.1xx

Die Deinstallation entfernt die Abhängigkeit und bereinigt dann nicht referenzierte Installationen im gesamten ausgewählten Stamm. Es warnt, wenn eine andere Anforderung die angeforderte Installation verhindert oder wenn die Bereinigung zusätzliche Installationen entfernt. Überprüfen Sie diese Warnungen, bevor Sie den Vorgang bestätigen. Verwenden Sie in der nichtinteraktiven Automatisierung --non-interactive, um die Bestätigung zu überspringen, nicht die Warnungen.

Verwenden Sie dotnetup runtime uninstall für die Laufzeitanforderungen. Ausführliche Informationen finden Sie unter SDK-Deinstallation und Laufzeitdeinstallation.

Siehe auch

  • Zuletzt aktualisiert um