dotnet-Tool-Aktualisierung

2025-06-19

Dieser Artikel gilt für: ✔️ .NET Core 3.1 SDK und höher

Name

dotnet tool update – Aktualisiert das angegebene .NET-Tool auf Ihrem Computer.

Zusammenfassung

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --tool-path <PATH>
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] 
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --local
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update -h|--help

BESCHREIBUNG

Mit dem dotnet tool update Befehl können Sie .NET-Tools auf Ihrem Computer auf die neueste stabile Version des Pakets aktualisieren. Der Befehl deinstalliert und installiert ein Tool neu und aktualisiert es effektiv. Um den Befehl zu verwenden, geben Sie eine der folgenden Optionen an:

Um ein globales Tool zu aktualisieren, das am Standardspeicherort installiert wurde, verwenden Sie die --global Option
Verwenden Sie die --tool-path Option, um ein globales Tool zu aktualisieren, das an einem benutzerdefinierten Speicherort installiert wurde.
Verwenden Sie die --local Option, um ein lokales Tool zu aktualisieren.

Argumente

PACKAGE_ID

Name/ID des NuGet-Pakets, das das zu aktualisierende globale .NET-Tool enthält. Sie finden den Paketnamen mithilfe des Dotnet-Toollistenbefehls .

Optionen

--add-source <SOURCE>

Fügt eine zusätzliche NuGet-Paketquelle für die Installation hinzu. Der Zugriff auf Feeds erfolgt parallel und nicht sequenziell in einer Rangfolge. Wenn sich das gleiche Paket und die gleiche Version in mehreren Feeds befinden, gewinnt der schnellste Feed. Weitere Informationen finden Sie unter Was geschieht bei der NuGet-Paketinstallation?.

--all

Alle Tools aktualisieren.

--allow-downgrade

Paketdowngrade beim Installieren oder Aktualisieren eines .NET-Toolpakets zulassen. Unterdrückt die Warnung: "Die angeforderte Version x.x.x ist niedriger als die vorhandene Version x.x.x."

--configfile <FILE>

Die zu verwendende NuGet-Konfigurationsdatei (nuget.config). Sofern angegeben, werden nur die Einstellungen aus dieser Datei verwendet. Falls nicht angegeben, wird die Hierarchie der Konfigurationsdateien aus dem aktuellen Verzeichnis verwendet. Weitere Informationen finden Sie unter Gängige NuGet-Konfigurationen.

--disable-parallel

Verhindert die parallele Wiederherstellung mehrerer Projekte.
--framework <FRAMEWORK>

Gibt das Zielframework an, für das das Tool aktualisiert werden soll.
-g|--global

Gibt an, dass das Update für ein benutzerweites Tool gilt. Kann nicht mit der Option --tool-path kombiniert werden. Das Auslassen beider Methoden --global und --tool-path gibt an, dass das zu aktualisierende Tool ein lokales Tool ist.

-?|-h|--help

Gibt eine Beschreibung zur Verwendung des Befehls aus.

--ignore-failed-sources

Paketquellenfehler werden als Warnungen behandelt.

--interactive

Ermöglicht dem Befehl, anzuhalten und auf Benutzereingaben oder Aktionen zu warten. Beispielsweise, um die Authentifizierung abzuschließen.

--local

Aktualisieren Sie das Tool und das lokale Toolmanifest. Kann nicht mit der Option --global oder der Option --tool-path kombiniert werden.
--no-cache

Keine Pakete und HTTP-Anforderungen zwischenspeichern.
--prerelease

Schließen Sie Vorabversionen ein.
--tool-manifest <PATH>

Pfad zur Manifestdatei.
--tool-path <PATH>

Gibt den Speicherort an, an dem das globale Tool installiert ist. „PATH“ kann absolut oder relativ sein. Kann nicht mit der Option --global kombiniert werden. Das Auslassen beider Methoden --global und --tool-path gibt an, dass das zu aktualisierende Tool ein lokales Tool ist.

-v|--verbosity <LEVEL>

Legt den Ausführlichkeitsgrad für den Befehl fest. Zulässige Werte sind q[uiet], m[inimal], n[ormal], d[etailed] und diag[nostic]. Weitere Informationen finden Sie unter LoggerVerbosity.

--version <VERSION>

Der Versionsbereich des Zu aktualisierenden Toolpakets. Dies kann nicht zum Downgrade von Versionen verwendet werden, sie müssen zuerst neuere Versionen verwenden uninstall .

Ab .NET 8.0 --version Major.Minor.Patch bezieht sich auf eine bestimmte Major.minor.patch-Version, einschließlich nicht aufgelisteter Versionen. Um stattdessen die neueste Version einer bestimmten Major.Minor-Version zu erhalten, verwenden Sie --version Major.Minor.*.

Beispiele

dotnet tool update -g dotnetsay

Aktualisiert das globale Tool dotnetsay .
dotnet tool update dotnetsay --tool-path c:\global-tools

Aktualisiert das globale Tool dotnetsay in einem bestimmten Windows-Verzeichnis.
dotnet tool update dotnetsay --tool-path ~/bin

Aktualisiert das globale Tool dotnetsay in einem bestimmten Linux/macOS-Verzeichnis.
dotnet tool update dotnetsay

Aktualisiert das lokale Tool dotnetsay , das für das aktuelle Verzeichnis installiert ist.
dotnet tool update -g dotnetsay --version 2.0.*

Aktualisiert das globale Dotnetsay-Tool auf die neueste Patchversion mit einer Hauptversion von 2, und eine Nebenversion von 0.
dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)

Aktualisiert das globale Dotnetsay-Tool auf die niedrigste Version innerhalb des angegebenen Bereichs (> 2.0.0 && < 2.1.4), version 2.1.0 würde installiert werden. Weitere Informationen zu semantischen Versionsverwaltungsbereichen finden Sie unter NuGet-Paketversionsbereiche.

Freigeben über