dotnet tool updatedotnet tool update

Эта статья относится к следующему. ✔️ SDK для .NET Core 2.1 и более поздних версийThis article applies to: ✔️ .NET Core 2.1 SDK and later versions

nameName

dotnet tool update обновляет указанное средство .NET на компьютере.dotnet tool update - Updates the specified .NET tool on your machine.

Краткий обзорSynopsis

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] [--no-cache]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --tool-path <PATH>
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] [--no-cache]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --local
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] [--no-cache]
    [--tool-manifest <PATH>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update -h|--help

ОписаниеDescription

Команда dotnet tool update предоставляет способ обновления средства .NET на компьютере до последней стабильной версии пакета.The dotnet tool update command provides a way for you to update .NET tools on your machine to the latest stable version of the package. Команда удаляет и повторно устанавливает средство, эффективно обновляя его.The command uninstalls and reinstalls a tool, effectively updating it. Чтобы использовать команду, необходимо указать один из следующих параметров:To use the command, you specify one of the following options:

  • Чтобы обновить глобальное средство, установленное в расположении по умолчанию, используйте параметр --globalTo update a global tool that was installed in the default location, use the --global option
  • Чтобы обновить глобальное средство, установленное в пользовательском расположении, используйте параметр --tool-path.To update a global tool that was installed in a custom location, use the --tool-path option.
  • Чтобы обновить локальное средство, используйте параметр --local.To update a local tool, use the --local option.

Локальные средства доступны в пакете SDK для .NET Core, начиная с версии 3.0.Local tools are available starting with .NET Core SDK 3.0.

АргументыArguments

  • PACKAGE_ID

    Имя или идентификатор пакета NuGet, который содержит глобальное средство .NET, которое вы хотите обновить.Name/ID of the NuGet package that contains the .NET global tool to update. Найти имя пакета можно с помощью команды dotnet tool list.You can find the package name using the dotnet tool list command.

ПараметрыOptions

  • --add-source <SOURCE>

    Добавляет дополнительный источник пакета NuGet для использования во время установки.Adds an additional NuGet package source to use during installation.

  • --configfile <FILE>

    Файл конфигурации NuGet (nuget.config), который будет использоваться.The NuGet configuration (nuget.config) file to use.

  • --disable-parallel

    Блокирует параллельное восстановление множества проектов.Prevent restoring multiple projects in parallel.

  • --framework <FRAMEWORK>

    Указывает требуемую версию .NET Framework для обновления средства.Specifies the target framework to update the tool for.

  • --ignore-failed-sources

    Обрабатывать сбои источников пакетов как предупреждения.Treat package source failures as warnings.

  • --interactive

    Позволяет остановить команду и дождаться, пока пользователь введет данные или выполнит действие (например, завершит проверку подлинности).Allows the command to stop and wait for user input or action (for example to complete authentication).

  • --local

    Обновляет средство и манифест локального средства.Update the tool and the local tool manifest. Не может использоваться вместе с параметром --global или --tool-path.Can't be combined with the --global option or the --tool-path option.

  • --no-cache

    Запрещает кэширование пакетов и HTTP-запросов.Do not cache packages and HTTP requests.

  • --tool-manifest <PATH>

    Путь к файлу манифеста.Path to the manifest file.

  • --tool-path <PATH>

    Указывает место установки глобального средства.Specifies the location where the global tool is installed. Путь может быть абсолютным или относительным.PATH can be absolute or relative. Не может использоваться вместе с параметром --global.Can't be combined with the --global option. Пропуск --global и --tool-path означает, что обновляемое средство является локальным.Omitting both --global and --tool-path specifies that the tool to be updated is a local tool.

  • --version <VERSION>

    Диапазон версий пакета средства для обновления.The version range of the tool package to update to. Нельзя использовать для перехода на более ранние версии, необходимо сначала uninstall новые версии.This cannot be used to downgrade versions, you must uninstall newer versions first.

  • -g|--global

    Указывает, что обновление предназначено для средства уровня пользователя.Specifies that the update is for a user-wide tool. Не может использоваться вместе с параметром --tool-path.Can't be combined with the --tool-path option. Пропуск --global и --tool-path означает, что обновляемое средство является локальным.Omitting both --global and --tool-path specifies that the tool to be updated is a local tool.

  • -h|--help

    Выводит краткую справку по команде.Prints out a short help for the command.

  • -v|--verbosity <LEVEL>

    Задает уровень детализации команды.Sets the verbosity level of the command. Допустимые значения: q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic].Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic].

ПримерыExamples

  • dotnet tool update -g dotnetsay

    Обновляет глобальное средство dotnetsay.Updates the dotnetsay global tool.

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

    Обновляет глобальное средство dotnetsay, расположенное в определенном каталоге Windows.Updates the dotnetsay global tool located in a specific Windows directory.

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

    Обновляет глобальное средство dotnetsay, расположенное в определенном каталоге Linux/macOS.Updates the dotnetsay global tool located in a specific Linux/macOS directory.

  • dotnet tool update dotnetsay

    Обновляет локальное средство dotnetsay, установленное для текущего каталога.Updates the dotnetsay local tool installed for the current directory.

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

    Обновляет глобальное средство dotnetsay до последней версии исправления с основным номером версии 2 и дополнительным номером версии 0.Updates the dotnetsay global tool to the latest patch version, with a major version of 2, and a minor version of 0.

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

    Обновляет глобальное средство dotnetsay до самой низкой версии в указанном диапазоне (> 2.0.0 && < 2.1.4). Будет установлена версия 2.1.0.Updates the dotnetsay global tool to the lowest version within the specified range (> 2.0.0 && < 2.1.4), version 2.1.0 would be installed. Дополнительные сведения о семантических диапазонах версий см. в разделе Диапазоны версий пакетов NuGet.For more information on semantic versioning ranges, see NuGet packaging version ranges.

См. такжеSee also