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 anders verhält, könnte eine Umgebungsvariable die Ursache sein. Beispielsweise hat Azure Web-Apps Kudu (während der Bereitstellung verwendet) NUGET_XMLDOC_MODE festgelegt, 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 | Beschreibung | Notizen |
|---|---|---|
| http_proxy | Http-Proxy, der für NuGet-HTTP-Vorgänge verwendet wird. | Dies würde als http://<username>:<password>@proxy.com angegeben werden. |
| no_proxy | Konfiguriert do Standard s to bypass from using proxy. | Wird wie folgt angegeben Standard durch Komma (,) getrennt. |
| 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-cz, en-us, es-es, fr-fr, de-de, it-it, ja-jp, ko-kr, pl-pl, pt-br, ru-ru, und 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 Wiederholungsversuchen, wenn die HTTP-Antwort den 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_PAKETE | 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 | Abmelden der Verwendung der HTTP-Antwortnachricht "Wiederholung nach 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 Antwortheader "Retry-After" 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 | Hiermit wird der MSBuild-Ausführlichkeitsgrad festgelegt. | Der Standardwert ist ruhig ("/v:q"). Zulässige Werte sind „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 festzulegen. | Unter Windows-Antivirensoftware können Dateien vorübergehend geöffnet werden, hindern NuGet daran, den Zeitstempel zu ändern. NuGet verwendet ein exponentielles Backoff, bei dem die Wartezeit zwischen den Versuchen Math.Pow(2, retryNumber) ist. 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 nicht festgelegt, ist der Standardwert online. |
Mögliche Werte online (Standard), offline. Im Zusammenhang mit NU3028 |
| NUGET_ENABLE_ENHANCED_HTTP_RETRY | Aktiviert oder deaktiviert den erweiterten HTTP-Wiederholungsversuche in NuGet. | Mögliche Werte sind: true (Standard) oder false. |
| 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 Standardanzahl der zu wartenden Sekunden beträgt 1000. |
| NUGET_EXPERIMENTAL_USE_NJ_FOR_FILE_PARSING | Legt fest, ob Netwonsoft.Json für das Parsen der Ressourcendatei während der Wiederherstellung verwendet wird oder nicht |
Mögliche Werte sind true oder false (Standardwert). |