dotnet tool updatedotnet tool update

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

名稱Name

dotnet tool update - 在您的電腦上更新指定的 .NET Core 通用工具dotnet tool update - Updates the specified .NET Core Global Tool on your machine.

概要Synopsis

dotnet tool update <PACKAGE_NAME> <-g|--global> [--configfile] [--framework] [-v|--verbosity]
dotnet tool update <PACKAGE_NAME> <--tool-path> [--configfile] [--framework] [-v|--verbosity]
dotnet tool update <-h|--help>

說明Description

dotnet tool update 命令可讓您將電腦上的 .NET Core 通用工具更新為套件的最新穩定版本。The dotnet tool update command provides a way for you to update .NET Core Global Tools on your machine to the latest stable version of the package. 此命令會解除安裝並重新安裝工具,並有效地更新它。The command uninstalls and reinstalls a tool, effectively updating it. 若要使用此命令,您必須使用 --global 選項指定您要更新使用者範圍安裝中的工具,或使用 --tool-path 選項指定安裝工具的路徑。To use the command, you either have to specify that you want to update a tool from a user-wide installation using the --global option or specify a path to where the tool is installed using the --tool-path option.

引數Arguments

PACKAGE_NAME

包含要更新之 .NET Core 通用工具的 NuGet 套件的名稱/識別碼。Name/ID of the NuGet package that contains the .NET Core Global Tool to update. 您可以使用 dotnet tool list 命令來找到此套件名稱。You can find the package name using the dotnet tool list command.

選項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 update the tool for.

-g|--global

指定更新適用於使用者範圍工具。Specifies that the update is for a user-wide tool. 無法與 --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 the Global Tool is installed. PATH 可為絕對路徑或相對路徑。PATH can be absolute or relative. 無法與 --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].

範例Examples

更新 dotnetsay 通用工具:Updates the dotnetsay Global Tool:

dotnet tool update -g dotnetsay

從特定的 Windows 資料夾中更新 dotnetsay 通用工具:Updates the dotnetsay Global Tool located on a specific Windows folder:

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

從特定的 Windows 資料夾中更新 dotnetsay 通用工具:Updates the dotnetsay Global Tool located on a specific Linux/macOS folder:

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

另請參閱See also