Sdílet prostřednictvím

Aktualizace nástroje dotnet

Tento článek se vztahuje na: ✔️ .NET 6 SDK a novější verze

Název

dotnet tool update – Aktualizuje zadaný nástroj .NET na vašem počítači.

Přehled

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

Popis

Příkaz dotnet tool update poskytuje způsob, jak aktualizovat nástroje .NET na vašem počítači na nejnovější stabilní verzi balíčku. Příkaz odinstaluje a přeinstaluje nástroj a efektivně ho aktualizuje. Pokud chcete použít příkaz, zadejte jednu z následujících možností:

  • Pokud chcete aktualizovat globální nástroj nainstalovaný ve výchozím umístění, použijte --global možnost
  • Pokud chcete aktualizovat globální nástroj nainstalovaný ve vlastním umístění, použijte tuto --tool-path možnost.
  • Pokud chcete aktualizovat místní nástroj, použijte tuto --local možnost.

Argumenty

  • PACKAGE_ID

    Název/ID balíčku NuGet, který obsahuje globální nástroj .NET, který se má aktualizovat.

    Počínaje sadou .NET 10.0.100 SDK použijte název/ID a verzi oddělenou @ nástrojem .NET.

    Název balíčku najdete pomocí příkazu dotnet tool list .

Možnosti

  • --add-source <SOURCE>

    Přidá další zdroj balíčku NuGet, který se použije během instalace. Informační kanály jsou přístupné paralelně, ne postupně v určitém pořadí priorit. Pokud je stejný balíček a verze ve více informačních kanálech, nejrychlejší kanál vyhraje. Další informace najdete v tématu Co se stane při instalaci balíčku NuGet?.

  • --all

    Aktualizujte všechny nástroje.

  • --allow-downgrade

    Povolte downgrade balíčku při instalaci nebo aktualizaci balíčku nástroje .NET. Potlačí upozornění "Požadovaná verze x.x.x je nižší než existující verze x.x.x.".

  • --configfile <FILE>

    Konfigurační soubor NuGet (nuget.config), který se má použít. Pokud je zadáno, použijí se pouze nastavení z tohoto souboru. Pokud není zadáno, použije se hierarchie konfiguračních souborů z aktuálního adresáře. Další informace najdete v tématu Běžné konfigurace NuGet.

  • --disable-parallel

    Zabraňuje paralelnímu obnovení více projektů.

  • --framework <FRAMEWORK>

    Určuje cílovou architekturu pro aktualizaci nástroje.

  • -g|--global

    Určuje, že aktualizace je určená pro nástroj pro celou uživatele. Tuto možnost nejde kombinovat --tool-path . Vynechání obou --global a --tool-path určuje, že nástroj, který se má aktualizovat, je místní nástroj.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • --ignore-failed-sources

    Zacházet se selháním zdroje balíčku jako s upozorněními

  • --interactive

    Umožňuje příkazu zastavit a čekat na uživatelský vstup nebo akci. Například k dokončení ověřování.

  • --local

    Aktualizujte nástroj a manifest místního nástroje. Nelze kombinovat s --global možností ani s --tool-path možností.

  • --no-cache

    Neupamějte balíčky a požadavky HTTP.

  • --prerelease

    Zahrnout předběžné verze.

  • --tool-manifest <PATH>

    Cesta k souboru manifestu

  • --tool-path <PATH>

    Určuje umístění, kde je nainstalovaný globální nástroj. CESTA může být absolutní nebo relativní. Tuto možnost nejde kombinovat --global . Vynechání obou --global a --tool-path určuje, že nástroj, který se má aktualizovat, je místní nástroj.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Další informace najdete v tématu LoggerVerbosity.

  • --version <VERSION>

    Rozsah verzí balíčku nástrojů, na který se má aktualizovat. Tuto možnost nelze použít k downgradu verzí, musíte uninstall nejprve novější verze.

    Počínaje verzí .NET 8.0 --version Major.Minor.Patch odkazuje na konkrétní verzi major.minor.patch, včetně nezasílaných verzí. Pokud chcete získat nejnovější verzi určité hlavní.podverze, použijte --version Major.Minor.*.

Příklady

  • dotnet tool update -g dotnetsay

    Aktualizuje globální nástroj dotnetsay .

  • dotnet tool update dotnetsay --tool-path c:\global-tools

    Aktualizuje globální nástroj dotnetsay umístěný v určitém adresáři Windows.

  • dotnet tool update dotnetsay --tool-path ~/bin

    Aktualizuje globální nástroj dotnetsay umístěný v konkrétním adresáři Linux/macOS.

  • dotnet tool update dotnetsay

    Aktualizuje místní nástroj dotnetsay nainstalovaný pro aktuální adresář.

  • dotnet tool update -g dotnetsay --version 2.0.*

    Aktualizuje globální nástroj dotnetsay na nejnovější verzi opravy s hlavní verzí 2a podverzi 0.

  • dotnet tool update -g dotnetsay@2.1.7*

    Aktualizuje globální nástroj dotnetsay na nejnovější verzi opravy 2.1.7.

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

    Aktualizuje globální nástroj dotnetsay na nejnižší verzi v zadaném rozsahu (> 2.0.0 && < 2.1.7), bude nainstalována verze 2.1.0 . Další informace o sémantických rozsazích verzí najdete v tématu Rozsahy verzí balíčků NuGet.

Viz také

  • Last updated on