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