Dela via

NuGet CLI-miljövariabler

Beteendet för nuget.exe CLI kan konfigureras via ett antal miljövariabler som påverkar nuget.exe på datoromfattande nivåer, användare eller processer. Miljövariabler åsidosätter alltid alla inställningar i NuGet.Config filer, vilket gör att byggservrar kan ändra lämpliga inställningar utan att ändra några filer.

I allmänhet har alternativ som anges direkt på kommandoraden eller i NuGet-konfigurationsfiler företräde, men det finns några undantag som FORCE_NUGET_EXE_INTERACTIVE. Om du upptäcker att nuget.exe fungerar annorlunda mellan olika datorer kan en miljövariabel vara orsaken. Azure Web Apps Kudu (används under distributionen) har till exempel NUGET_XMLDOC_MODE inställt på att hoppa över för att påskynda prestanda för paketåterställning och spara diskutrymme.

NuGet CLI använder MSBuild för att läsa projektfilerna. Alla miljövariabler är tillgängliga som egenskaper under MSBuild-utvärderingen. Listan över egenskaper som dokumenteras i NuGet-paketet och återställning som MSBuild-mål kan också anges som miljövariabler.

Variable Description Anmärkningar
http_proxy Http-proxy som används för NuGet HTTP-åtgärder. Detta anges som http://<username>:<password>@proxy.com.
no_proxy Konfigurerar domäner att kringgå från att använda proxy. Anges som domäner avgränsade med kommatecken (,).
EnableNuGetPackageRestore Flagga för om NuGet implicit ska bevilja medgivande om det krävs av paketet vid återställning. Den angivna flaggan behandlas som true eller 1, vilket annat värde som behandlas som en flagga som inte har angetts.
NUGET_CLI_LANGUAGE Ändrar nuget.exe utdataspråk Finns i 6,5 och senare versioner. Värden som stöds stöds av språkspråknamn för 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-ruoch tr-tr.
NUGET_EXE_NO_PROMPT Förhindrar exe för att fråga efter autentiseringsuppgifter. Alla värden utom null eller tom sträng behandlas som den här flagguppsättningen/sant.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS Maximal varaktighet mellan återförsök när HTTP-svaret innehåller Retry-After sidhuvud När NUGET_OBSERVE_RETRY_AFTER är aktiverat (som det är som standard) och ett HTTP-svar innehåller ett Retry-After-huvud anger den här miljövariabeln den maximala varaktighet som ska vänta. Observera att Retry-After kan ge antingen en varaktighet (delta) eller en tidsstämpel (datum). Om servern returnerar en tidsstämpel och datorns klocka är osynkroniserad med servern kan den beräknade varaktigheten vara mycket lång (eller negativ).
FORCE_NUGET_EXE_INTERACTIVE Global miljövariabel för att framtvinga interaktivt läge. Alla värden utom null eller tom sträng behandlas som den här flagguppsättningen/sant.
NUGET_PACKAGES Sökväg att använda för mappen global-packages enligt beskrivningen i Hantera globala paket och cachemappar. Anges som absolut sökväg.
NUGET_FALLBACK_PACKAGES Mappar för globala återställningspaket. Absoluta mappsökvägar avgränsade med semikolon (;).
NUGET_HTTP_CACHE_PATH Sökväg att använda för mappen http-cache enligt beskrivningen i Hantera globala paket och cachemappar. Anges som absolut sökväg.
NUGET_OBSERVE_RETRY_AFTER Avregistrera dig från att använda HTTP-svarsmeddelande Retry-After fördröjningsvarstider Före NuGet 6.5 skulle NuGet försöka igen med alla misslyckade begäranden med samma back-off-strategi. Från och med NuGet 6.5 använder NuGet som standard den Retry-After fördröjningsperiod som tillhandahålls av servern. Ange den här miljövariabeln till false för att ignorera Retry-After-svarsrubriken. Se även NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS Anger ytterligare MSBuild-argument. Skicka argument som är identiska med hur du skickar dem till msbuild.exe. Ett exempel på hur du ställer in en projektegenskap foo från kommandoraden till värdefältet är /p:Foo=Bar
NUGET_RETRY_HTTP_429 Ändra återförsöksbeteende för HTTP 429-svar Före NuGet 6.5 skulle NuGet inte försöka igen med begäranden som resulterar i HTTP 429 på 408. Standardvärdet är true, och den här miljövariabeln kan ställas in på false att välja äldre NuGet-beteende (försök inte begära igen)
NUGET_RESTORE_MSBUILD_VERBOSITY Anger MSBuild-loggens utförlighet. Standardvärdet är tyst ("/v:q"). Möjliga värden q[uiet], m[inimal], n[ormal], d[etailed], och diag[nostic].
NUGET_SHOW_STACK Avgör om det fullständiga undantaget (inklusive stackspårning) ska visas för användaren. Anges som sant eller falskt (standard).
NUGET_UPDATEFILETIME_MAXRETRIES Anger hur många gånger NuGet försöker ange filtidsstämpeln igen när paket extraheras när det första försöket misslyckades. I Windows antivirusprogram kan det tillfälligt öppna filer, vilket hindrar NuGet från att ändra tidsstämpeln. NuGet använder en exponentiell back-off där väntetiden mellan försöken är Math.Pow(2, retryNumber). Standardvärdet för maximala återförsök är 9, vilket innebär att den totala väntetiden före felet är ungefär en sekund.
NUGET_XMLDOC_MODE Avgör hur extrahering av XML-dokumentationsfiler ska hanteras. Lägen som stöds hoppar över (extrahera inte XML-dokumentationsfiler), komprimera ( lagra XML-dokumentfiler som ett zip-arkiv) eller inget (standard, behandla XML-dokumentfiler som vanliga filer).
NUGET_CERT_REVOCATION_MODE Avgör hur återkallningsstatuskontrollen för certifikatet som används för att signera ett paket utförs när ett signerat paket installeras eller återställs. När den inte har angetts är standardvärdet online. Möjliga värden online (standard), offline. Relaterat till NU3028
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT Konfigurerar det maximala antalet gånger som en HTTP-anslutning ska försökas igen när utökade återförsök är aktiverade. Ett tal som representerar hur många återförsök som ska utföras, standardvärdet är 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Konfigurerar hur lång tid det tar att vänta i millisekunder innan du försöker igen med en HTTP-anslutning när utökade återförsök är aktiverade. Antal kvarnar som ska vänta, standardvärdet är 1000.