Updatepaket (Paket-Manager-Konsole in Visual Studio)
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:
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