Skip to content

dotnet-tool-update.md

Latest commit

 

History

History
158 lines (95 loc) · 5.76 KB

dotnet-tool-update.md

File metadata and controls

158 lines (95 loc) · 5.76 KB
title dotnet tool update command
description The dotnet tool update command updates the specified .NET tool on your machine.
ms.date 11/12/2025

dotnet tool update

This article applies to: ✔️ .NET 6 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>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

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

dotnet tool update <PACKAGE_ID> --local
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--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.

    Starting in .NET 10.0.100 SDK, use the name/ID, and version separated by @ to update a .NET tool.

    You can find the package name using the dotnet tool list command.

Options

  • [!INCLUDE add-source]

  • --all

    Update all tools.

  • [!INCLUDE allow-downgrade]

  • [!INCLUDE configfile]

  • [!INCLUDE disable-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.

  • [!INCLUDE source]

  • --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@2.1.7*

    Updates the dotnetsay global tool to the latest patch version, 2.1.7.

  • dotnet tool update -g dotnetsay --version (2.0.0,2.1.7)

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

See also