Updatepaket (Paket-Manager-Konsole in Visual Studio)

  • Artikel

Nur in der NuGet-Paket-Manager-Konsole in Visual Studio unter Windows verfügbar.

Aktualisiert ein Paket und seine Abhängigkeiten oder alle Pakete in einem Projekt auf eine neuere Version.

Syntax

Update-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [-Version <string>]
    [-Safe] [-Source <string>] [-IncludePrerelease] [-Reinstall] [-FileConflictAction]
    [-DependencyVersion] [-ToHighestPatch] [-ToHighestMinor] [-WhatIf] [<CommonParameters>]

In NuGet 2.8+ kann Update-Package zum Downgrade eines vorhandenen Pakets in Ihrem Projekt verwendet werden. Wenn Sie beispielsweise Microsoft.AspNet.MVC 5.1.0-rc1 installiert haben, würde der folgende Befehl es auf 5.0.0 herabstufen:

Update-Package Microsoft.AspNet.MVC -Version 5.0.0.

Parameter

Parameter Beschreibung
Id Der Paketbezeichner des Typs zu aktualisieren. Wenn diese Angabe weggelassen wird, werden alle Pakete aktualisiert. Ein ID-Erstwert selbst ist optional.
Abhängigkeiten ignorieren (IgnoreDependencies) Überspringt das Update der Abhängigkeiten des Pakets.
Projektname Der Name des Projekts, das die zu aktualisierenden Pakete enthält, wobei standardmäßig alle Projekte verwendet werden.
Version Die Version, die für das Upgrade verwendet werden soll und standardmäßig auf die neueste Version festgelegt ist. In NuGet 3.0+ muss der Versionswert eine der Werte Niedrigster, Highest, HighestMinor oder HighestPatch sein (entspricht -Tresor).
Safe Beschränkt Upgrades nur auf Versionen mit derselben Haupt- und Nebenversion wie das aktuell installierte Paket.
Quelle Die URL oder der Ordnerpfad für die zu durchsuchende Paketquelle. Lokale Ordnerpfade können absolut oder relativ zum aktuellen Ordner sein. Wenn sie weggelassen werden, durchsucht Update-Package die aktuell ausgewählte Paketquelle.
Vorabversion einbeziehen (IncludePrerelease) Enthält Vorabversionen von Paketen für Updates.
Neuinstallation Reinstalliert Pakete mit ihren aktuell installierten Versionen. Informationen dazu finden Sie unter Neuinstallieren und Aktualisieren von Paketen.
Dateikonflikt-Aktion (FileConflictAction) Die Aktion, die ausgeführt werden soll, wenn Sie aufgefordert werden, vorhandene Dateien, auf die das Projekt verweist, zu überschreiben oder zu ignorieren. Mögliche Werte sind Overwrite, Ignore, None, OverwriteAll und IgnoreAll (3,0+).
Abhängigkeitsversion (DependencyVersion) Die Version der zu verwendenden Abhängigkeitspakete, die eine der folgenden sein kann:
  • Niedrigste (Standard): die niedrigste Version
  • HighestPatch: die Version mit dem niedrigsten Maximum, dem niedrigsten Minimum und dem höchsten Patch
  • HighestMinor: die Version mit dem niedrigsten Maximum, dem höchsten Minimum und dem höchsten Patch
  • Highest (Standardwert für das Update-Paket ohne Parameter): die höchste Version
Sie können den Standardwert über die dependencyVersion-Einstellung in der Nuget.Config-Datei festlegen.
ToHighestPatch Entspricht -Tresor
ToHighestMinor Beschränkt Upgrades nur auf Versionen mit derselben Hauptversion wie das aktuell installierte Paket.
WhatIf Zeigt, was passiert, wenn der Befehl ausgeführt wird, ohne das Update tatsächlich auszuführen.

Keiner dieser Parameter akzeptiert Pipeline-Eingaben oder Platzhalterzeichen.

Allgemeine Parameter

Update-Package unterstützt die folgenden gängigen PowerShell-Parameter: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction und WarningVariable.

Beispiele

# 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