Install-Package (console Gestione pacchetti in Visual Studio)

Questo argomento descrive il comando all'interno della console Gestione pacchetti in Visual Studio in Windows. Per il comando generico Install-Package di PowerShell, vedere le informazioni di riferimento su PowerShell PackageManagement.

Installa un pacchetto e le relative dipendenze in un progetto.

Sintassi

Install-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [[-Source] <string>] 
    [[-Version] <string>] [-IncludePrerelease] [-FileConflictAction] [-DependencyVersion]
    [-WhatIf] [<CommonParameters>]

In NuGet 2.8+, Install-Package è possibile 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:

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

Parametri

Parametro Descrizione
Id (Obbligatorio) Identificatore del pacchetto da installare. (3.0+) L'identificatore può essere un percorso o un URL di un packages.config file o di un .nupkg file. L'opzione -Id è facoltativa.
IgnoreDependencies Installare solo questo pacchetto e non le relative dipendenze.
Nome progetto Progetto in cui installare il pacchetto, per impostazione predefinita il progetto predefinito.
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, Install-Package cerca l'origine del pacchetto attualmente selezionata.
Versione Versione del pacchetto da installare, che per impostazione predefinita è la versione più recente.
IncludePrerelease Considera i pacchetti non definitive per l'installazione. Se omesso, vengono considerati solo i pacchetti stabili.
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 (3.0+) IgnoreAll.
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.
Whatif Mostra cosa accadrebbe quando si esegue il comando senza eseguire effettivamente l'installazione.

Nessuno di questi parametri accetta caratteri jolly o input della pipeline.

Parametri comuni

Install-Package supporta i seguenti parametri comuni di PowerShell: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction e WarningVariable.

Esempi

# Installs the latest version of Elmah from the current source into the default project
Install-Package Elmah

# Installs Glimpse 1.0.0 into the MvcApplication1 project
Install-Package Glimpse -Version 1.0.0 -Project MvcApplication1

# Installs Ninject.Mvc3 but not its dependencies from c:\temp\packages
Install-Package Ninject.Mvc3 -IgnoreDependencies -Source c:\temp\packages

# Installs the package listed on the online packages.config into the current project
# Note: the URL must end with "packages.config"
Install-Package https://raw.githubusercontent.com/linked-data-dotnet/json-ld.net/master/.nuget/packages.config

# Installs jquery 1.10.2 package, using the .nupkg file under local path of c:\temp\packages
Install-Package c:\temp\packages\jQuery.1.10.2.nupkg

# Installs the specific online package
# Note: the URL must end with ".nupkg"
Install-Package https://globalcdn.nuget.org/packages/microsoft.aspnet.mvc.5.2.3.nupkg