Skip to content

Commit 3b9cc94

Browse files
Add new command reference articles (#48788)
* Add new command reference articles * fix file extensions and links * Update dotnet package documentation * Update docs/core/tools/dotnet-package-update.md Co-authored-by: Genevieve Warren <[email protected]> * Update docs/core/tools/dotnet-workload-clean.md Co-authored-by: Genevieve Warren <[email protected]> * Update docs/core/tools/dotnet-workload-clean.md Co-authored-by: Genevieve Warren <[email protected]> * remove dotnet-package-update and references --------- Co-authored-by: Genevieve Warren <[email protected]>
1 parent d45e66e commit 3b9cc94

File tree

5 files changed

+94
-0
lines changed

5 files changed

+94
-0
lines changed
Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
title: dotnet workload clean command
3+
description: "The `dotnet workload clean` command removes workload components that might have been left behind from previous updates and uninstallations."
4+
ms.date: 09/29/2025
5+
---
6+
# dotnet workload clean
7+
8+
**This article applies to:** ✔️ .NET 6 SDK and later versions
9+
10+
## Name
11+
12+
`dotnet workload clean` - Removes workload components that might have been left behind from previous updates and uninstallations.
13+
14+
## Synopsis
15+
16+
```dotnetcli
17+
dotnet workload clean [options]
18+
19+
dotnet workload clean -?|-h|--help
20+
```
21+
22+
## Description
23+
24+
The `dotnet workload clean` command removes all workload components that have been uninstalled.
25+
26+
For more information about the `dotnet workload` commands, see the [dotnet workload install](dotnet-workload-install.md#description) command.
27+
28+
## Options
29+
30+
- **--all**
31+
32+
Removes and uninstalls all workload components from all SDK versions. Defaults to `false`.
33+
34+
[!INCLUDE [help](../../../includes/cli-help.md)]
35+
36+
## Examples
37+
38+
- Remove all workflow components:
39+
40+
```dotnetcli
41+
dotnet workload clean --all
42+
```
Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
title: dotnet workload history command
3+
description: "The `dotnet workload history` command shows a history of workload installation actions."
4+
ms.date: 09/29/2025
5+
---
6+
# dotnet workload history
7+
8+
**This article applies to:** ✔️ .NET 6 SDK and later versions
9+
10+
## Name
11+
12+
`dotnet workload history` - Shows a history of workload installation actions.
13+
14+
## Synopsis
15+
16+
```dotnetcli
17+
dotnet workload history [options]
18+
19+
dotnet workload history -?|-h|--help
20+
```
21+
22+
## Description
23+
24+
The `dotnet workload history` shows a history of workload installation actions.
25+
26+
For more information about the `dotnet workload` commands, see the [dotnet workload install](dotnet-workload-install.md#description) command.
27+
28+
## Options
29+
30+
- **--all**
31+
32+
Removes and uninstalls all workload components from all SDK versions. Defaults to `false`.
33+
34+
[!INCLUDE [help](../../../includes/cli-help.md)]
35+
36+
## Examples
37+
38+
- Remove all workflow components:
39+
40+
```dotnetcli
41+
dotnet workload history --all
42+
```

docs/core/tools/dotnet.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -217,9 +217,13 @@ The following options are available only when `dotnet` runs an application by us
217217

218218
| Command | Function |
219219
|---------------------------------------------------------|-----------------------------------------------------|
220+
| [dotnet workload clean](dotnet-workload-clean.md) | Removes workload components. |
221+
| [dotnet workload config](dotnet-workload-config.md) | Enables or disables workload-set update mode. |
222+
| [dotnet workload history](dotnet-workload-history.md) | Shows all workload installation actions. |
220223
| [dotnet workload install](dotnet-workload-install.md) | Installs an optional workload. |
221224
| [dotnet workload list](dotnet-workload-list.md) | Lists all installed workloads. |
222225
| [dotnet workload repair](dotnet-workload-repair.md) | Repairs all installed workloads. |
226+
| [dotnet workload restore](dotnet-workload-restore.md) | Restore workloads required for a project. |
223227
| [dotnet workload search](dotnet-workload-search.md) | List selected workloads or all available workloads. |
224228
| [dotnet workload uninstall](dotnet-workload-install.md) | Uninstalls a workload. |
225229
| [dotnet workload update](dotnet-workload-update.md) | Reinstalls all installed workloads. |

docs/core/tools/index.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,8 +102,10 @@ The following commands are installed by default:
102102
### Workload management commands
103103

104104
- [`workload`](dotnet-workload.md) (Available since .NET 7 SDK)
105+
- [`workload clean`](dotnet-workload-clean.md) (Available since .NET 6 SDK)
105106
- [`workload config`](dotnet-workload-config.md) (Available since .NET 8.0.400 SDK)
106107
- [`workload install`](dotnet-workload-install.md) (Available since .NET 6 SDK)
108+
- [`workload history`](dotnet-workload-history.md) (Available since .NET 6 SDK)
107109
- [`workload list`](dotnet-workload-list.md) (Available since .NET 6 SDK)
108110
- [`workload update`](dotnet-workload-update.md) (Available since .NET 6 SDK)
109111
- [`workload restore`](dotnet-workload-restore.md) (Available since .NET 6 SDK)

docs/navigate/tools-diagnostics/toc.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -243,8 +243,12 @@ items:
243243
href: ../../core/tools/dotnet-workload.md
244244
- name: dotnet workload sets
245245
href: ../../core/tools/dotnet-workload-sets.md
246+
- name: dotnet workload clean
247+
href: ../../core/tools/dotnet-workload-clean.md
246248
- name: dotnet workload config
247249
href: ../../core/tools/dotnet-workload-config.md
250+
- name: dotnet workload history
251+
href: ../../core/tools/dotnet-workload-history.md
248252
- name: dotnet workload install
249253
href: ../../core/tools/dotnet-workload-install.md
250254
- name: dotnet workload list

0 commit comments

Comments
 (0)