Skip to content

Update the dotnet tool install page #45147

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gewarren merged 4 commits into from
Apr 7, 2025
Merged

Update the dotnet tool install page #45147

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c1aac08
Add brief explanation of --allow-roll-forward to dotnet-tool-install
BartoszKlonowski Mar 5, 2025
fa9de95
Update the name of the --no-http-cache option
BartoszKlonowski Mar 5, 2025
4268aa8
Add --source option with the description
BartoszKlonowski Mar 5, 2025
5ab7d43
A few updates
gewarren Apr 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 12 additions & 4 deletions docs/core/tools/dotnet-tool-install.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: dotnet tool install command
description: The dotnet tool install command installs the specified .NET tool on your machine.
ms.date: 03/15/2024
ms.date: 04/07/2025
---
# dotnet tool install

Expand Down Expand Up @@ -129,6 +129,10 @@ For more information, see [Install a local tool](global-tools.md#install-a-local

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

- **`--source <SOURCE>`**

Specifies the source for NuGet packages. This source replaces all NuGet package sources.

[!INCLUDE [help](../../../includes/cli-help.md)]

- **`--ignore-failed-sources`**
Expand All @@ -141,7 +145,7 @@ For more information, see [Install a local tool](global-tools.md#install-a-local

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

- **`--no-cache`**
- **`--no-cache` or `--no-http-cache`**

Don't cache packages and HTTP requests.

Expand All @@ -155,15 +159,19 @@ For more information, see [Install a local tool](global-tools.md#install-a-local

- **`--tool-path <PATH>`**

Specifies the location where to install the Global Tool. PATH can be absolute or relative. If PATH doesn't exist, the command tries to create it. Omitting both `--global` and `--tool-path` specifies a local tool installation.
Specifies the location to install the Global Tool. PATH can be absolute or relative. If PATH doesn't exist, the command tries to create it. Omitting both `--global` and `--tool-path` specifies a local tool installation.

- **`--allow-roll-forward`**

Allow tool to use a newer version of the .NET runtime if the runtime it targets isn't installed.

[!INCLUDE [verbosity](../../../includes/cli-verbosity.md)]

- **`--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.

Starting with .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.*`.
Starting with .NET 8, `--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

Expand Down