Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O comportamento da nuget.exe CLI pode ser configurado por meio de várias variáveis de ambiente, que afetam nuget.exe em todo o computador, usuário ou níveis de processo. As variáveis de ambiente sempre substituem quaisquer configurações em NuGet.Config arquivos, permitindo que os servidores de compilação alterem as configurações apropriadas sem modificar nenhum arquivo.
Em geral, as opções especificadas diretamente na linha de comando ou nos arquivos de configuração do NuGet têm precedência, mas há algumas exceções, como FORCE_NUGET_EXE_INTERACTIVE. Se você achar que nuget.exe se comporta de forma diferente entre computadores diferentes, uma variável de ambiente pode ser a causa. Por exemplo, o Kudu de Aplicativos Web do Azure (usado durante a implantação) NUGET_XMLDOC_MODE definido para pular para acelerar o desempenho da restauração de pacotes e economizar espaço em disco.
A CLI do NuGet usa o MSBuild para ler os arquivos de projeto. Todas as variáveis de ambiente estão disponíveis como propriedades durante a avaliação do MSBuild. A lista de propriedades documentadas no NuGet pack e restaurar como destinos do MSBuild também pode ser definida como variáveis de ambiente.
| Variável | Descrição | Observações |
|---|---|---|
| http_proxy | Proxy http usado para operações HTTP do NuGet. | Isto seria especificado como http://<username>:<password>@proxy.com. |
| no_proxy | Configura domínios para ignorar o uso de proxy. | Especificado como domínios separados por vírgula (,). |
| EnableNuGetPackageRestore | Sinalize se o NuGet deve conceder consentimento implicitamente se isso for exigido pelo pacote na restauração. | O sinalizador especificado é tratado como true ou 1, qualquer outro valor tratado como sinalizador não definido. |
| NUGET_CLI_LANGUAGE | Alterações nuget.exe idioma de saída | Disponível nas versões 6.5 e superiores. Os valores suportados são nomes de localidade de idiomas do Visual Studio suportados: zh-cn, zh-tw, cs-cz, en-us, es-esfr-fr, de-deit-itja-jpko-krpl-plpt-brru-rue .tr-tr |
| NUGET_EXE_NO_PROMPT | Impede que o exe solicite credenciais. | Qualquer valor, exceto null ou empty string, será tratado como este sinalizador set/true. |
| NUGET_MAX_RETRY_AFTER_DELAY_SECONDS | Duração máxima entre novas tentativas quando a resposta HTTP contém Retry-After cabeçalho | Quando NUGET_OBSERVE_RETRY_AFTER está habilitado (como é por padrão) e uma resposta HTTP contém um cabeçalho Retry-After, essa variável de ambiente define a duração máxima que será esperada. Observe que Retry-After pode fornecer uma duração (delta) ou um carimbo de data/hora (data). Se o servidor retornar um carimbo de data/hora e o relógio da sua máquina estiver fora de sincronia com o servidor, a duração calculada poderá ser muito longa (ou negativa). |
| FORCE_NUGET_EXE_INTERACTIVE | Variável de ambiente global para forçar o modo interativo. | Qualquer valor, exceto null ou empty string, será tratado como este sinalizador set/true. |
| NUGET_PACKAGES | Caminho a ser usado para a pasta global-packages , conforme descrito em Gerenciando os pacotes globais e as pastas de cache. | Especificado como caminho absoluto. |
| NUGET_FALLBACK_PACKAGES | Pastas de pacotes de fallback globais. | Caminhos de pasta absolutos separados por ponto-e-vírgula (;). |
| NUGET_HTTP_CACHE_PATH | Caminho a ser usado para a pasta http-cache , conforme descrito em Gerenciando os pacotes globais e as pastas de cache. | Especificado como caminho absoluto. |
| NUGET_OBSERVE_RETRY_AFTER | Desativação do uso de mensagens de resposta HTTP Retry-After durações de atraso | Antes do NuGet 6.5, o NuGet repetia todas as solicitações com falha com a mesma estratégia de back-off. A partir do NuGet 6.5, o NuGet usará, por padrão, o período de atraso de Retry-After fornecido pelo servidor. Defina essa variável de ambiente para false ignorar o cabeçalho de resposta Retry-After. Ver também NUGET_MAX_RETRY_AFTER_DELAY_SECONDS |
| NUGET_RESTORE_MSBUILD_ARGS | Define argumentos adicionais do MSBuild. | Passe argumentos idênticos aos que você passaria para msbuild.exe. Um exemplo de configuração de uma propriedade de projeto Foo da linha de comando para o valor Bar seria /p:Foo=Bar |
| NUGET_RETRY_HTTP_429 | Alterar o comportamento de repetição em respostas HTTP 429 | Antes do NuGet 6.5, o NuGet não repetia solicitações que resultassem em HTTP 429 em 408. O valor padrão é true, e essa variável de ambiente pode ser definida para false aceitar o comportamento mais antigo do NuGet (não tente repetir a solicitação) |
| NUGET_RESTORE_MSBUILD_VERBOSITY | Define a verbosidade do log do MSBuild. | O padrão é silencioso ("/v:q"). Valores possíveis q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic]. |
| NUGET_SHOW_STACK | Determina se a exceção completa (incluindo rastreamento de pilha) deve ser exibida para o usuário. | Especificado como verdadeiro ou falso (padrão). |
| NUGET_UPDATEFILETIME_MAXRETRIES | Define o número de vezes que o NuGet tentará definir novamente o carimbo de data/hora do arquivo ao extrair pacotes quando a primeira tentativa falhar. | No Windows, o software antivírus pode abrir arquivos temporariamente, impedindo que o NuGet altere o carimbo de data/hora. O NuGet usa um back-off exponencial em que a duração da espera entre as tentativas é Math.Pow(2, retryNumber). O máximo de tentativas padrão é 9, o que significa que a duração total de espera padrão antes da falha será de aproximadamente um segundo. |
| NUGET_XMLDOC_MODE | Determina como a extração do arquivo de documentação XML de assemblies deve ser tratada. | Os modos suportados são skip (não extrair arquivos de documentação XML), compactar (armazenar arquivos doc XML como um arquivo zip) ou nenhum (padrão, tratar arquivos doc XML como arquivos regulares). |
| NUGET_CERT_REVOCATION_MODE | Determina como a verificação do status de revogação do certificado usado para assinar um pacote é executada quando um pacote assinado é instalado ou restaurado. Quando não estiver definido, o padrão será online. |
Valores possíveis online (padrão), offline. Relacionados com NU3028 |
| NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT | Configura o número máximo de vezes que uma conexão HTTP deve ser repetida quando novas tentativas avançadas são habilitadas. | Um número que representa quantas tentativas repetidas executar, o valor padrão é 6. |
| NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS | Configura a quantidade de tempo de espera em milissegundos antes de tentar novamente uma conexão HTTP quando as novas tentativas avançadas estão habilitadas. | Número de millseconds a esperar, o valor padrão é 1000. |