dotnet workload update

       This article applies to: ✔️ .NET 6 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>] [--version]

              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  ver‐
       sions of the installed workloads, and removes all old versions of each workload.

       When the command is in workload-set update mode, workloads are updated according to the workload-set ver‐
       sion,  not  the  latest version of each individual workload.  For more information, see .NET SDK workload
       sets.  workload-set mode is available since 8.0.400 SDK.

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

OPTIONS

       • --advertising-manifests-only

         Downloads advertising manifests but doesn’t update any workloads.

       • --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 speci‐
         fied 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 detailed or diagnostic verbosity,  the  com‐
         mand displays information about the Nuget packages that it downloads.

       • --version

         The  workload  set  version  to install or update to.  If you specify the workload-set version in glob‐
         al.json, you can’t use the --version option to specify the workload-set version.  To make  it  possible
         to  use  the  --version  option  in that case, run the command outside of the path containing the glob‐
         al.json file.  Available since 8.0.400 SDK.  For more information, see .NET SDK workload sets.

EXAMPLES

       • Update the installed workloads to the latest version of each individual workload:

                dotnet workload config --update-mode manifests
                dotnet workload update

       • Update the installed workloads to the latest workload set version:

                dotnet workload config --update-mode workload-set
                dotnet workload update

                                                   2024-10-02                          dotnet-workload-update(1)