NuGet CLI-Umgebungsvariablen

Das Verhalten der nuget.exe CLI kann über eine Reihe von Umgebungsvariablen konfiguriert werden, die sich auf nuget.exe auf computerweiten, Benutzer- oder Prozessebenen auswirken. Umgebungsvariablen setzen alle Einstellungen in NuGet.Config Dateien immer außer Kraft, sodass Buildserver geeignete Einstellungen ändern können, ohne Dateien zu ändern.

Im Allgemeinen haben Optionen, die direkt in der Befehlszeile oder in NuGet-Konfigurationsdateien angegeben sind, Vorrang, aber es gibt einige Ausnahmen wie FORCE_NUGET_EXE_INTERACTIVE. Wenn Sie feststellen, dass nuget.exe sich zwischen verschiedenen Computern unterschiedlich verhält, kann eine Umgebungsvariable die Ursache sein. Beispielsweise hat Azure Web Apps Kudu (während der Bereitstellung verwendet) NUGET_XMLDOC_MODEfestgelegt, um die Leistung der Paketwiederherstellung zu beschleunigen und Speicherplatz zu sparen.

Die NuGet CLI verwendet MSBuild zum Lesen der Projektdateien. Alle Umgebungsvariablen sind während der MSBuild-Auswertung als Eigenschaften verfügbar. Die Liste der im NuGet-Paket dokumentierten Eigenschaften und die Wiederherstellung als MSBuild-Ziele können auch als Umgebungsvariablen festgelegt werden.

