dotnet tool update
Ten artykuł dotyczy: ✔️ zestaw .NET Core 3.1 SDK i nowsze wersje
Nazwisko
dotnet tool update
— Aktualizacje określone narzędzie .NET na maszynie.
Streszczenie
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
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
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?.
--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]
, ,n[ormal]
m[inimal]
,d[etailed]
, idiag[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
Aktualizacje narzędzia globalnego dotnetsay.
dotnet tool update dotnetsay --tool-path c:\global-tools
Aktualizacje narzędzie globalne dotnetsay znajdujące się w określonym katalogu systemu Windows.
dotnet tool update dotnetsay --tool-path ~/bin
Aktualizacje narzędzie globalne dotnetsay znajdujące się w określonym katalogu systemu Linux/macOS.
dotnet tool update dotnetsay
Aktualizacje narzędzie lokalne dotnetsay zainstalowane dla bieżącego katalogu.
dotnet tool update -g dotnetsay --version 2.0.*
Aktualizacje narzędzia globalnego dotnetsay do najnowszej wersji poprawki, z główną wersją
2
programu i wersją pomocniczą programu0
.dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)
Aktualizacje narzędzie globalne dotnetsay do najniższej wersji w określonym zakresie
(> 2.0.0 && < 2.1.4)
, wersja2.1.0
zostanie zainstalowana. Aby uzyskać więcej informacji na temat zakresów wersji semantycznych, zobacz Zakresy wersji pakietów NuGet.
Zobacz też
- Narzędzia platformy .NET
- Semantyczne przechowywanie wersji
- Samouczek: instalowanie i używanie narzędzia globalnego platformy .NET przy użyciu interfejsu wiersza polecenia platformy .NET
- Samouczek: instalowanie i używanie lokalnego narzędzia platformy .NET przy użyciu interfejsu wiersza polecenia platformy .NET