dotnet workload restore

本文适用于:✔️ .NET 6 SDK 及更高版本

名称

dotnet workload restore - 安装项目或解决方案所需的工作负载。

摘要

dotnet workload restore [<PROJECT | SOLUTION>]
    [--configfile <FILE>] [--disable-parallel]
    [--ignore-failed-sources] [--include-previews] [--interactive]
    [--no-cache] [--skip-manifest-update] [-s|--source <SOURCE>] 
    [--temp-dir <PATH>] [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet workload restore -?|-h|--help

说明

dotnet workload restore 命令会分析项目或解决方案,来确定其所需的工作负载,然后安装所有缺少的工作负载。

有关 dotnet workload 命令的详细信息,请参阅 dotnet workload install 命令。

参数

  • PROJECT | SOLUTION

    要为其安装工作负载的项目或解决方案文件。 如果未指定文件,则该命令会在当前目录中搜索一个文件。

选项

  • --configfile <FILE>

    要使用的 NuGet 配置文件 (nuget.config)。 如果指定,则只使用此文件中的设置。 如果不指定,将使用当前目录中的配置文件的层次结构。 有关详细信息,请参阅常见的 NuGet 配置

  • --disable-parallel

    阻止并行还原多个项目。

  • -?|-h|--help

    打印出有关如何使用命令的说明。

  • --ignore-failed-sources

    将包源失败视为警告。

  • --include-previews

    允许预发布工作负载清单。

  • --interactive

    允许命令停止并等待用户输入或操作。 例如,完成身份验证。

  • --no-cache

    阻止缓存包和 http 请求。

  • --skip-manifest-update

    跳过更新工作负载清单。 工作负载清单定义需要为每个工作负载安装的资产和版本。

  • -s|--source <SOURCE>

    指定要使用的 NuGet 包源的 URI。 此设置会替代 nuget.config 文件中指定的所有源。 多次指定此选项可以提供多个源。

  • --temp-dir <PATH>

    指定用于下载和提取 NuGet 包的临时目录(必须是安全的)。

  • -v|--verbosity <LEVEL>

    设置命令的详细级别。 允许使用的值为 q[uiet]m[inimal]n[ormal]d[etailed]diag[nostic]。 默认值为 minimal。 有关详细信息,请参阅 LoggerVerbosity

  • --version

    要安装或更新到的工作负荷集版本。 如果在global.json中指定工作负荷集版本,则无法使用 --version 此选项来指定工作负荷集版本。 若要在这种情况下使用 --version 该选项,请在包含global.json文件的路径外部运行命令。 自 8.0.400 SDK 起可用。 有关详细信息,请参阅 .NET SDK 工作负荷集

示例

  • 还原 MyApp.csproj 所需的工作负载:

    dotnet workload restore MyApp.csproj