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, y (3.0+) IgnoreAll. |
| DependencyVersion | La versión de los paquetes de dependencia que se va a usar, que puede ser una de las siguientes:
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