Поделиться через

Обновление средства dotnet

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

Имя

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

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

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

Описание

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

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

Аргументы

  • PACKAGE_ID

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

Опции

  • --add-source <SOURCE>

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

  • --all

    Обновите все средства.

  • --allow-downgrade

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

  • --configfile <FILE>

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

  • --disable-parallel

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

  • --framework <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.

См. также