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:
  • Lowest (padrão): a versão mais baixa
  • HighestPatch: a versão com o patch mais baixo maior, mais baixo maior, mais alto
  • HighestMinor: a versão com o patch mais baixo maior, mais alto menor, mais alto
  • Highest (padrão para Update-Package sem parâmetros): a versão mais alta
É possível definir o valor padrão usando a configuração 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