1dotnet-workload-restore(1)    .NET Documentation    dotnet-workload-restore(1)
2
3
4

dotnet workload restore

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

NAME

9       dotnet-workload-restore  - Installs workloads needed for a project or a
10       solution.
11

SYNOPSIS

13              dotnet workload restore [<PROJECT | SOLUTION>]
14                  [--configfile <FILE>] [--disable-parallel]
15                  [--ignore-failed-sources] [--include-previews] [--interactive]
16                  [--no-cache] [--skip-manifest-update]
17                  [-s|--source <SOURCE>] [--temp-dir <PATH>] [-v|--verbosity <LEVEL>]
18
19              dotnet workload restore -?|-h|--help
20

DESCRIPTION

22       The dotnet workload restore command analyzes a project or  solution  to
23       determine  which  workloads  it needs, then installs any workloads that
24       are missing.
25
26       For more information about the dotnet workload commands, see the dotnet
27       workload install command.
28

ARGUMENTS

30       • PROJECT | SOLUTION
31
32         The  project or solution file to install workloads for.  If a file is
33         not specified, the command searches the current directory for one.
34

OPTIONS

36       • --configfile <FILE>
37
38         The NuGet configuration file (nuget.config) to  use.   If  specified,
39         only the settings from this file will be used.  If not specified, the
40         hierarchy of configuration files from the current directory  will  be
41         used.  For more information, see Common NuGet Configurations.
42
43       • --disable-parallel
44
45         Prevents restoring multiple projects in parallel.
46
47       • -?|-h|--help
48
49         Prints out a description of how to use the command.
50
51       • --ignore-failed-sources
52
53         Treats package source failures as warnings.
54
55       • --include-previews
56
57         Allows prerelease workload manifests.
58
59       • --interactive
60
61         Allows  the  command  to stop and wait for user input or action.  For
62         example, to complete authentication.
63
64       • --no-cache
65
66         Prevents caching of packages and http requests.
67
68       • --skip-manifest-update
69
70         Skip updating the workload manifests.  The workload manifests  define
71         what assets and versions need to be installed for each workload.
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.   For  more  information,  see  <xref:Microsoft.Build.Frame‐
90         work.LoggerVerbosity>.
91
92   Example
93       • Restore workloads needed by MyApp.csproj:
94
95                dotnet workload restore MyApp.csproj
96
97
98
99                                  2022-10-10        dotnet-workload-restore(1)