Zmienne środowiskowe interfejsu wiersza polecenia narzędzia NuGet

Zachowanie interfejsu wiersza polecenia nuget.exe można skonfigurować za pomocą wielu zmiennych środowiskowych, które mają wpływ na nuget.exe na poziomie komputera, użytkownika lub procesu. Zmienne środowiskowe zawsze zastępują wszystkie ustawienia w NuGet.Config plikach, umożliwiając serwerom kompilacji zmianę odpowiednich ustawień bez modyfikowania żadnych plików.

Ogólnie rzecz biorąc, opcje określone bezpośrednio w wierszu polecenia lub w plikach konfiguracji NuGet mają pierwszeństwo, ale istnieje kilka wyjątków, takich jak FORCE_NUGET_EXE_INTERACTIVE. Jeśli okaże się, że nuget.exe zachowuje się inaczej między różnymi komputerami, przyczyną może być zmienna środowiskowa. Na przykład usługa Azure Web Apps Kudu (używana podczas wdrażania) NUGET_XMLDOC_MODE została ustawiona tak, aby przyspieszyć wydajność przywracania pakietów i zaoszczędzić miejsce na dysku.

Interfejs wiersza polecenia NuGet używa programu MSBuild do odczytywania plików projektu. Wszystkie zmienne środowiskowe są dostępne jako właściwości podczas oceny programu MSBuild. Lista właściwości udokumentowanych w pakiecie NuGet i przywracanie jako obiekty docelowe programu MSBuild można również ustawić jako zmienne środowiskowe.

