dotnet tool update

Artikel
03/15/2024

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

Übersicht

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--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>] [--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>] [--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

Der Befehl dotnet tool update ermöglicht Ihnen das Aktualisieren der .NET-Tools auf Ihrem Computer auf die neueste stabile Version des Pakets. Der Befehl deinstalliert und installiert ein Tool neu, sodass es aktualisiert wird. Um den Befehl zu verwenden, geben Sie eine der folgenden Optionen an:

Verwenden Sie zum Aktualisieren eines globalen Tools, das am Standardspeicherort installiert wurde, die Option --global.
Verwenden Sie zum Aktualisieren eines globalen Tools, das an einem benutzerdefinierten Speicherort installiert wurde, die Option --tool-path.
Um ein lokales Tool zu aktualisieren, verwenden Sie die Option --local.

Argumente

PACKAGE_ID

Der Name oder die ID des NuGet-Pakets, das das zu aktualisierende globale .NET-Tool enthält. Mithilfe des Befehls dotnet tool list können Sie den Paketnamen abrufen.

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?.

--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>

Legt das Zielframework des zu aktualisierenden Tools fest.
-g|--global

Gibt an, dass das Update für ein benutzerweites Tool ist. Kann nicht mit der Option --tool-path kombiniert werden. Durch Weglassen von --global und --tool-path wird angegeben, 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

Pakete und HTTP-Anforderungen werden nicht zwischengespeichert.
--prerelease

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

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

Gibt den Speicherort an, in dem das globale Tool installiert ist. „PATH“ kann absolut oder relativ sein. Kann nicht mit der Option --global kombiniert werden. Durch Weglassen von --global und --tool-path wird angegeben, 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 Toolpakets, auf das aktualisiert werden soll. Dies kann nicht zum Herabstufen von Versionen verwendet werden. Sie müssen zuerst neuere Versionen uninstall.

Ab .NET 8.0 bezieht sich --version Major.Minor.Patch auf eine bestimmte Haupt-/Neben-/Patchversion, einschließlich nicht aufgelisteter Versionen. Um stattdessen die neueste Version einer bestimmten Haupt-/Nebenversion 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, das sich in einem bestimmten Windows-Verzeichnis befindet.
dotnet tool update dotnetsay --tool-path ~/bin

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

Aktualisiert das lokale Tool dotnetsay, das im lokalen Verzeichnis installiert ist.
dotnet tool update -g dotnetsay --version 2.0.*

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

Aktualisiert das globale Tool dotnetsay auf die niedrigste Version innerhalb des angegebenen Bereichs (> 2.0.0 && < 2.1.4), Version 2.1.0 würde installiert. Weitere Informationen zu Bereichen der semantischen Versionsverwaltung finden Sie unter Versionsbereiche von NuGet-Paketen.

Freigeben über