dotnet workload update

This article applies to: ✔️ .NET 6 Preview SDK and later versions

Name

dotnet workload update - Updates installed workloads.

Synopsis

dotnet workload update
    [--advertising-manifests-only]
    [--configfile <FILE>] [--disable-parallel]
    [--from-previous-sdk] [--ignore-failed-sources]
    [--include-previews] [--interactive] [--no-cache]
    [-s|--source <SOURCE>] [--temp-dir <PATH>]
    [-v|--verbosity <LEVEL>]

dotnet workload update -?|-h|--help

Description

The dotnet workload update command updates all installed workloads to the newest available versions. It queries Nuget.org for updated workload manifests. It then updates local manifests, downloads new versions of the installed workloads, and removes all old versions of each workload.

For more information about the dotnet workload commands, see the dotnet workload install command.

Options

  • --configfile <FILE>

    The NuGet configuration file (nuget.config) to use. If specified, only the settings from this file will be used. If not specified, the hierarchy of configuration files from the current directory will be used. For more information, see Common NuGet Configurations.

  • --disable-parallel

    Prevents restoring multiple projects in parallel.

  • --from-previous-sdk

    Include workloads installed with previous SDK versions in the update.

  • -?|-h|--help

    Prints out a description of how to use the command.

  • --ignore-failed-sources

    Treats package source failures as warnings.

  • --include-previews

    Allows prerelease workload manifests.

  • --interactive

    Allows the command to stop and wait for user input or action. For example, to complete authentication.

  • --no-cache

    Prevents caching of packages and http requests.

  • -s|--source <SOURCE>

    Specifies the URI of the NuGet package source to use. This setting overrides all of the sources specified in the nuget.config files. Multiple sources can be provided by specifying this option multiple times.

  • --temp-dir <PATH>

    Specify the temporary directory used to download and extract NuGet packages (must be secure).

  • -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 minimal. If you specify specify detailed or diagnostic verbosity, the command displays information about the Nuget packages that it downloads.

Examples

  • Update the installed workloads:

    dotnet workload update
    
  • Download the assets needed for updating installed workloads to a cache located in the workload-cache directory under the current directory. Then update installed workloads from that cache location:

    dotnet workload update --download-to-cache ./workload-cache
    dotnet workload update --from-cache ./workload-cache