Freigeben über


dotnet tool update

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.

Siehe auch