Install-Package (Console do Gerenciador de Pacotes no Visual Studio)
Este tópico descreve o comando no Console do Gerenciador de Pacotes no Visual Studio no Windows. Para obter o comando genérico Install-Package do PowerShell, consulte a referência do PowerShell PackageManagement.
Instala o pacote e suas dependências no projeto.
Sintaxe
Install-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [[-Source] <string>]
[[-Version] <string>] [-IncludePrerelease] [-FileConflictAction] [-DependencyVersion]
[-WhatIf] [<CommonParameters>]
No NuGet 2.8+, Install-Package
pode fazer downgrade de um pacote existente no projeto. Por exemplo, se você tiver o Microsoft.AspNet.MVC 5.1.0-rc1 instalado, o seguinte comando faria downgrade para 5.0.0:
Install-Package Microsoft.AspNet.MVC -Version 5.0.0.
Parâmetros
Parâmetro | Descrição |
---|---|
ID | (Obrigatório) O identificador do pacote a ser instalado. (3.0+) O identificador pode ser um caminho ou URL de um arquivo packages.config ou um arquivo .nupkg . O parâmetro -Id é opcional. |
IgnoreDependencies | Instale somente esse pacote e não suas dependências. |
ProjectName | O projeto no qual instalar o pacote, padrão para o projeto padrão. |
Origem | A URL ou o caminho da pasta para a origem do pacote a ser pesquisada. Os caminhos da pasta local podem ser absolutos ou relativos à pasta atual. Se omitido, Install-Package pesquisa a origem do pacote selecionado no momento. |
Versão | A versão do pacote a ser instalado, assumindo o padrão da última versão. |
IncludePrerelease | Considera pacotes de pré-lançamento para a instalação. Se omitidos, somente pacotes estáveis são considerados. |
FileConflictAction | A ação a ser executada quando solicitado a substituir ou ignorar arquivos existentes referenciados pelo projeto. Os valores possíveis são Overwrite, Ignore, None, OverwriteAll e (3.0+) IgnoreAll. |
DependencyVersion | A versão dos pacotes de dependência a serem usados, que pode ser uma das seguintes:
dependencyVersion no arquivo Nuget.Config . |
WhatIf | Mostra o que aconteceria ao executar o comando sem realmente executar a instalação. |
Nenhum desses parâmetros aceita entrada de pipeline ou caracteres curinga.
Parâmetros comuns
O Install-Package
oferece suporte aos seguintes parâmetros comuns do PowerShell: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction e WarningVariable.
Exemplos
# 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