Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O comportamento da CLI nuget.exe pode ser configurado por meio de várias variáveis de ambiente, que afetam nuget.exe em níveis de todo o computador, usuário ou processo. As variáveis de ambiente sempre substituem quaisquer configurações em NuGet.Config arquivos, permitindo que os servidores de build 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ê descobrir que nuget.exe se comporta de forma diferente entre computadores diferentes, uma variável de ambiente pode ser a causa. Por exemplo, o Kudu dos Aplicativos Web do Azure (usado durante a implantação) NUGET_XMLDOC_MODE definido para ignorar para acelerar o desempenho de restauração de pacotes e economizar espaço em disco.
A CLI do NuGet usa o MSBuild para ler os arquivos do 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 pacote NuGet e a restauração como destinos do MSBuild também podem ser definidas como variáveis de ambiente.
| Variable | Description | Observações |
|---|---|---|
| http_proxy | Proxy http usado para operações HTTP do NuGet. | Isso 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 | Sinalizar 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 em versões 6.5 e superiores. Os valores com suporte têm suporte para nomes de localidade de idiomas do Visual Studio: zh-cn, , zh-tw, cs-cz, en-us, es-es, , de-defr-fr, , it-it, ja-jp, ko-kr, , pl-pl, , pt-br, , , ru-rue tr-tr. |
| NUGET_EXE_NO_PROMPT | Impede que o exe para solicitar credenciais. | Qualquer valor, exceto cadeia de caracteres nula ou vazia, será tratado como este conjunto de sinalizadores/true. |
| NUGET_MAX_RETRY_AFTER_DELAY_SECONDS | Duração máxima entre repetições 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á aguardada. 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 do computador 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 cadeia de caracteres nula ou vazia, será tratado como este conjunto de sinalizadores/true. |
| NUGET_PACKAGES | Caminho a ser usado para a pasta de pacotes globais , conforme descrito no Gerenciamento de pacotes globais e pastas de cache. | Especificado como caminho absoluto. |
| NUGET_FALLBACK_PACKAGES | Pastas de pacotes de fallback global. | Caminhos de pasta absoluta separados por ponto-e-vírgula (;). |
| NUGET_HTTP_CACHE_PATH | Caminho a ser usado para a pasta http-cache , conforme descrito no Gerenciamento de pacotes globais e pastas de cache. | Especificado como caminho absoluto. |
| NUGET_OBSERVE_RETRY_AFTER | Recusar o uso da mensagem de resposta HTTP Retry-After durações de atraso | Antes do NuGet 6.5, o NuGet repetiria 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 Retry-After fornecido pelo servidor. Defina essa variável de ambiente para false ignorar o cabeçalho de resposta Retry-After. Veja também NUGET_MAX_RETRY_AFTER_DELAY_SECONDS |
| NUGET_RESTORE_MSBUILD_ARGS | Define argumentos adicionais do MSBuild. | Passe argumentos idênticos a como você os passaria para msbuild.exe. Um exemplo de como definir uma propriedade de projeto Foo da linha de comando para o valor Barra 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 resultam em HTTP 429 no 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 novamente a solicitação) |
| NUGET_RESTORE_MSBUILD_VERBOSITY | Define a verbosidade de 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 o rastreamento de pilha) deve ser exibida ao usuário. | Especificado como verdadeiro ou falso (padrão). |
| NUGET_UPDATEFILETIME_MAXRETRIES | Define o número de vezes que o NuGet tentará repetir a definição do carimbo de data/hora do arquivo ao extrair pacotes quando a primeira tentativa falhou. | No software antivírus do Windows, é possível abrir temporariamente arquivos, 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). As tentativas máximas padrão são 9, o que significa que a duração de espera total padrão antes da falha será de aproximadamente um segundo. |
| NUGET_XMLDOC_MODE | Determina como a extração de arquivos de documentação XML de assemblies deve ser tratada. | Os modos com suporte são ignorar (não extrair arquivos de documentação XML), compactar (armazenar arquivos de documentos XML como um arquivo zip) ou nenhum (padrão, tratar arquivos de documentos XML como arquivos regulares). |
| NUGET_CERT_REVOCATION_MODE | Determina como a verificação de status de revogação do certificado usado para assinar um pacote é executada quando um pacote assinado é instalado ou restaurado. Quando não definido, o padrão é online. |
Valores possíveis online (padrão), offline. Relacionado ao 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 aprimoradas são habilitadas. | Um número que representa quantas tentativas executar, o valor padrão é 6. |
| NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS | Configura a quantidade de tempo para aguardar em milissegundos antes de tentar novamente uma conexão HTTP quando novas tentativas aprimoradas estiverem habilitadas. | Número de millseconds a aguardar, o valor padrão é 1000. |