1(1)                                  .NET                                  (1)
2
3
4

dotnet workload update

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

NAME

9       dotnet workload update - Updates installed workloads.
10

SYNOPSIS

12              dotnet workload update
13                  [--advertising-manifests-only]
14                  [--configfile <FILE>] [--disable-parallel]
15                  [--from-previous-sdk] [--ignore-failed-sources]
16                  [--include-previews] [--interactive] [--no-cache]
17                  [-s|--source <SOURCE>] [--temp-dir <PATH>]
18                  [-v|--verbosity <LEVEL>]
19
20              dotnet workload update -?|-h|--help
21

DESCRIPTION

23       The  dotnet  workload update command updates all installed workloads to
24       the newest available versions.  It queries Nuget.org for updated  work‐
25       load  manifests.   It  then updates local manifests, downloads new ver‐
26       sions of the installed workloads, and removes all old versions of  each
27       workload.
28
29       For more information about the dotnet workload commands, see the dotnet
30       workload install command.
31

OPTIONS

33       • --advertising-manifests-only
34
35         Downloads advertising manifests but doesn’t update any workloads.
36
37       • --configfile <FILE>
38
39         The NuGet configuration file (nuget.config) to  use.   If  specified,
40         only the settings from this file will be used.  If not specified, the
41         hierarchy of configuration files from the current directory  will  be
42         used.  For more information, see Common NuGet Configurations.
43
44       • --disable-parallel
45
46         Prevents restoring multiple projects in parallel.
47
48       • --from-previous-sdk
49
50         Include workloads installed with previous SDK versions in the update.
51
52       • -?|-h|--help
53
54         Prints out a description of how to use the command.
55
56       • --ignore-failed-sources
57
58         Treats package source failures as warnings.
59
60       • --include-previews
61
62         Allows prerelease workload manifests.
63
64       • --interactive
65
66         Allows  the  command  to stop and wait for user input or action.  For
67         example, to complete authentication.
68
69       • --no-cache
70
71         Prevents caching of packages and http requests.
72
73       • -s|--source <SOURCE>
74
75         Specifies the URI of the NuGet package source to use.   This  setting
76         overrides  all  of  the  sources specified in the nuget.config files.
77         Multiple sources can be provided by specifying this  option  multiple
78         times.
79
80       • --temp-dir <PATH>
81
82         Specify  the  temporary  directory used to download and extract NuGet
83         packages (must be secure).
84
85       • -v|--verbosity <LEVEL>
86
87         Sets the verbosity level of the command.  Allowed values are q[uiet],
88         m[inimal],  n[ormal],  d[etailed],  and diag[nostic].  The default is
89         minimal.  If you specify specify detailed  or  diagnostic  verbosity,
90         the  command  displays  information  about the Nuget packages that it
91         downloads.
92

EXAMPLES

94       • Update the installed workloads:
95
96                dotnet workload update
97
98       • Download the assets needed for  updating  installed  workloads  to  a
99         cache  located  in the workload-cache directory under the current di‐
100         rectory.  Then update installed workloads from that cache location:
101
102                dotnet workload update --download-to-cache ./workload-cache
103                dotnet workload update --from-cache ./workload-cache
104
105
106
107                                                                           (1)