dotnet tool update

  • Статья

Эта статья относится к: ✔️ пакету SDK для .NET Core 3.1 и более поздних версий

Имя.

dotnet tool update обновляет указанное средство .NET на компьютере.

Краткие сведения

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

Description

Команда dotnet tool update предоставляет способ обновления средства .NET на компьютере до последней стабильной версии пакета. Команда удаляет и повторно устанавливает средство, эффективно обновляя его. Чтобы использовать команду, необходимо указать один из следующих параметров:

  • Чтобы обновить глобальное средство, установленное в расположении по умолчанию, используйте параметр --global
  • Чтобы обновить глобальное средство, установленное в пользовательском расположении, используйте параметр --tool-path.
  • Чтобы обновить локальное средство, используйте параметр --local.

Аргументы

  • PACKAGE_ID

    Имя или идентификатор пакета NuGet, который содержит глобальное средство .NET, которое вы хотите обновить. Найти имя пакета можно с помощью команды dotnet tool list.

Параметры

  • --add-source <SOURCE>

    Добавляет дополнительный источник пакета NuGet для использования во время установки. Доступ к каналам осуществляется параллельно, а не последовательно в некотором порядке приоритета. Если один и тот же пакет и версия находятся в нескольких каналах, используется самый быстрый канал. Дополнительные сведения см. в разделе Процесс установки пакета NuGet.

  • --allow-downgrade

    Разрешить понижение уровня пакета при установке или обновлении пакета средств .NET. Подавляет предупреждение", "Запрошенная версия x.x.x ниже существующей версии x.x.x".

  • --configfile <FILE>

    Файл конфигурации NuGet (nuget.config), который будет использоваться. Если этот параметр указан, будут использоваться только параметры из этого файла. Если не указано, будет использоваться иерархия файлов конфигурации из текущего каталога. Дополнительные сведения см. в статье Распространенные конфигурации NuGet.

  • --disable-parallel

    Блокирует параллельное восстановление множества проектов.

  • --framework <FRAMEWORK>

    Указывает требуемую версию .NET Framework для обновления средства.

  • -g|--global

    Указывает, что обновление предназначено для средства уровня пользователя. Не может использоваться вместе с параметром --tool-path. Пропуск --global и --tool-path означает, что обновляемое средство является локальным.

  • -?|-h|--help

    Выводит описание использования команды.

  • --ignore-failed-sources

    Обрабатывать сбои источников пакетов как предупреждения.

  • --interactive

    Позволяет команде остановиться и дождаться, пока пользователь выполнит действие или введет данные. Например, чтобы завершить проверку подлинности.

  • --local

    Обновляет средство и манифест локального средства. Не может использоваться вместе с параметром --global или --tool-path.

  • --no-cache

    Запрещает кэширование пакетов и HTTP-запросов.

  • --prerelease

    Включите предварительные версии.

  • --tool-manifest <PATH>

    Путь к файлу манифеста.

  • --tool-path <PATH>

    Указывает место установки глобального средства. Путь может быть абсолютным или относительным. Не может использоваться вместе с параметром --global. Пропуск --global и --tool-path означает, что обновляемое средство является локальным.

  • -v|--verbosity <LEVEL>

    Задает уровень детализации команды. Допустимые значения: q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic]. Дополнительные сведения см. в разделе LoggerVerbosity.

  • --version <VERSION>

    Диапазон версий пакета средства для обновления. Нельзя использовать для перехода на более ранние версии, необходимо сначала uninstall новые версии.

    Начиная с .NET 8.0, --version Major.Minor.Patch ссылается на определенную версию major.minor.patch, включая незаписанные версии. Чтобы получить последнюю версию определенной основной.дополнительной версии, используйте --version Major.Minor.*.

Примеры

  • dotnet tool update -g dotnetsay

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

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

    Обновляет глобальное средство dotnetsay, расположенное в определенном каталоге Windows.

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

    Обновляет глобальное средство dotnetsay, расположенное в определенном каталоге Linux/macOS.

  • dotnet tool update dotnetsay

    Обновляет локальное средство dotnetsay, установленное для текущего каталога.

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

    Обновляет глобальное средство dotnetsay до последней версии исправления с основным номером версии 2 и дополнительным номером версии 0.

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

    Обновляет глобальное средство dotnetsay до самой низкой версии в указанном диапазоне (> 2.0.0 && < 2.1.4). Будет установлена версия 2.1.0. Дополнительные сведения о семантических диапазонах версий см. в разделе Диапазоны версий пакетов NuGet.

См. также