Sdílet prostřednictvím

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

  • Článek

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í).