共用方式為

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