Freigeben über

dotnet-Tool-Aktualisierung

Dieser Artikel gilt für: ✔️ .NET 6 SDK und höhere Versionen

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] [--source <SOURCE>]
    [-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] [--source <SOURCE>]
    [-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] [--source <SOURCE>]
    [--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.

    Verwenden Sie ab .NET 10.0.100 SDK den Namen/die ID und die version getrennt, um @ ein .NET-Tool zu aktualisieren.

    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

    Diese Option 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.

  • --source <SOURCE>

    Gibt die Quelle für NuGet-Pakete an.

  • --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@2.1.7*

    Aktualisiert das globale Dotnetsay-Tool auf die neueste Patchversion 2.1.7.

  • dotnet tool update -g dotnetsay --version (2.0.0,2.1.7)

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

Siehe auch

  • Last updated on