Udostępnij za pośrednictwem

aktualizacja narzędzia dotnet (komenda do aktualizacji narzędzi .NET)

Ten artykuł dotyczy: ✔️ pakietu SDK .NET Core 3.1 oraz jego nowszych wersji

Nazwa

dotnet tool update — Aktualizuje określone narzędzie .NET na maszynie.

Streszczenie

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

Opis

Polecenie dotnet tool update umożliwia aktualizowanie narzędzi platformy .NET na maszynie do najnowszej stabilnej wersji pakietu. Polecenie odinstalowuje i ponownie instaluje narzędzie, skutecznie go aktualizując. Aby użyć polecenia, należy określić jedną z następujących opcji:

  • Aby zaktualizować narzędzie globalne zainstalowane w domyślnej lokalizacji, użyj --global opcji
  • Aby zaktualizować globalne narzędzie zainstalowane w lokalizacji niestandardowej, użyj --tool-path opcji .
  • Aby zaktualizować narzędzie lokalne, użyj --local opcji .

Argumenty (w programowaniu)

  • PACKAGE_ID

    Nazwa/identyfikator pakietu NuGet zawierającego narzędzie globalne platformy .NET do aktualizacji. Nazwę pakietu można znaleźć za pomocą polecenia dotnet tool list .

Opcje

  • --add-source <SOURCE>

    Dodaje dodatkowe źródło pakietu NuGet do użycia podczas instalacji. Kanały informacyjne są dostępne równolegle, a nie sekwencyjnie w określonej kolejności pierwszeństwa. Jeśli ten sam pakiet i wersja są w wielu kanałach informacyjnych, najszybsze źródło danych wygrywa. Aby uzyskać więcej informacji, zobacz Co się stanie po zainstalowaniu pakietu NuGet?.

  • --all

    Zaktualizuj wszystkie narzędzia.

  • --allow-downgrade

    Zezwalaj na obniżenie poziomu pakietu podczas instalowania lub aktualizowania pakietu narzędzi .NET. Pomija ostrzeżenie "Żądana wersja x.x.x jest niższa niż istniejąca wersja x.x.x".

  • --configfile <FILE>

    Plik konfiguracji NuGet (nuget.config) do użycia. Jeśli zostanie określony, zostaną użyte tylko ustawienia z tego pliku. Jeśli nie zostanie określona, zostanie użyta hierarchia plików konfiguracji z bieżącego katalogu. Aby uzyskać więcej informacji, zobacz Typowe konfiguracje nuGet.

  • --disable-parallel

    Zapobiegaj przywracaniu wielu projektów równolegle.

  • --framework <FRAMEWORK>

    Określa platformę docelową do zaktualizowania narzędzia.

  • -g|--global

    Określa, że aktualizacja dotyczy narzędzia dla całego użytkownika. Nie można połączyć z opcją --tool-path . Pomijanie obu --global tych elementów i --tool-path określa, że narzędzie do zaktualizowania jest narzędziem lokalnym.

  • -?|-h|--help

    Wyświetla opis sposobu używania polecenia .

  • --ignore-failed-sources

    Traktuj błędy źródła pakietu jako ostrzeżenia.

  • --interactive

    Umożliwia zatrzymanie polecenia i oczekiwanie na wprowadzenie lub działanie użytkownika. Na przykład w celu ukończenia uwierzytelniania.

  • --local

    Zaktualizuj narzędzie i lokalny manifest narzędzia. Nie można połączyć z opcją --global lub opcją --tool-path .

  • --no-cache

    Nie buforuj pakietów i żądań HTTP.

  • --prerelease

    Uwzględnij wersje wstępne.

  • --tool-manifest <PATH>

    Ścieżka do pliku manifestu.

  • --tool-path <PATH>

    Określa lokalizację, w której zainstalowano narzędzie globalne. ŚCIEŻKA może być bezwzględna lub względna. Nie można połączyć z opcją --global . Pomijanie obu --global tych elementów i --tool-path określa, że narzędzie do zaktualizowania jest narzędziem lokalnym.

  • -v|--verbosity <LEVEL>

    Ustawia poziom szczegółowości polecenia. Dozwolone wartości to q[uiet], m[inimal], n[ormal], d[etailed]i diag[nostic]. Aby uzyskać więcej informacji, zobacz LoggerVerbosity.

  • --version <VERSION>

    Zakres wersji pakietu narzędzi do aktualizacji. Nie można jej używać do obniżania wersji. Należy uninstall najpierw użyć nowszych wersji.

    Począwszy od platformy .NET 8.0, --version Major.Minor.Patch odwołuje się do określonej wersji major.minor.patch, w tym nieznajdowanych wersji. Aby zamiast tego uzyskać najnowszą wersję wersji głównej.pomocnicza, użyj polecenia --version Major.Minor.*.

Przykłady

  • dotnet tool update -g dotnetsay

    Aktualizuje narzędzie globalne dotnetsay .

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

    Aktualizuje narzędzie globalne dotnetsay znajdujące się w określonym katalogu systemu Windows.

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

    Aktualizuje narzędzie globalne dotnetsay znajdujące się w określonym katalogu systemu Linux/macOS.

  • dotnet tool update dotnetsay

    Aktualizuje narzędzie lokalne dotnetsay zainstalowane dla bieżącego katalogu.

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

    Aktualizuje narzędzie globalne dotnetsay do najnowszej wersji poprawki z główną wersją 2programu i wersją pomocniczą programu 0.

  • dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)

    Aktualizuje narzędzie globalne dotnetsay do najniższej wersji w określonym zakresie (> 2.0.0 && < 2.1.4), zostanie zainstalowana wersja 2.1.0 . Aby uzyskać więcej informacji na temat zakresów wersji semantycznych, zobacz Zakresy wersji pakietów NuGet.

Zobacz także