通过

dotnet workload update

  • 项目

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

名称

dotnet workload update - 更新已安装的工作负载。

摘要

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

说明

dotnet workload update 命令会将所有已安装的工作负载更新到最新可用版本。 针对已更新的工作负载清单查询 Nuget.org。 随后更新本地清单，下载已安装的工作负载的新版本，然后删除每个工作负载的所有旧版本。

当命令处于 workload-set 更新模式时，工作负载会根据工作负荷集版本更新，而不是每个单个工作负荷的最新版本。 有关详细信息，请参阅 .NET SDK 工作负荷集。 workload-set 模式自 8.0.400 SDK 起可用。

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

选项

  • --advertising-manifests-only

    下载播发清单，但不更新任何工作负载。

  • --configfile <FILE>

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

  • --disable-parallel

    阻止并行还原多个项目。

  • --from-previous-sdk

    在更新中包含随以前的 SDK 版本一起安装的工作负载。

  • -?|-h|--help

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

  • --ignore-failed-sources

    将包源失败视为警告。

  • --include-previews

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

  • --interactive

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

  • --no-cache

    阻止缓存包和 http 请求。

  • -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。 如果指定 detailed 或 diagnostic 详细程度，该命令将显示有关它下载的 Nuget 包的信息。

  • --version

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

示例

  • 将已安装的工作负荷更新到每个单个工作负荷的最新版本：

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

  • 将已安装的工作负载更新到最新的工作负荷集版本：

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