comando install (CLI do NuGet)

Aplica-se a: consumo de pacotes • Versões suportadas: todas

Faz download e instala um pacote em um projeto, usando como padrão a pasta atual, e usando as origens especificadas do pacote.

Dica

Para fazer download de um pacote diretamente fora do contexto de um projeto, visite a página do pacote em nuget.org e selecione o link Download.

Se nenhuma origem for especificada, as listadas no arquivo de configuração global, %appdata%\NuGet\NuGet.Config (Windows) ou ~/.nuget/NuGet/NuGet.Config (Mac/Linux), serão usadas. Para uso adicional, confira Configurações comuns do NuGet.

Se nenhum pacote for especificado, install instala todos os pacotes listados no arquivo packages.config do projeto, tornando-o semelhante a restore.

O comando install não modifica um arquivo de projeto nem packages.config; dessa forma, ele é semelhante a restore, pois apenas adiciona pacotes ao disco, mas não altera as dependências de um projeto.

Para adicionar uma dependência, adicione um pacote por meio da interface do usuário do Gerenciador de Pacotes ou do console no Visual Studio, ou modifique packages.config e depois execute install ou restore.

Uso

nuget install <packageID | configFilePath> [options]

em que <packageID> nomeia o pacote a ser instalado (usando a versão mais recente), ou <configFilePath> identifica o arquivo packages.config que lista os pacotes a serem instalados. Você pode indicar uma versão específica com a opção -Version.

Opções

• -ConfigFile

  O arquivo de configuração do NuGet a ser aplicado. Se não for especificado, %AppData%\NuGet\NuGet.Config (Windows), ~/.nuget/NuGet/NuGet.Config ou ~/.config/NuGet/NuGet.Config (Mac/Linux) será usado.

• -DependencyVersion

  (4.4+) 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 alto, principal mais baixo, secundário mais alto
  • Mais alta: a versão mais alta
  • Ignorar: Nenhum pacote de dependência será usado

• -DirectDownload

  Faça o download diretamente sem popular nenhum cache com metadados ou binários.

• -DisableParallelProcessing

  Desativa a instalação de vários pacotes em paralelo.

• -x|-ExcludeVersion

  Instala o pacote em uma pasta nomeada apenas com o nome do pacote e não com o número da versão.

• -FallbackSource

  (3.2+) Uma lista de origens de pacote a serem usadas como fallbacks caso o pacote não seja encontrado na origem primária ou padrão.

• -ForceEnglishOutput

  (3.5 ou superior) Força a execução de nuget.exe usando uma cultura invariável com base em inglês.

• -Framework

  (4.4+) Estrutura de destino usada para selecionar dependências. O padrão será “Qualquer” se não estiver especificado.

• -?|-help

  Exibe as informações de ajuda para o comando.

• -NoHttpCache

  Impede que NuGet use pacotes http armazenados em cache. Confira Como gerenciar pacotes globais e pastas de cache.

• -NonInteractive

  Suprime solicitações de entrada de usuário ou confirmações.

• -OutputDirectory

  Especifica a pasta na qual os pacotes estão instalados. Se nenhuma pasta for especificada, a pasta atual será usada.

• -PackageSaveMode

  Especifica os tipos de arquivos a serem salvos após a instalação do pacote: pode ser nuspec, nupkg ou nuspec;nupkg.

• -PreRelease

  Permite a instalação de pacotes de pré-lançamento. Esse sinalizador não é necessário ao restaurar pacotes com packages.config.

• -RequireConsent

  Verifica se a restauração de pacotes está habilitada antes de fazer o download e instalar os pacotes. Para obter mais detalhes, confira Restauração de pacotes.

• -SolutionDirectory

  Especifica a pasta raiz da solução para a qual restaurar pacotes.

• -Source

  Especifica a lista de origens de pacote (como URLs) a serem usadas. Se omitido, o comando usará as fontes fornecidas nos arquivos de configuração, consulte Configurações comuns do NuGet.

• -Verbosity [normal|quiet|detailed]

  Especifica a quantidade de detalhes exibida na saída: normal (o padrão), quiet ou detailed.

• -Version

  Especifica a versão do pacote a ser instalado.

Confira também Variáveis de ambiente

Exemplos

nuget install elmah

nuget install packages.config

nuget install ninject -OutputDirectory c:\proj