Delen via

NuGet CLI-omgevingsvariabelen

Het gedrag van de nuget.exe CLI kan worden geconfigureerd via een aantal omgevingsvariabelen, die van invloed zijn op nuget.exe op computerbrede, gebruikers- of procesniveaus. Omgevingsvariabelen overschrijven altijd alle instellingen in NuGet.Config bestanden, zodat buildservers de juiste instellingen kunnen wijzigen zonder bestanden te wijzigen.

Over het algemeen hebben opties die rechtstreeks op de opdrachtregel of in NuGet-configuratiebestanden zijn opgegeven voorrang, maar er zijn enkele uitzonderingen, zoals FORCE_NUGET_EXE_INTERACTIVE. Als u merkt dat nuget.exe zich anders gedraagt tussen verschillende computers, kan een omgevingsvariabele de oorzaak zijn. Azure Web Apps Kudu (gebruikt tijdens de implementatie) heeft bijvoorbeeld NUGET_XMLDOC_MODE ingesteld om over te slaan om de prestaties van pakketherstel te versnellen en schijfruimte te besparen.

De NuGet CLI gebruikt MSBuild om de projectbestanden te lezen. Alle omgevingsvariabelen zijn beschikbaar als eigenschappen tijdens de MSBuild-evaluatie. De lijst met eigenschappen die zijn gedocumenteerd in Het NuGet-pack en herstellen als MSBuild-doelen kunnen ook worden ingesteld als omgevingsvariabelen.

