Skip to content

Latest commit

 

History

History
146 lines (89 loc) · 5.39 KB

dotnet-tool-update.md

File metadata and controls

146 lines (89 loc) · 5.39 KB
Raw
title description ms.date
dotnet tool update command
The dotnet tool update command updates the specified .NET tool on your machine.
03/15/2024

dotnet tool update

This article applies to: ✔️ .NET Core 3.1 SDK and later versions

Name

dotnet tool update - Updates the specified .NET tool on your machine.

Synopsis

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --tool-path <PATH>
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] 
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --local
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update -h|--help

Description

The dotnet tool update command provides a way for you to update .NET 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 specify one of the following options:

  • To update a global tool that was installed in the default location, use the --global option
  • To update a global tool that was installed in a custom location, use the --tool-path option.
  • To update a local tool, use the --local option.

Arguments

  • PACKAGE_ID

    Name/ID of the NuGet package that contains the .NET global tool to update. You can find the package name using the dotnet tool list command.

Options

[!INCLUDE add-source]

[!INCLUDE allow-downgrade]

[!INCLUDE configfile]

  • --disable-parallel

    Prevent restoring multiple projects in parallel.

  • --framework <FRAMEWORK>

    Specifies the target framework to update the tool for.

  • -g|--global

    Specifies that the update is for a user-wide tool. Can't be combined with the --tool-path option. Omitting both --global and --tool-path specifies that the tool to be updated is a local tool.

[!INCLUDE help]

  • --ignore-failed-sources

    Treat package source failures as warnings.

[!INCLUDE interactive]

  • --local

    Update the tool and the local tool manifest. Can't be combined with the --global option or the --tool-path option.

  • --no-cache

    Do not cache packages and HTTP requests.

  • --prerelease

    Include prerelease versions.

  • --tool-manifest <PATH>

    Path to the manifest file.

  • --tool-path <PATH>

    Specifies the location where the global tool is installed. PATH can be absolute or relative. Can't be combined with the --global option. Omitting both --global and --tool-path specifies that the tool to be updated is a local tool.

[!INCLUDE verbosity]

  • --version <VERSION>

    The version range of the tool package to update to. This cannot be used to downgrade versions, you must uninstall newer versions first.

    Starting in .NET 8.0, --version Major.Minor.Patch refers to a specific major.minor.patch version, including unlisted versions. To get the latest version of a certain major.minor version instead, use --version Major.Minor.*.

Examples

  • dotnet tool update -g dotnetsay

    Updates the dotnetsay global tool.

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

    Updates the dotnetsay global tool located in a specific Windows directory.

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

    Updates the dotnetsay global tool located in a specific Linux/macOS directory.

  • dotnet tool update dotnetsay

    Updates the dotnetsay local tool installed for the current directory.

  • dotnet tool update -g dotnetsay --version 2.0.*

    Updates the dotnetsay global tool to the latest patch version, with a major version of 2, and a minor version of 0.

  • dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)

    Updates the dotnetsay global tool to the lowest version within the specified range (> 2.0.0 && < 2.1.4), version 2.1.0 would be installed. For more information on semantic versioning ranges, see NuGet packaging version ranges.

See also