Update-Package (console Gestione pacchetti in Visual Studio)
Disponibile solo all'interno della console di Gestione pacchetti NuGet in Visual Studio in Windows.
Aggiornamenti un pacchetto e le relative dipendenze, o tutti i pacchetti in un progetto, a una versione più recente.
Sintassi
Update-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [-Version <string>]
[-Safe] [-Source <string>] [-IncludePrerelease] [-Reinstall] [-FileConflictAction]
[-DependencyVersion] [-ToHighestPatch] [-ToHighestMinor] [-WhatIf] [<CommonParameters>]
In NuGet 2.8+, Update-Package può essere usato per effettuare il downgrade di un pacchetto esistente nel progetto. Ad esempio, se è installato Microsoft.AspNet.MVC 5.1.0-rc1, il comando seguente eseguirà il downgrade a 5.0.0:
Update-Package Microsoft.AspNet.MVC -Version 5.0.0.
Parametri
| Parametro | Descrizione |
|---|---|
| ID | Identificatore del pacchetto da aggiornare. Se omesso, aggiorna tutti i pacchetti. L'opzione -Id è facoltativa. |
| IgnoreDependencies | Ignora l'aggiornamento delle dipendenze del pacchetto. |
| Nome progetto | Nome del progetto contenente i pacchetti da aggiornare, per impostazione predefinita per tutti i progetti. |
| Versione | Versione da usare per l'aggiornamento, che per impostazione predefinita è la versione più recente. In NuGet 3.0+, il valore della versione deve essere uno dei valori Più bassi, Massimo, HighestMinor o HighestPatch (equivalente a -Cassaforte). |
| Safe | Vincola gli aggiornamenti solo alle versioni con la stessa versione principale e secondaria del pacchetto attualmente installato. |
| Origine | URL o percorso della cartella per l'origine del pacchetto da cercare. I percorsi delle cartelle locali possono essere assoluti o relativi alla cartella corrente. Se omesso, Update-Package cerca l'origine del pacchetto attualmente selezionata. |
| IncludePrerelease | Include pacchetti non definitive per gli aggiornamenti. |
| Reinstallazione | Pacchetti resintalli che utilizzano le versioni attualmente installate. Vedere Reinstallazione e aggiornamento di pacchetti. |
| FileConflictAction | Azione da eseguire quando viene chiesto di sovrascrivere o ignorare i file esistenti a cui fa riferimento il progetto. I valori possibili sono Overwrite, Ignore, None, OverwriteAll e IgnoreAll (3.0+). |
| DependencyVersion | Versione dei pacchetti di dipendenza da usare, che può essere una delle seguenti:
dependencyVersion nel Nuget.Config file. |
| ToHighestPatch | equivalente a -Cassaforte. |
| ToHighestMinor | Vincola gli aggiornamenti solo alle versioni con la stessa versione principale del pacchetto attualmente installato. |
| Whatif | Mostra cosa accadrebbe quando si esegue il comando senza eseguire effettivamente l'aggiornamento. |
Nessuno di questi parametri accetta caratteri jolly o input della pipeline.
Parametri comuni
Update-Package supporta i seguenti parametri comuni di PowerShell: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction e WarningVariable.
Esempi
# 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