-
Notifications
You must be signed in to change notification settings - Fork 6k
Add new command reference articles #48788
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.
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
meaghanlewis
merged 8 commits into
dotnet:main
from
meaghanlewis:add-dotnet-command-reference
Oct 3, 2025
Merged
Changes from 3 commits
Commits
Show all changes
8 commits
Select commit
Hold shift + click to select a range
17aa488
Add new command reference articles
meaghanlewis 098f3b2
fix file extensions and links
meaghanlewis 16b7d4a
Update dotnet package documentation
meaghanlewis fc1690e
Update docs/core/tools/dotnet-package-update.md
meaghanlewis 65763cc
Update docs/core/tools/dotnet-workload-clean.md
meaghanlewis ce51a0f
Update docs/core/tools/dotnet-workload-clean.md
meaghanlewis a56b64b
remove dotnet-package-update and references
meaghanlewis 1534819
Merge branch 'main' into add-dotnet-command-reference
meaghanlewis File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,52 @@ | ||
--- | ||
title: dotnet package update command | ||
description: The dotnet package update command provides a convenient option to update a NuGet package reference to a project. | ||
ms.date: 09/29/2025 | ||
--- | ||
# dotnet package update | ||
|
||
**This article applies to:** ✔️ .NET 6 SDK and later versions | ||
|
||
## Name | ||
|
||
`dotnet package update` - Updates referenced packages in a project or solution. | ||
|
||
> [!NOTE] | ||
> If you're using .NET 9 SDK or earlier, use the "verb first" form (`dotnet update package`) instead. The "noun first" form was introduced in .NET 10. For more information, see [More consistent command order](../whats-new/dotnet-10/sdk.md#more-consistent-command-order). | ||
|
||
## Synopsis | ||
|
||
```dotnetcli | ||
dotnet package update <PACKAGE_NAME> [--project <PROJECT>] [--interactive] [-v|--verbosity <LEVEL>] | ||
dotnet package update -h|--help | ||
``` | ||
|
||
## Description | ||
|
||
The `dotnet package update` command provides a convenient option to update a NuGet package reference in a project or solution. | ||
|
||
## Arguments | ||
|
||
`PACKAGE_NAME` | ||
|
||
The package reference to update. | ||
|
||
## Options | ||
|
||
- **`-p|--project <PROJECT>`** | ||
|
||
The project file to operate on. If a solution file is specified, the command will update the package in all projects in the solution that reference it. If not specified, the command will search the current directory for a project file. | ||
meaghanlewis marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
||
[!INCLUDE [interactive](../../../includes/cli-interactive.md)] | ||
|
||
[!INCLUDE [verbosity](../../../includes/cli-verbosity-normal.md)] | ||
|
||
[!INCLUDE [help](../../../includes/cli-help.md)] | ||
|
||
## Examples | ||
|
||
- Update `Microsoft.Extensions.Logging` NuGet package from a project in the current directory: | ||
|
||
```dotnetcli | ||
dotnet package update Microsoft.Extensions.Logging | ||
``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
--- | ||
title: dotnet workload clean command | ||
description: "The `dotnet workload clean` command removes workload components that may have been left behind from previous updates and uninstallations." | ||
meaghanlewis marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
ms.date: 09/29/2025 | ||
--- | ||
# dotnet workload clean | ||
|
||
**This article applies to:** ✔️ .NET 6 SDK and later versions | ||
|
||
## Name | ||
|
||
`dotnet workload clean` - Removes workload components that may have been left behind from previous updates and uninstallations. | ||
meaghanlewis marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
||
## Synopsis | ||
|
||
```dotnetcli | ||
dotnet workload clean [options] | ||
|
||
dotnet workload clean -?|-h|--help | ||
``` | ||
|
||
## Description | ||
|
||
The `dotnet workload clean` command removes all workload components that have been uninstalled. | ||
|
||
For more information about the `dotnet workload` commands, see the [dotnet workload install](dotnet-workload-install.md#description) command. | ||
|
||
## Options | ||
|
||
- **--all** | ||
|
||
Removes and uninstalls all workload components from all SDK versions. Defaults to `false`. | ||
|
||
[!INCLUDE [help](../../../includes/cli-help.md)] | ||
|
||
## Examples | ||
|
||
- Remove all workflow components: | ||
|
||
```dotnetcli | ||
dotnet workload clean --all | ||
``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
--- | ||
title: dotnet workload history command | ||
description: "The `dotnet workload history` command shows a history of workload installation actions." | ||
ms.date: 09/29/2025 | ||
--- | ||
# dotnet workload history | ||
|
||
**This article applies to:** ✔️ .NET 6 SDK and later versions | ||
|
||
## Name | ||
|
||
`dotnet workload history` - Shows a history of workload installation actions. | ||
|
||
## Synopsis | ||
|
||
```dotnetcli | ||
dotnet workload history [options] | ||
|
||
dotnet workload history -?|-h|--help | ||
``` | ||
|
||
## Description | ||
|
||
The `dotnet workload history` shows a history of workload installation actions. | ||
|
||
For more information about the `dotnet workload` commands, see the [dotnet workload install](dotnet-workload-install.md#description) command. | ||
|
||
## Options | ||
|
||
- **--all** | ||
|
||
Removes and uninstalls all workload components from all SDK versions. Defaults to `false`. | ||
|
||
[!INCLUDE [help](../../../includes/cli-help.md)] | ||
|
||
## Examples | ||
|
||
- Remove all workflow components: | ||
|
||
```dotnetcli | ||
dotnet workload history --all | ||
``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.