Balíček aktualizace (konzola Správce balíčků v sadě Visual Studio)
K dispozici pouze v konzole NuGet Správce balíčků v sadě Visual Studio ve Windows.
Aktualizace balíček a jeho závislosti nebo všechny balíčky v projektu na novější verzi.
Syntaxe
Update-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [-Version <string>]
[-Safe] [-Source <string>] [-IncludePrerelease] [-Reinstall] [-FileConflictAction]
[-DependencyVersion] [-ToHighestPatch] [-ToHighestMinor] [-WhatIf] [<CommonParameters>]
V NuGetu 2.8 nebo novějších Update-Package je možné použít k downgradu existujícího balíčku v projektu. Pokud máte například nainstalovaný Microsoft.AspNet.MVC 5.1.0-rc1, následující příkaz by ho downgradoval na 5.0.0:
Update-Package Microsoft.AspNet.MVC -Version 5.0.0.
Parametry
| Parametr | Popis |
|---|---|
| Id | Identifikátor balíčku, který se má aktualizovat. Pokud tento parametr vynecháte, aktualizuje všechny balíčky. Samotný přepínač -ID je volitelný. |
| IgnoreDependencies | Přeskočí aktualizaci závislostí balíčku. |
| Název projektu | Název projektu obsahujícího balíčky, které se mají aktualizovat, ve výchozím nastavení pro všechny projekty. |
| Verze | Verze, která se má použít pro upgrade, výchozí na nejnovější verzi. V NuGetu 3.0+ musí být hodnota verze jedna z Nejnižší, Nejvyšší, Nejvyšší, NejvyššíMinor nebo HighestPatch (ekvivalentní hodnotě -Sejf). |
| Safe | Omezuje upgrady pouze na verze se stejnou hlavní a podverzí jako aktuálně nainstalovaný balíček. |
| Source | Adresa URL nebo cesta ke složce zdroje balíčku, která se má prohledávat. Cesty k místní složce můžou být absolutní nebo relativní vzhledem k aktuální složce. Pokud tento parametr vynecháte, Update-Package vyhledá aktuálně vybraný zdroj balíčku. |
| IncludePrerelease | Obsahuje předběžné balíčky pro aktualizace. |
| Přeinstalovat | Balíčky pryskyřice využívající jejich aktuálně nainstalované verze. Viz Přeinstalace a aktualizace balíčků. |
| FileConflictAction | Akce, která se má provést, když se zobrazí výzva k přepsání nebo ignorování existujících souborů odkazovaných projektem. Možné hodnoty jsou Přepsání, Ignore, None, OverwriteAll a IgnoreAll (3.0+). |
| DependencyVersion | Verze balíčků závislostí, které se mají použít, což může být jedna z následujících možností:
dependencyVersion nastavení v Nuget.Config souboru. |
| ToHighestPatch | ekvivalentní -Sejf. |
| ToHighestMinor | Omezuje upgrady pouze na verze se stejnou hlavní verzí jako aktuálně nainstalovaný balíček. |
| WhatIf | Ukazuje, co by se stalo při spuštění příkazu bez skutečného provedení aktualizace. |
Žádný z těchto parametrů nepřijímá vstup kanálu nebo zástupné znaky.
Běžné parametry
Update-Package podporuje následující běžné parametry PowerShellu: Ladění, Akce chyby, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction a WarningVariable.
Příklady
# Updates all packages in every project of the solution
Update-Package
# Updates every package in the MvcApplication1 project
Update-Package -ProjectName MvcApplication1
# Updates the Elmah package in every project to the latest version
Update-Package Elmah
# Updates the Elmah package to version 1.1.0 in every project showing optional -Id usage
Update-Package -Id Elmah -Version 1.1.0
# Updates the Elmah package within the MvcApplication1 project to the highest "safe" version.
# For example, if Elmah version 1.0.0 of a package is installed, and versions 1.0.1, 1.0.2,
# and 1.1 are available in the feed, the -Safe parameter updates the package to 1.0.2 instead
# of 1.1 as it would otherwise.
Update-Package Elmah -ProjectName MvcApplication1 -Safe
# Reinstall the same version of the original package, but with the latest version of dependencies
# (subject to version constraints). If this command rolls a dependency back to an earlier version,
# use Update-Package <dependency_name> to reinstall that one dependency without affecting the
# dependent package.
Update-Package Elmah –reinstall
# Reinstall the Elmah package in just MyProject
Update-Package Elmah -ProjectName MyProject -reinstall
# Reinstall the same version of the original package without touching dependencies.
Update-Package Elmah –reinstall -ignoreDependencies