Proměnné prostředí Rozhraní příkazového řádku NuGet

Chování rozhraní příkazového řádku nuget.exe je možné nakonfigurovat prostřednictvím řady proměnných prostředí, které ovlivňují nuget.exe na úrovni celého počítače, uživatele nebo procesu. Proměnné prostředí vždy přepíší všechna nastavení v NuGet.Config souborech, což umožňuje serverům sestavení změnit odpovídající nastavení beze změny souborů.

Obecně platí, že možnosti zadané přímo na příkazovém řádku nebo v konfiguračních souborech NuGet mají přednost, ale existuje několik výjimek, například FORCE_NUGET_EXE_INTERACTIVE. Pokud zjistíte, že nuget.exe se chová odlišně mezi různými počítači, může být příčinou proměnná prostředí. Například Kudu Služby Azure Web Apps (používané během nasazování) má NUGET_XMLDOC_MODE nastavenou tak, aby urychlila obnovení balíčku a ušetřila místo na disku.

Rozhraní příkazového řádku NuGet používá nástroj MSBuild ke čtení souborů projektu. Všechny proměnné prostředí jsou během vyhodnocení nástroje MSBuild k dispozici jako vlastnosti . Seznam vlastností zdokumentovaných v sadě NuGet a obnovení jako cíle NÁSTROJE MSBuild lze také nastavit jako proměnné prostředí.

