分享方式:


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 (預設值), quietdetailed

  • -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