dotnet tool installdotnet tool install

Эта статья относится к ✓ SDK для .NET Core 2.1This article applies to: ✓ .NET Core 2.1 SDK

nameName

dotnet tool install устанавливает указанное глобальное средство .NET Core на компьютер.dotnet tool install - Installs the specified .NET Core Global Tool on your machine.

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

dotnet tool install <PACKAGE_NAME> <-g|--global> [--add-source] [--configfile] [--framework] [-v|--verbosity] [--version]
dotnet tool install <PACKAGE_NAME> <--tool-path> [--add-source] [--configfile] [--framework] [-v|--verbosity] [--version]
dotnet tool install <-h|--help>

ОписаниеDescription

Команда dotnet tool install предоставляет способ установки глобальных средств .NET Core на компьютере.The dotnet tool install command provides a way for you to install .NET Core Global Tools on your machine. Чтобы использовать эту команду, укажите установку уровня пользователя с помощью параметра --global или укажите путь к месту установки с помощью параметра --tool-path.To use the command, you either have to specify that you want a user-wide installation using the --global option or you specify a path to install it using the --tool-path option.

Глобальные средства устанавливаются в следующие каталоги по умолчанию при выборе параметра -g (или --global):Global Tools are installed in the following directories by default when you specify the -g (or --global) option:

Операционная системаOS ПутьPath
Linux/macOSLinux/macOS $HOME/.dotnet/tools
WindowsWindows %USERPROFILE%\.dotnet\tools

АргументыArguments

PACKAGE_NAME

Имя или идентификатор пакета NuGet, который содержит устанавливаемое глобальное средство .NET Core.Name/ID of the NuGet package that contains the .NET Core Global Tool to install.

Параметры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.

--framework <FRAMEWORK>

Указывает требуемую версию .NET Framework для установки средства.Specifies the target framework to install the tool for. По умолчанию пакет SDK для .NET Core пытается выбрать наиболее подходящую версию .NET Framework.By default, the .NET Core SDK tries to choose the most appropriate target framework.

-g|--global

Указывает, что установка происходит на уровне пользователя.Specifies that the installation is user wide. Не может использоваться вместе с параметром --tool-path.Can't be combined with the --tool-path option. Если вы не укажете этот параметр, укажите параметр --tool-path.If you don't specify this option, you must specify the --tool-path option.

-h|--help

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

--tool-path <PATH>

Указывает место установки глобального средства.Specifies the location where to install the Global Tool. Путь может быть абсолютным или относительным.PATH can be absolute or relative. Если путь не существует, команда пытается создать его.If PATH doesn't exist, the command tries to create it. Не может использоваться вместе с параметром --global.Can't be combined with the --global option. Если вы не укажете этот параметр, укажите параметр --global.If you don't specify this option, you must specify the --global option.

-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].

--version <VERSION_NUMBER>

Версия средства для установки.The version of the tool to install. По умолчанию устанавливается последняя стабильная версия пакета.By default, the latest stable package version is installed. Используйте этот параметр для установки предварительной версии или предыдущей версии средства.Use this option to install preview or older versions of the tool.

ПримерыExamples

Устанавливает глобальное средство dotnetsay в расположении по умолчанию:Installs the dotnetsay Global Tool in the default location:

dotnet tool install -g dotnetsay

Устанавливает глобальное средство dotnetsay в определенную папку Windows:Installs the dotnetsay Global Tool on a specific Windows folder:

dotnet tool install dotnetsay --tool-path c:\global-tools

Устанавливает глобальное средство dotnetsay в определенную папку Linux/macOS:Installs the dotnetsay Global Tool on a specific Linux/macOS folder:

dotnet tool install dotnetsay --tool-path ~/bin

Устанавливает версию 2.0.0 глобального средства dotnetsay:Installs version 2.0.0 of the dotnetsay Global Tool:

dotnet tool install -g dotnetsay --version 2.0.0

См. такжеSee also