Variable	Description	Bemerkungen
http_proxy	Http-Proxy, der für NuGet-HTTP-Vorgänge verwendet wird.	Dies würde als http://<username>:<password>@proxy.com.
no_proxy	Konfiguriert Domänen, die von der Verwendung des Proxys umgangen werden sollen.	Als durch Komma (,) getrennte Domänen angegeben.
EnableNuGetPackageRestore	Kennzeichnen, ob NuGet implizit die Zustimmung erteilen soll, wenn dies für das Paket beim Wiederherstellen erforderlich ist.	Angegebene Kennzeichnung wird als "true" oder "1" behandelt, wobei ein anderer Wert, der als Kennzeichnung behandelt wird, nicht festgelegt ist.
NUGET_CLI_LANGUAGE	Ändert nuget.exe Ausgabesprache	Verfügbar in 6.5 und höheren Versionen. Unterstützte Werte werden von Visual Studio-Sprachen mit Gebietsschemanamen unterstützt: zh-cn, , zh-tw, , cs-czen-us, es-es, fr-fr, pl-plja-jpde-deko-krpt-brit-itru-ruund .tr-tr
NUGET_EXE_NO_PROMPT	Verhindert die EXE zum Anfordern von Anmeldeinformationen.	Jeder Wert mit Ausnahme von NULL oder leerer Zeichenfolge wird als dieser Flagsatz/true behandelt.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS	Maximale Dauer zwischen Wiederholungen, wenn die HTTP-Antwort Retry-After Header enthält	Wenn NUGET_OBSERVE_RETRY_AFTER aktiviert ist (wie standardmäßig) und eine HTTP-Antwort einen Retry-After Header enthält, legt diese Umgebungsvariable die maximale Dauer fest, die gewartet wird. Beachten Sie, dass Retry-After entweder eine Dauer (Delta) oder einen Zeitstempel (Datum) bereitstellen kann. Wenn der Server einen Zeitstempel zurückgibt und die Uhr Ihres Computers nicht mit dem Server synchronisiert ist, kann die berechnete Dauer sehr lang (oder negativ) sein.
FORCE_NUGET_EXE_INTERACTIVE	Globale Umgebungsvariable, um den interaktiven Modus zu erzwingen.	Jeder Wert mit Ausnahme von NULL oder leerer Zeichenfolge wird als dieser Flagsatz/true behandelt.
NUGET_PACKAGES	Pfad zur Verwendung für den Ordner "Globale Pakete ", wie unter "Verwalten der globalen Pakete und Cacheordner" beschrieben.	Als absoluter Pfad angegeben.
NUGET_FALLBACK_PACKAGES	Ordner für globale Fallbackpakete.	Absolute Ordnerpfade getrennt durch Semikolon (;).
NUGET_HTTP_CACHE_PATH	Pfad zur Verwendung für den Http-Cache-Ordner , wie unter "Verwalten der globalen Pakete und Cacheordner" beschrieben.	Als absoluter Pfad angegeben.
NUGET_OBSERVE_RETRY_AFTER	Deaktivieren der Verwendung der HTTP-Antwortnachricht Retry-After Verzögerungsdauer	Vor NuGet 6.5 würde NuGet alle fehlgeschlagenen Anforderungen mit derselben Back-Off-Strategie wiederholen. Ab NuGet 6.5 verwendet NuGet standardmäßig den vom Server bereitgestellten Retry-After Verzögerungszeitraum. Legen Sie diese Umgebungsvariable fest, um den Retry-After Antwortheader zu false ignorieren. Siehe auch NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS	Legt zusätzliche MSBuild-Argumente fest.	Übergeben Sie argumente identisch mit der Vorgehensweise, die Sie an msbuild.exeübergeben würden. Ein Beispiel für das Festlegen einer Projekteigenschaft foo aus der Befehlszeile auf die Wertleiste lautet "/p:Foo=Bar".
NUGET_RETRY_HTTP_429	Ändern des Wiederholungsverhaltens für HTTP 429-Antworten	Vor NuGet 6.5 würde NuGet keine Anforderungen wiederholen, die zu HTTP 429 auf 408 führen. Der Standardwert ist true, und diese Umgebungsvariable kann so festgelegt werden, dass false sie sich für ein älteres NuGet-Verhalten anmeldet (versuchen Sie die Anforderung nicht erneut).
NUGET_RESTORE_MSBUILD_VERBOSITY	Legt die Ausführlichkeit des MSBuild-Protokolls fest.	Der Standardwert ist ruhig ("/v:q"). Mögliche Werte q[uiet], m[inimal], n[ormal], d[etailed] und diag[nostic].
NUGET_SHOW_STACK	Bestimmt, ob die vollständige Ausnahme (einschließlich Stapelüberwachung) für den Benutzer angezeigt werden soll.	Wird als wahr oder falsch angegeben (Standard).
NUGET_UPDATEFILETIME_MAXRETRIES	Legt fest, wie oft NuGet versucht, den Zeitstempel der Datei beim Extrahieren von Paketen beim ersten Versuch erneut festzulegen.	Unter Windows-Antivirensoftware können Dateien vorübergehend geöffnet werden, hindern NuGet daran, den Zeitstempel zu ändern. NuGet verwendet ein exponentielles Back-Off, bei dem die Wartezeit zwischen versuchen ist Math.Pow(2, retryNumber). Die standardmäßigen maximalen Wiederholungsversuche sind 9, d. h. die Standardmäßige Gesamtwartedauer, bevor der Fehler ungefähr eine Sekunde beträgt.
NUGET_XMLDOC_MODE	Bestimmt, wie assemblys XML-Dokumentationsdateiextraktion behandelt werden soll.	Unterstützte Modi werden übersprungen (XML-Dokumentationsdateien nicht extrahieren), komprimieren (XML-Dokumentdateien als ZIP-Archiv speichern) oder keine (Standardeinstellung, XML-Dokumentdateien als normale Dateien behandeln).
NUGET_CERT_REVOCATION_MODE	Bestimmt, wie die Sperrstatusüberprüfung des Zertifikats, das zum Signieren eines Pakets verwendet wird, ausgeführt wird, wenn ein signiertes Paket installiert oder wiederhergestellt wird. Wenn sie nicht festgelegt ist, wird standardmäßig auf online.	Mögliche Werte online (Standard), offline. Im Zusammenhang mit NU3028
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT	Konfiguriert, wie oft eine HTTP-Verbindung wiederholt werden soll, wenn erweiterte Wiederholungen aktiviert sind.	Eine Zahl, die angibt, wie viele Wiederholungen ausgeführt werden sollen, der Standardwert ist 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS	Konfiguriert die Wartezeit in Millisekunden, bevor eine HTTP-Verbindung erneut versucht wird, wenn erweiterte Wiederholungen aktiviert sind.	Die Anzahl der zu wartenden Millsekunden, der Standardwert ist 1000.