dotnet-installer/Documentation/manpages/sdk/dotnet-tool-update.1

83 lines
2.7 KiB
Groff
Raw Normal View History

.\" Automatically generated by Pandoc 2.2.1
.\"
.TH "dotnet tool update command \- .NET Core CLI" "1" "" "" ".NET Core"
.hy
.SH dotnet tool update
.PP
.SH NAME
.PP
\f[C]dotnet\ tool\ update\f[] \- Updates the specified .NET Core Global Tool on your machine.
.SH SYNOPSIS
.IP
.nf
\f[C]
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>
\f[]
.fi
.SH DESCRIPTION
.PP
The \f[C]dotnet\ tool\ update\f[] 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.
To use the command, you either have to specify that you want to update a tool from a user\-wide installation using the \f[C]\-\-global\f[] option or specify a path to where the tool is installed using the \f[C]\-\-tool\-path\f[] option.
.SS Arguments
.PP
\f[C]PACKAGE_NAME\f[]
.PP
Name/ID of the NuGet package that contains the .NET Core Global Tool to update.
You can find the package name using the dotnet tool list command.
.SH OPTIONS
.PP
\f[C]\-\-add\-source\ <SOURCE>\f[]
.PP
Adds an additional NuGet package source to use during installation.
.PP
\f[C]\-\-configfile\ <FILE>\f[]
.PP
The NuGet configuration (\f[I]nuget.config\f[]) file to use.
.PP
\f[C]\-\-framework\ <FRAMEWORK>\f[]
.PP
Specifies the target framework to update the tool for.
.PP
\f[C]\-g|\-\-global\f[]
.PP
Specifies that the update is for a user\-wide tool.
Can't be combined with the \f[C]\-\-tool\-path\f[] option.
If you don't specify this option, you must specify the \f[C]\-\-tool\-path\f[] option.
.PP
\f[C]\-h|\-\-help\f[]
.PP
Prints out a short help for the command.
.PP
\f[C]\-\-tool\-path\ <PATH>\f[]
.PP
Specifies the location where the Global Tool is installed.
PATH can be absolute or relative.
Can't be combined with the \f[C]\-\-global\f[] option.
If you don't specify this option, you must specify the \f[C]\-\-global\f[] option.
.PP
\f[C]\-v|\-\-verbosity\ <LEVEL>\f[]
.PP
Sets the verbosity level of the command.
Allowed values are \f[C]q[uiet]\f[], \f[C]m[inimal]\f[], \f[C]n[ormal]\f[], \f[C]d[etailed]\f[], and \f[C]diag[nostic]\f[].
.SH EXAMPLES
.PP
Updates the dotnetsay Global Tool:
.PP
\f[C]dotnet\ tool\ update\ \-g\ dotnetsay\f[]
.PP
Updates the dotnetsay Global Tool located on a specific Windows folder:
.PP
\f[C]dotnet\ tool\ update\ dotnetsay\ \-\-tool\-path\ c:\\global\-tools\f[]
.PP
Updates the dotnetsay Global Tool located on a specific Linux/macOS folder:
.PP
\f[C]dotnet\ tool\ update\ dotnetsay\ \-\-tool\-path\ ~/bin\f[]
.SS See also
.PP
\&.NET Core Global Tools
.SH AUTHORS
mairaw.