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

dotnet tool exec

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

Имя

dotnet tool exec — загружает и вызывает средство .NET без окончательной установки.

Synopsis

dotnet tool exec <PACKAGE_NAME>[@<VERSION>]
    [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-http-cache] [--prerelease] [--source <SOURCE>]
    [-v|--verbosity <LEVEL>]
    [--] [<tool-arguments>...]

dotnet tool exec -h|--help

Description

Эта dotnet tool exec команда предоставляет режим вызова средства с одним снимком для средств .NET. Он автоматически загружает указанный пакет средств в кэш NuGet и вызывает его, не изменяя систему PATH или требуя постоянной установки.

При выполнении команды dotnet tool execвыполните следующую команду:

  1. Проверяет версию (или диапазон версий), указанную (или последнюю версию, если она не указана) для настроенных веб-каналов NuGet, чтобы решить, какой пакет нужно скачать.
  2. Загружает указанный пакет в кэш NuGet (если он еще не присутствует).
  3. Вызывает средство с любыми предоставленными аргументами.
  4. Возвращает код выхода средства.

dotnet tool exec легко работает как с глобальными, так и локальными инструментами. Если у вас есть доступный локальный манифест средства, он использует манифест для определения версии средства для запуска.

Эта команда также существует в двух других формах для упрощения использования

  • dotnet dnx — скрытый псевдоним для dotnet tool exec этого используется как способ легко реализовать dnx сам скрипт.
  • dnx — Скрипт оболочки dotnet dnx , вызывающий из пакета SDK. Этот скрипт предоставляется установщиком и доступен.PATH Это позволяет использовать очень простое использование инструментов непосредственно через dnx <toolname>.

Arguments

  • PACKAGE_NAME

    Идентификатор пакета NuGet для выполнения средства .NET. При необходимости можно указать версию с помощью синтаксиса @ , например dotnetsay@2.1.0.

  • tool-arguments

    Аргументы, передаваемые в выполняемую программу. Все после того, как -- он передается непосредственно в средство.

Options

  • --allow-roll-forward

    Разрешите средству использовать более новую версию среды выполнения .NET, если она не установлена.

  • --add-source <SOURCE>

    Добавляет дополнительный источник пакета NuGet для использования во время установки. Каналы доступны параллельно, а не в резервной каскадной последовательности. Если один и тот же пакет и версия доступны в нескольких каналах, самый быстрый канал выигрывает. Дополнительные сведения см. в статье "Что происходит при установке пакета NuGet". Это можно контролировать с помощью сопоставления источников пакетов NuGet. Дополнительные сведения см. в разделе "Сопоставление источников пакетов".

  • --configfile <FILE>

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

  • --disable-parallel

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

  • --ignore-failed-sources

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

  • --interactive

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

  • --no-http-cache

    Не кэширует HTTP-запросы на настроенные веб-каналы NuGet.

  • --prerelease

    Позволяет выбирать предварительно настроенные пакеты при разрешении версии для установки.

  • --source <SOURCE>

    Указывает источник для пакетов NuGet.

  • -v|--verbosity <LEVEL>

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

  • -?|-h|--help

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

Примеры

  • dotnet tool exec dotnetsay

    Загружает (при необходимости) и запускает последнюю версию dotnetsay средства.

  • dotnet tool exec dotnetsay@2.1.0

    Загружает (при необходимости) и запускает средство версии 2.1.0 dotnetsay .

  • dotnet tool exec dotnetsay@2.*

    Загружает (при необходимости) и запускает последнюю версию средства в диапазоне версий dotnetsay 2.x.

  • dotnet tool exec dotnetsay -- Hello World

    dotnetsay Запускает средство и передает "Hello World" в качестве аргументов в инструмент.

  • dotnet tool exec --add-source https://api.nuget.org/v3/index.json mytool

    Загружает и выполняется mytool с помощью указанного источника NuGet.

Сравнение с другими командами

Эта команда предназначена для единого способа работы с инструментами .NET. Хотя доступные ранее команды установки инструментов остаются доступными, dotnet tool exec предоставляет более простой и гибкий интерфейс для большинства пользователей.

Command Цель Installation Scope
dotnet tool exec Однократное выполнение Нет (только кэшированные) Temporary
dotnet tool install -g Постоянная глобальная установка Глобальный Широкий доступ к системе
dotnet tool install Постоянная локальная установка Локальный манифест Проект
dotnet tool run Запуск уже установленного локального средства Требуется предварительная установка Проект

Команда dotnet tool install -g по-прежнему служит важной целью для пользователей, которые хотят окончательно установить средство. Однако для пользователей, которые хотят попробовать средство или запустить его в конвейере CI/CD, dotnet tool exec часто лучше подходит.

См. также

  • Last updated on