Partilhar via


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