dotnet tool installdotnet tool install

本文適用於:✓ .NET Core 2.1 SDKThis article applies to: ✓ .NET Core 2.1 SDK

名稱Name

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

包含要安裝的 .NET Core 通用工具之 NuGet 套件的名稱/識別碼。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>

指定要更新其工具的目標 FrameworkSpecifies the target framework to install the tool for. 根據預設,.NET Core SDK 會嘗試選擇最適當的目標 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 可為絕對路徑或相對路徑。PATH can be absolute or relative. 如果 PATH 不存在,命令會嘗試建立它。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

在特定的 Windows 資料夾中安裝 dotnetsay 通用工具:Installs the dotnetsay Global Tool on a specific Windows folder:

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

在特定的 Linux/macOS 資料夾中安裝 dotnetsay 通用工具: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