update 命令 （NuGet CLI）

  • 發行項

適用於： 套件耗用量 • 支援的版本： 全部

將專案中的所有套件 (使用 packages.config) 更新為最新可用版本。 建議您在執行 之前先執行 『restore』。update （若要更新個別套件，請使用 nuget install 但不指定版本號碼，在此情況下，NuGet 會安裝最新版本。

注意： update 不適用於在Mono下執行的 CLI（Mac OSX 或Linux），或使用 PackageReference 格式時。

命令 update 也會更新項目檔中的元件參考，前提是這些參考已經存在。 如果更新的套件有已新增的元件，則 不會 新增新的參考。 新的套件相依性也不會新增其元件參考。 若要在更新中包含這些作業，請使用 封裝管理員 UI 或 封裝管理員 控制台，在 Visual Studio 中更新套件。

此命令也可以用來使用 -self 旗標更新nuget.exe本身。

使用方式

nuget update <configPath> [options]

其中 <configPath> 會 packages.config 識別列出專案相依性的 或方案檔。

選項。

  • -ConfigFile

    要套用的 NuGet 組態檔。 如果未指定， %AppData%\NuGet\NuGet.Config 則會使用 （Windows） 或 ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config （Mac/Linux）。

  • -DependencyVersion [Lowest, HighestPatch, HighestMinor, Highest, Ignore]

    指定要使用的相依性套件版本，可以是下列其中一項：

    • 最低 （預設值）：最低版本
    • HighestPatch：具有最低主要、最低次要、最高修補程式的版本
    • HighestMinor：具有最低主要、最高次要、最高修補程式的版本
    • 最高：最高版本
    • 忽略：不會使用任何相依性套件

  • -FileConflictAction [PromptUser, Overwrite, Ignore]

    當目標專案中已有來自封裝的檔案時，指定預設動作。 設定為 Overwrite 以一律覆寫檔案。 設定為 Ignore 以略過檔案。

    PromptUser除非提供 或 IgnoreAll ，否則OverwriteAll動作會提示每個衝突的檔案，這會套用至所有剩餘的檔案。

  • -ForceEnglishOutput

    （3.5+） 強制nuget.exe使用非變異的英文文化特性來執行。

  • -?|-help

    顯示命令的說明資訊。

  • -Id

    指定要更新的套件識別碼清單。

  • -MSBuildPath

    （4.0+） 指定要與 指令搭配使用的 MSBuild 路徑，其優先順序高於 -MSBuildVersion。

  • -MSBuildVersion

    （3.2+） 指定要與此命令搭配使用的 MSBuild 版本。 支援的值為 4、12、14、15.1、15.3、15.4、15.5、15.6、15.7、15.8、15.9。 根據預設，會挑選路徑中的 MSBuild，否則會預設為最高安裝的 MSBuild 版本。

  • -NonInteractive

    隱藏使用者輸入或確認的提示。

  • -PreRelease

    允許更新至發行前版本。 更新已安裝的發行前版本套件時，不需要此旗標。

  • -RepositoryPath

    指定安裝套件的本機資料夾。

  • -Safe

    指定只會安裝與已安裝套件相同的主要和次要版本內，具有最高版本可用的更新。

  • -Self

    nuget.exe 更新 至最新版本。 -Source 不過，可以忽略所有其他自變數。 如果未提供任何來源，則不論設定為何NuGet.Config，都會檢查nuget.org更新。

  • -Source

    指定要用於更新的套件來源清單（作為URL）。 如果省略，命令會使用組態檔中提供的來源，請參閱 一般 NuGet 組態。

  • -Verbosity [normal|quiet|detailed]

    指定輸出中顯示的詳細資料量： normal （預設值）， quiet或 detailed。

  • -Version

    搭配一個套件識別碼使用時，指定要更新的套件版本。

另請參閱 環境變數

範例

nuget update

# update packages installed in solution.sln, using MSBuild version 14.0 to load the solution and its project(s).
nuget update solution.sln -MSBuildVersion 14

nuget update -safe

nuget update -self