Zmienna opis Uwagi
http_proxy Serwer proxy HTTP używany na potrzeby operacji HTTP NuGet. Zostanie to określone jako http://<username>:<password>@proxy.com.
no_proxy Konfiguruje domeny do pomijania z używania serwera proxy. Określone jako domeny oddzielone przecinkami (,).
EnableNuGetPackageRestore Flaga , jeśli pakiet NuGet powinien niejawnie udzielić zgody, jeśli jest to wymagane przez pakiet podczas przywracania. Określona flaga jest traktowana jako true lub 1, każda inna wartość traktowana jako flaga nie jest ustawiona.
NUGET_CLI_LANGUAGE Zmiany nuget.exe języka wyjściowego Dostępne w wersji 6.5 lub nowszej. Obsługiwane wartości to obsługiwane nazwy ustawień regionalnych języków programu Visual Studio: zh-cn, , en-uscs-czde-defr-frit-itja-jpes-eszh-twpl-plpt-brko-krru-rui .tr-tr
NUGET_EXE_NO_PROMPT Uniemożliwia plik exe monitowania o poświadczenia. Każda wartość z wyjątkiem wartości null lub pustego ciągu będzie traktowana jako ten zestaw flag/wartość true.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS Maksymalny czas trwania między ponownymi próbami, gdy odpowiedź HTTP zawiera nagłówek Ponów próbę po Gdy NUGET_OBSERVE_RETRY_AFTER jest włączona (domyślnie), a odpowiedź HTTP zawiera nagłówek Ponów próbę po, ta zmienna środowiskowa ustawia maksymalny czas oczekiwania. Należy pamiętać, że opcja Ponów próbę po może podać czas trwania (delta) lub sygnaturę czasową (datę). Jeśli serwer zwraca sygnaturę czasową, a zegar maszyny nie jest zsynchronizowany z serwerem, obliczany czas trwania może być bardzo długi (lub ujemny).
FORCE_NUGET_EXE_INTERACTIVE Globalna zmienna środowiskowa wymusza tryb interaktywny. Każda wartość z wyjątkiem wartości null lub pustego ciągu będzie traktowana jako ten zestaw flag/wartość true.
NUGET_PACKAGES Ścieżka do użycia dla folderu global-packages zgodnie z opisem w temacie Zarządzanie pakietami globalnymi i folderami pamięci podręcznej. Określony jako ścieżka bezwzględna.
NUGET_FALLBACK_PACKAGES Globalne foldery pakietów rezerwowych. Ścieżki folderów bezwzględnych oddzielone średnikami (;).
NUGET_HTTP_CACHE_PATH Ścieżka do użycia dla folderu http-cache zgodnie z opisem w temacie Zarządzanie globalnymi pakietami i folderami pamięci podręcznej. Określony jako ścieżka bezwzględna.
NUGET_OBSERVE_RETRY_AFTER Rezygnacja z korzystania z komunikatu odpowiedzi HTTP Ponawianie po opóźnieniu Przed nuGet 6.5 nuGet ponowi próbę wszystkich żądań, które zakończyły się niepowodzeniem, przy użyciu tej samej strategii wycofywania. Począwszy od pakietu NuGet 6.5, pakiet NuGet domyślnie używa okresu opóźnienia Ponów próbę po upływie czasu dostarczonego przez serwer. Ustaw tę zmienną środowiskową, aby false zignorować nagłówek odpowiedzi Ponów próbę po. Zobacz również NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS Ustawia dodatkowe argumenty MSBuild. Przekaż argumenty identyczne do sposobu przekazywania ich do msbuild.exe. Przykładem ustawienia właściwości projektu Foo z wiersza polecenia na pasek wartości jest /p:Foo=Bar
NUGET_RETRY_HTTP_429 Zmiana zachowania ponawiania prób w odpowiedziach HTTP 429 Przed pakietem NuGet 6.5 program NuGet nie ponowi żądań, które spowodują błąd HTTP 429 w wersji 408. Wartość domyślna to true, a tę zmienną środowiskową można ustawić tak, aby wyrazić false zgodę na starsze zachowanie NuGet (nie ponawiaj próby żądania)
NUGET_RESTORE_MSBUILD_VERBOSITY Ustawia szczegółowość dziennika MSBuild. Ustawienie domyślne jest ciche ("/v:q"). Możliwe wartości q[uiet], m[inimal], n[ormal], d[etailed], i diag[nostic].
NUGET_SHOW_STACK Określa, czy dla użytkownika powinien być wyświetlany pełny wyjątek (w tym ślad stosu). Określony jako true lub false (wartość domyślna).
NUGET_UPDATEFILETIME_MAXRETRIES Ustawia liczbę prób ustawienia znacznika czasu pliku podczas wyodrębniania pakietów przez narzędzie NuGet. W oprogramowaniu antywirusowym systemu Windows można tymczasowo otwierać pliki, uniemożliwiając programowi NuGet zmianę znacznika czasu. NuGet używa wycofywania wykładniczego, w którym czas oczekiwania między próbami wynosi Math.Pow(2, retryNumber). Domyślna maksymalna liczba ponownych prób wynosi 9, co oznacza, że domyślny całkowity czas oczekiwania przed niepowodzeniem będzie wynosić około jednej sekundy.
NUGET_XMLDOC_MODE Określa sposób obsługi wyodrębniania plików dokumentacji XML zestawów XML. Obsługiwane tryby są pomijane (nie wyodrębniaj plików dokumentacji XML), kompresuj (przechowuj pliki dokumentacji XML jako archiwum zip) lub brak (domyślnie traktuj pliki dokumentacji XML jako zwykłe pliki).
NUGET_CERT_REVOCATION_MODE Określa, w jaki sposób sprawdzanie stanu odwołania certyfikatu używanego do podpisywania pakietu jest wykonywane po zainstalowaniu lub przywróceniu podpisanego pakietu. Jeśli nie zostanie ustawiona, wartość domyślna to online. Możliwe wartości w trybie online (ustawienie domyślne), offline. Powiązane z NU3028
NUGET_ENABLE_ENHANCED_HTTP_RETRY Włącza lub wyłącza rozszerzone ponawianie próby HTTP w narzędziu NuGet. Możliwe wartości to true (wartość domyślna) lub false.
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT Konfiguruje maksymalną liczbę ponownych prób po ponownym pobraniu połączenia HTTP po włączeniu rozszerzonych ponownych prób. Liczba reprezentująca liczbę ponownych prób do wykonania, wartość domyślna to 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Konfiguruje czas oczekiwania w milisekundach przed ponowieniu próby nawiązania połączenia HTTP po włączeniu rozszerzonych ponownych prób. Liczba milisekund do oczekiwania, wartość domyślna to 1000.
NUGET_EXPERIMENTAL_USE_NJ_FOR_FILE_PARSING Określa, czy Netwonsoft.Json podczas przywracania jest używany do analizowania pliku zasobów Możliwe wartości to true lub false (wartość domyślna).