Proměnná	Popis	Poznámky
http_proxy	Proxy server Http používaný pro operace HTTP NuGet.	Tato funkce by byla zadána jako http://<username>:<password>@proxy.com.
no_proxy	Nakonfiguruje domény tak, aby se nepoužívat proxy server.	Zadané jako domény oddělené čárkami (,).
EnableNuGetPackageRestore	Příznak, jestli by NuGet měl implicitně udělit souhlas, pokud to vyžaduje balíček při obnovení.	Zadaný příznak je považován za true nebo 1, jakákoli jiná hodnota, která není nastavena jako příznak.
NUGET_CLI_LANGUAGE	Změny nuget.exe výstupního jazyka	K dispozici ve verzích 6.5 a vyšších verzích. Podporované hodnoty jsou podporované názvy národních prostředí jazyků sady Visual Studio: zh-cn, zh-tw, cs-cz, en-us, es-es, fr-fr, it-itpl-plde-deko-krpt-brja-jpru-rua .tr-tr
NUGET_EXE_NO_PROMPT	Zabrání exe výzvě k zadání přihlašovacích údajů.	Jakákoli hodnota s výjimkou null nebo prázdného řetězce bude považována za tuto sadu/true příznaku.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS	Maximální doba trvání mezi opakovanými pokusy, pokud odpověď HTTP obsahuje hlavičku Opakovat až po	Pokud je NUGET_OBSERVE_RETRY_AFTER povolená (jak je ve výchozím nastavení) a odpověď HTTP obsahuje hlavičku Opakování po, nastaví tato proměnná prostředí maximální dobu čekání. Mějte na paměti, že opakování po může obsahovat dobu trvání (delta) nebo časové razítko (datum). Pokud server vrátí časové razítko a hodiny vašeho počítače nejsou synchronizované se serverem, počítaná doba trvání může být velmi dlouhá (nebo záporná).
FORCE_NUGET_EXE_INTERACTIVE	Globální proměnná prostředí pro vynucení interaktivního režimu	Jakákoli hodnota s výjimkou null nebo prázdného řetězce bude považována za tuto sadu/true příznaku.
NUGET_PACKAGES	Cesta, která se má použít pro složku globálních balíčků, jak je popsáno v tématu Správa globálních balíčků a složek mezipaměti.	Zadáno jako absolutní cesta.
NUGET_FALLBACK_PACKAGES	Globální složky náhradních balíčků	Absolutní cesty ke složkám oddělené středníkem (;).
NUGET_HTTP_CACHE_PATH	Cesta, která se má použít pro složku http-cache , jak je popsáno v tématu Správa globálních balíčků a složek mezipaměti.	Zadáno jako absolutní cesta.
NUGET_OBSERVE_RETRY_AFTER	Výslovný nesouhlas s používáním zprávy odpovědi HTTP– Opakování po uplynutí doby zpoždění	Před NuGetem 6.5 by NuGet zkusil opakovat všechny neúspěšné požadavky se stejnou strategií zpětného vypnutí. Počínaje NuGetem 6.5 použije NuGet ve výchozím nastavení dobu zpoždění opakování po poskytnutí serveru. Nastavte tuto proměnnou prostředí tak, aby false ignorovala hlavičku odpovědi Opakovat až po. Viz také NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS	Nastaví další argumenty nástroje MSBuild.	Předejte argumenty identické s tím, jak byste je předali msbuild.exe. Příklad nastavení vlastnosti projektu Foo z příkazového řádku na hodnotu Bar by byl /p:Foo=Bar.
NUGET_RETRY_HTTP_429	Změna chování opakování u odpovědí HTTP 429	Před NuGetem 6.5 by NuGet nezopakoval požadavky, které by vyvolaly http 429 dne 408. Výchozí hodnota je truea tato proměnná prostředí se dá nastavit tak, aby se přihlásila ke false staršímu chování NuGetu (nezopakujte požadavek).
NUGET_RESTORE_MSBUILD_VERBOSITY	Nastaví úroveň podrobností protokolu NÁSTROJE MSBuild.	Výchozí hodnota je tichá (/v:q). Možné hodnoty q[uiet], m[inimal], n[ormal], d[etailed] a diag[nostic].
NUGET_SHOW_STACK	Určuje, jestli se má uživateli zobrazit úplná výjimka (včetně trasování zásobníku).	Zadané jako true nebo false (výchozí).
NUGET_UPDATEFILETIME_MAXRETRIES	Nastaví počet pokusů NuGet o nastavení časového razítka souboru při extrahování balíčků.	V antivirovém softwaru pro Windows může dočasně otevřít soubory, což brání NuGet změnit časové razítko. NuGet používá exponenciální back-off, kde doba čekání mezi pokusy je Math.Pow(2, retryNumber). Výchozí maximální počet opakování je 9, což znamená, že výchozí celková doba čekání před selháním bude přibližně jedna sekunda.
NUGET_XMLDOC_MODE	Určuje způsob zpracování extrahování souborů dokumentace XML sestavení.	Podporované režimy jsou přeskočení (neextrahujte soubory dokumentace XML), komprimujte (ukládejte soubory dokumentace XML jako archiv zip) nebo žádné (výchozí nastavení, považovat soubory dokumentace XML za běžné soubory).
NUGET_CERT_REVOCATION_MODE	Určuje, jak se provádí kontrola stavu odvolání certifikátu použitého k podepsání balíčku při instalaci nebo obnovení podepsaného balíčku. Pokud není nastaveno, použije se výchozí hodnota online.	Možné hodnoty online (výchozí), offline. Související s NU3028
NUGET_ENABLE_ENHANCED_HTTP_RETRY	Povolí nebo zakáže rozšířené opakování HTTP v NuGetu.	Možné hodnoty jsou true (výchozí) nebo false.
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT	Konfiguruje maximální počet opakování připojení HTTP při povolení rozšířených opakovaných pokusů.	Číslo představující, kolik opakování se má provést, je 6výchozí hodnota .
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS	Nakonfiguruje dobu čekání v milisekundách před opakováním připojení HTTP, pokud jsou povolené rozšířené opakování.	Počet mlýnů, které se mají čekat, výchozí hodnota je 1000.
NUGET_EXPERIMENTAL_USE_NJ_FOR_FILE_PARSING	Určuje, jestli se při obnovení používá k analýze souboru assetů nebo ne Netwonsoft.Json .	Možné hodnoty jsou true nebo false (výchozí).