Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
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
54 changes: 54 additions & 0 deletions docs/core/tools/dotnet-package-update.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
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 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.

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

- **`-v|--verbosity <LEVEL>`**

Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. The default is `normal`.

[!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
```
42 changes: 42 additions & 0 deletions docs/core/tools/dotnet-workload-clean.md
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."
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.

## 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
```
42 changes: 42 additions & 0 deletions docs/core/tools/dotnet-workload-history.md
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
```
5 changes: 5 additions & 0 deletions docs/core/tools/dotnet.md
Original file line number Diff line number Diff line change
Expand Up @@ -198,6 +198,7 @@ The following options are available only when `dotnet` runs an application by us
| [dotnet package list](dotnet-package-list.md) | Lists NuGet packages. |
| [dotnet package remove](dotnet-package-remove.md) | Removes a NuGet package. |
| [dotnet package search](dotnet-package-search.md) | Searches for a NuGet package. |
| [dotnet package update](dotnet-package-update.md) | Updates a NuGet package. |

### NuGet commands

Expand All @@ -217,9 +218,13 @@ The following options are available only when `dotnet` runs an application by us

| Command | Function |
|---------------------------------------------------------|-----------------------------------------------------|
| [dotnet workload clean](dotnet-workload-clean.md) | Removes workload components. |
| [dotnet workload config](dotnet-workload-config.md) | Enables or disables workload-set update mode. |
| [dotnet workload history](dotnet-workload-history.md) | Shows all workload installation actions. |
| [dotnet workload install](dotnet-workload-install.md) | Installs an optional workload. |
| [dotnet workload list](dotnet-workload-list.md) | Lists all installed workloads. |
| [dotnet workload repair](dotnet-workload-repair.md) | Repairs all installed workloads. |
| [dotnet workload restore](dotnet-workload-restore.md) | Restore workloads required for a project. |
| [dotnet workload search](dotnet-workload-search.md) | List selected workloads or all available workloads. |
| [dotnet workload uninstall](dotnet-workload-install.md) | Uninstalls a workload. |
| [dotnet workload update](dotnet-workload-update.md) | Reinstalls all installed workloads. |
Expand Down
2 changes: 2 additions & 0 deletions docs/core/tools/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,8 +102,10 @@ The following commands are installed by default:
### Workload management commands

- [`workload`](dotnet-workload.md) (Available since .NET 7 SDK)
- [`workload clean`](dotnet-workload-clean.md) (Available since .NET 6 SDK)
- [`workload config`](dotnet-workload-config.md) (Available since .NET 8.0.400 SDK)
- [`workload install`](dotnet-workload-install.md) (Available since .NET 6 SDK)
- [`workload history`](dotnet-workload-history.md) (Available since .NET 6 SDK)
- [`workload list`](dotnet-workload-list.md) (Available since .NET 6 SDK)
- [`workload update`](dotnet-workload-update.md) (Available since .NET 6 SDK)
- [`workload restore`](dotnet-workload-restore.md) (Available since .NET 6 SDK)
Expand Down
6 changes: 6 additions & 0 deletions docs/navigate/tools-diagnostics/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -190,6 +190,8 @@ items:
href: ../../core/tools/dotnet-package-remove.md
- name: dotnet package search
href: ../../core/tools/dotnet-package-search.md
- name: dotnet package update
href: ../../core/tools/dotnet-package-update.md
- name: dotnet publish
href: ../../core/tools/dotnet-publish.md
- name: dotnet reference add/list/remove
Expand Down Expand Up @@ -239,8 +241,12 @@ items:
href: ../../core/tools/dotnet-workload.md
- name: dotnet workload sets
href: ../../core/tools/dotnet-workload-sets.md
- name: dotnet workload clean
href: ../../core/tools/dotnet-workload-clean.md
- name: dotnet workload config
href: ../../core/tools/dotnet-workload-config.md
- name: dotnet workload history
href: ../../core/tools/dotnet-workload-history.md
- name: dotnet workload install
href: ../../core/tools/dotnet-workload-install.md
- name: dotnet workload list
Expand Down