Install-Package (Consola del Administrador de paquetes en Visual Studio)

En este tema se describe el comando dentro de la consola del Administrador de paquetes en Visual Studio en Windows. Para obtener el comando Install-Package genérico de PowerShell, vea la Referencia de packageManagement de PowerShell.

Instala un paquete y sus dependencias en un proyecto.

Sintaxis

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

En NuGet 2.8 y versiones posteriores, Install-Package puede cambiar a una versión posterior un paquete existente en el proyecto. Por ejemplo, si tiene instalado Microsoft.AspNet.MVC 5.1.0-rc1, el siguiente comando cambiaría la versión a 5.0.0:

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

Parámetros

Parámetro Descripción
Identificador (Obligatorio) Identificador del paquete que se va a instalar. (3.0+) El identificador puede ser una ruta de acceso o una dirección URL de un archivo packages.config o .nupkg. El modificador -Id es opcional.
IgnoreDependencies Se instala solo el paquete y no sus dependencias.
ProjectName Proyecto en el que se va a instalar el paquete; de forma predeterminada es el proyecto predeterminado.
Source URL o ruta de acceso de la carpeta del origen del paquete que se va a buscar. Las rutas de acceso pueden ser absolutas o relativas a la carpeta actual. Si se omite, Install-Package busca en el origen del paquete seleccionado actualmente.
Versión Versión del paquete que se va a instalar, de forma predeterminada es la versión más reciente.
IncludePrerelease Considera los paquetes de versión preliminar para la instalación. Si se omite, solo se tienen en cuenta los paquetes estables.
FileConflictAction La acción que se realizará cuando se le pida que sobrescriba u omita los archivos existentes a los que hace referencia el proyecto. Los valores posibles son Overwrite, Ignore, None, OverwriteAll e (3.0+)IgnoreAll.
DependencyVersion La versión de los paquetes de dependencia que se va a usar, que puede ser una de las siguientes:
  • Lowest (valor predeterminado): la versión más baja
  • HighestPatch: la versión con la revisión principal más baja, la secundaria más baja y la revisión más alta
  • HighestMinor: la versión con la revisión principal más baja, la secundaria más alta y la más alta
  • Highest (valor predeterminado para Update-Package sin parámetros): la versión más alta
Puede establecer el valor predeterminado mediante el valor dependencyVersion del archivo Nuget.Config.
WhatIf Muestra lo que sucedería al ejecutar el comando sin realizar realmente la instalación.

Ninguno de estos parámetros acepta caracteres comodín ni entrada de canalización.

Parámetros comunes

Install-Package admite los siguientes parámetros comunes de PowerShell: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction y WarningVariable.

Ejemplos

# 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