Balíček aktualizace (konzola Správce balíčků v sadě Visual Studio)

  • Článek

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í:
  • Nejnižší (výchozí): nejnižší verze
  • HighestPatch: verze s nejnižším hlavním, nejnižším podverzem, nejvyšší opravou
  • HighestMinor: verze s nejnižší hlavní, nejvyšší podverze, nejvyšší oprava
  • Nejvyšší (výchozí hodnota pro Update-Package bez parametrů): nejvyšší verze
Výchozí hodnotu můžete nastavit pomocí 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