Veranderlijk Beschrijving Opmerkingen
http_proxy Http-proxy die wordt gebruikt voor NuGet HTTP-bewerkingen. Dit zou worden opgegeven als http://<username>:<password>@proxy.com.
no_proxy Hiermee configureert u domeinen die moeten worden overgeslagen van het gebruik van proxy. Opgegeven als domeinen gescheiden door komma (,).
EnableNuGetPackageRestore Vlag toevoegen als NuGet impliciet toestemming moet verlenen als dat vereist is voor pakket bij herstel. De opgegeven vlag wordt behandeld als waar of 1, een andere waarde die wordt behandeld als vlag die niet is ingesteld.
NUGET_CLI_LANGUAGE Wijzigingen nuget.exe uitvoertaal Beschikbaar in 6.5 en hogere versies. Ondersteunde waarden worden ondersteunde landinstellingen voor Visual Studio-talen: zh-cn, zh-tw, , cs-cz, en-us, es-es, fr-frde-deit-itja-jp, ko-krpl-pl, pt-bren . ru-rutr-tr
NUGET_EXE_NO_PROMPT Hiermee voorkomt u dat de exe om referenties wordt gevraagd. Elke waarde, met uitzondering van null of lege tekenreeks, wordt behandeld als deze vlagset/true.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS Maximale duur tussen nieuwe pogingen wanneer het HTTP-antwoord Retry-After header bevat Wanneer NUGET_OBSERVE_RETRY_AFTER is ingeschakeld (zoals deze standaard is) en een HTTP-antwoord een Retry-After header bevat, stelt deze omgevingsvariabele de maximale duur in die wordt gewacht. Houd er rekening mee dat Retry-After een duur (delta) of een tijdstempel (datum) kan opgeven. Als de server een tijdstempel retourneert en de klok van uw computer niet synchroon is met de server, kan de berekende duur erg lang (of negatief) zijn.
FORCE_NUGET_EXE_INTERACTIVE Globale omgevingsvariabele om interactieve modus af te dwingen. Elke waarde, met uitzondering van null of lege tekenreeks, wordt behandeld als deze vlagset/true.
NUGET_PACKAGES Het pad dat moet worden gebruikt voor de map global-packages , zoals beschreven in het beheren van de globale pakketten en cachemappen. Opgegeven als absoluut pad.
NUGET_FALLBACK_PACKAGES Globale terugvalpakketten mappen. Absolute mappaden gescheiden door puntkomma's (;).
NUGET_HTTP_CACHE_PATH Pad dat moet worden gebruikt voor de http-cachemap , zoals beschreven in het beheren van de globale pakketten en cachemappen. Opgegeven als absoluut pad.
NUGET_OBSERVE_RETRY_AFTER Afmelden voor het gebruik van HTTP-antwoordbericht Retry-After vertragingsduur Vóór NuGet 6.5 zou NuGet alle mislukte aanvragen opnieuw proberen met dezelfde back-off-strategie. Vanaf NuGet 6.5 gebruikt NuGet standaard de Retry-After vertragingsperiode van de server. Stel deze omgevingsvariabele in om false de Retry-After antwoordheader te negeren. Zie ook NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS Hiermee stelt u extra MSBuild-argumenten in. Geef argumenten door die identiek zijn aan de manier waarop u ze zou doorgeven aan msbuild.exe. Een voorbeeld van het instellen van een projecteigenschap Foo vanaf de opdrachtregel naar waardebalk is /p:Foo=Bar
NUGET_RETRY_HTTP_429 Gedrag voor opnieuw proberen wijzigen in HTTP 429-antwoorden Vóór NuGet 6.5 zou NuGet geen aanvragen opnieuw proberen die leiden tot HTTP 429 op 408. De standaardwaarde is trueen deze omgevingsvariabele kan worden ingesteld op false opt-in voor ouder NuGet-gedrag (probeer de aanvraag niet opnieuw)
NUGET_RESTORE_MSBUILD_VERBOSITY Hiermee stelt u de uitgebreidheid van het MSBuild-logboek in. Standaard is stil ("/v:q"). Mogelijke waarden q[uiet], m[inimal], n[ormal], d[etailed], en diag[nostic].
NUGET_SHOW_STACK Bepaalt of de volledige uitzondering (inclusief stack-trace) moet worden weergegeven aan de gebruiker. Opgegeven als waar of onwaar (standaard).
NUGET_UPDATEFILETIME_MAXRETRIES Hiermee stelt u het aantal keren in dat NuGet opnieuw probeert de tijdstempel van het bestand in te stellen bij het extraheren van pakketten wanneer de eerste poging is mislukt. Op Windows-antivirussoftware kunnen bestanden tijdelijk worden geopend, waardoor NuGet de tijdstempel niet kan wijzigen. NuGet maakt gebruik van een exponentiële back-off waarbij de wachttijd tussen pogingen is Math.Pow(2, retryNumber). De standaard maximum aantal nieuwe pogingen is 9, wat betekent dat de standaard totale wachttijd voordat de fout ongeveer één seconde duurt.
NUGET_XMLDOC_MODE Bepaalt hoe xml-documentatiebestandextractie van assembly's moet worden verwerkt. Ondersteunde modi worden overgeslagen (geen XML-documentatiebestanden extraheren), comprimeren (XML-documentbestanden opslaan als een zip-archief) of geen (standaard, XML-documentbestanden behandelen als gewone bestanden).
NUGET_CERT_REVOCATION_MODE Bepaalt hoe de intrekkingsstatuscontrole van het certificaat dat wordt gebruikt om een pakket te ondertekenen, wordt uitgevoerd wanneer een ondertekend pakket is geïnstalleerd of hersteld. Als dit niet is ingesteld, wordt standaard ingesteld op online. Mogelijke waarden online (standaard), offline. Gerelateerd aan NU3028
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT Hiermee configureert u het maximum aantal keren dat een HTTP-verbinding opnieuw moet worden geprobeerd wanneer uitgebreide nieuwe pogingen zijn ingeschakeld. Een getal dat aangeeft hoeveel nieuwe pogingen moeten worden uitgevoerd, de standaardwaarde is 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Hiermee configureert u de hoeveelheid tijd die moet worden gewacht in milliseconden voordat u een HTTP-verbinding opnieuw probeert uit te voeren wanneer uitgebreide nieuwe pogingen zijn ingeschakeld. Aantal milleconden dat moet worden gewacht, de standaardwaarde is 1000.