Update-Package (console Gestione pacchetti in Visual Studio)

  • Articolo

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:
  • Minimo (impostazione predefinita): la versione più bassa
  • HighestPatch: la versione con la patch più bassa, secondaria più bassa e più alta
  • HighestMinor: la versione con la patch principale più bassa, secondaria più alta e più alta
  • Massimo (impostazione predefinita per Update-Package senza parametri): la versione più recente
È possibile impostare il valore predefinito usando l'impostazione 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