Compartilhar via

Referência da CLI do NuGet

A CLI (Interface de Linha de Comando) nuget.exedo NuGet fornece toda a extensão da funcionalidade do NuGet para instalar, criar, publicar e gerenciar pacotes sem fazer nenhuma alteração nos arquivos de projeto.

Para usar qualquer comando, abra uma janela de comando ou shell bash e execute nuget seguido pelo comando e as opções apropriadas, como nuget help pack (para exibir a ajuda no comando do pacote).

Esta documentação reflete a versão mais recente da CLI do NuGet. Para obter detalhes exatos de qualquer versão que você esteja usando, execute nuget help o comando desejado.

Para saber como usar comandos básicos com a nuget.exe CLI, consulte Instalar e usar pacotes usando a CLI nuget.exe.

Instalando nuget.exe

Sempre instale a versão mais recente da ferramenta que dá suporte à sua configuração.

Se a nuget.exe ferramenta da CLI já estiver instalada, você poderá atualizar a ferramenta para a versão mais recente usando o comando nuget update -self.

  1. Baixar nuget.exe:

  2. Quando solicitado, salve o arquivo em uma pasta de sua escolha. O arquivo nuget.exe é baixado diretamente. O arquivo baixado não é um instalador, portanto, não é necessário executar o arquivo diretamente do navegador.

  3. Para usar a ferramenta da CLI de qualquer pasta, adicione a pasta que contém o arquivo nuget.exe à variável de PATH ambiente.

Dica

Para disponibilizar a CLI do NuGet no Console Gerenciador de Pacotes em Visual Studio, consulte O uso da CLI do nuget.exe no console.

Disponibilidade

Consulte a disponibilidade do recurso para obter detalhes exatos.

  • Todos os comandos estão disponíveis no Windows.
  • Todos os comandos funcionam com nuget.exe em execução no Mono, exceto quando indicado para pack, restoree update.
  • Os packcomandos , restore, deletelocalse push também estão disponíveis no Mac e no Linux por meio da CLI do dotnet.

Comandos e aplicabilidade

Comandos disponíveis e aplicabilidade para criação de pacotes, consumo de pacotes e/ou publicação de um pacote em um host:

Comandos comuns Funções aplicáveis Versão do NuGet Descrição
pacote Criação 2.7+ Cria um pacote NuGet de um .nuspec arquivo ou de projeto. Ao executar no Mono, não há suporte para a criação de um pacote a partir de um arquivo de projeto.
push Publicação Todos Publica um pacote em uma fonte de pacote.
configuração Todos Todos Obtém ou define valores de configuração do NuGet.
ajuda ou? Todos Todos Exibe informações de ajuda ou ajuda para um comando.
Locais Consumo 3.3+ Lista os locais das pastas global-packages, http-cache e temporárias e limpa o conteúdo dessas pastas.
restaurar Consumo 2.7+ Restaura todos os pacotes referenciados pelo formato de gerenciamento de pacotes em uso. Ao executar no Mono, não há suporte para a restauração de pacotes usando o formato PackageReference.
setapikey Publicação, consumo Todos Salva uma chave de API para uma determinada fonte de pacote quando essa fonte de pacote requer uma chave para acesso.
Especificação Criação Todos Gera um arquivo .nuspec, usando tokens se gerar o arquivo de um projeto de Visual Studio.
Comandos secundários Funções aplicáveis Versão do NuGet Descrição
adicionar Publicação 3.3+ Adiciona um pacote a uma fonte de pacote não HTTP usando layout hierárquico. Para fontes HTTP, use push.
delete Publicação Todos Remove ou deslista um pacote de uma fonte de pacote.
init Criação 3.3+ Adiciona pacotes de uma pasta a uma fonte de pacote usando layout hierárquico.
install Consumo Todos Instala um pacote no projeto atual, mas não modifica projetos nem arquivos de referência.
list Consumo, talvez Publicação Todos Exibe pacotes de uma determinada fonte.
Espelho Publicação Preterido em 3.2+ Espelha um pacote e suas dependências de uma origem para um repositório de destino.
buscar Consumo 5.8+ Pesquisa uma determinada fonte usando a cadeia de caracteres de consulta fornecida.
origens Consumo, Publicação Todos Gerencia fontes de pacote em arquivos de configuração.
atualização Consumo Todos Atualiza os pacotes de um projeto para as versões mais recentes disponíveis. Não há suporte ao executar no Mono.

Comandos diferentes usam várias variáveis de ambiente.

Comandos da CLI do NuGet por funções aplicáveis:

Função Comandos
Consumo config, help, install, list, locals, , restore, search, , setapikey, sources, update
Criação config, help, init, , packspec
Publicação add, config, delete, help, list, push, , setapikey, , sources

Os desenvolvedores preocupados apenas com o consumo de pacotes, por exemplo, só precisam entender esse subconjunto de comandos NuGet.

Observação

Os nomes de opção de comando não diferenciam maiúsculas de minúsculas. As opções preteridas não estão incluídas nessa referência, como NoPrompt (substituídas por NonInteractive) e Verbose (substituídas por Verbosity).

Localization

NuGet.exemensagens de progresso, aviso e erro são traduzidas para as mesmas localidades que Visual Studio. NuGet.exe é fornecido como um único exe e, devido a considerações de tamanho, apenas as mensagens mais comumente exibidas são traduzidas em todos os idiomas.

  • Last updated on