Поделиться через


Переменные среды интерфейса командной строки NuGet

Поведение интерфейса командной строки nuget.exe можно настроить с помощью ряда переменных среды, которые влияют на nuget.exe на уровне компьютера, пользователя или процесса. Переменные среды всегда переопределяют любые параметры в NuGet.Config файлах, позволяя серверам сборки изменять соответствующие параметры без изменения файлов.

Как правило, параметры, указанные непосредственно в командной строке или в файлах конфигурации NuGet, имеют приоритет, но есть несколько исключений, таких как FORCE_NUGET_EXE_INTERACTIVE. Если вы обнаружите, что nuget.exe ведет себя по-разному между разными компьютерами, переменная среды может быть причиной. Например, Azure веб-приложения Kudu (используемое во время развертывания) NUGET_XMLDOC_MODE установить, чтобы ускорить восстановление пакета и сэкономить место на диске.

Интерфейс командной строки NuGet использует MSBuild для чтения файлов проекта. Все переменные среды доступны как свойства во время оценки MSBuild. Список свойств, задокументированных в пакете NuGet и восстановлении в качестве целевых объектов MSBuild, также можно задать в качестве переменных среды.

«Переменная» Description Примечания
http_proxy Прокси-сервер HTTP, используемый для операций HTTP NuGet. Это будет указано как http://<username>:<password>@proxy.com.
no_proxy Настраивает домены для обхода с помощью прокси-сервера. Указано в качестве доменов, разделенных запятыми (,).
EnableNuGetPackageRestore Помечайте, если NuGet неявно должен предоставить согласие, если это требуется пакетом при восстановлении. Указанный флаг обрабатывается как true или 1, любое другое значение, которое рассматривается как флаг не задан.
NUGET_CLI_LANGUAGE Изменение языка вывода nuget.exe Доступно в версиях 6.5 и более поздних версий. Поддерживаемые значения поддерживаются имена языков Visual Studio: zh-cn, cs-czfr-frde-dees-esit-itja-jpen-uszh-twpl-plpt-brko-krru-ruи .tr-tr
NUGET_EXE_NO_PROMPT Запрещает exe запрашивать учетные данные. Любое значение, за исключением null или пустой строки, будет рассматриваться как этот флаг set/true.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS Максимальная длительность между повторными попытками, если http-ответ содержит заголовок Retry-After Если NUGET_OBSERVE_RETRY_AFTER включен (как по умолчанию) и HTTP-ответ содержит заголовок Retry-After, эта переменная среды задает максимальную длительность ожидания. Обратите внимание, что повторная попытка может предоставить длительность (разностную) или метку времени (дата). Если сервер возвращает метку времени, а часы компьютера не синхронизированы с сервером, вычисляемая длительность может быть очень длинной (или отрицательной).
FORCE_NUGET_EXE_INTERACTIVE Глобальная переменная среды для принудительного интерактивного режима. Любое значение, за исключением null или пустой строки, будет рассматриваться как этот флаг set/true.
NUGET_PACKAGES Путь к использованию для папки глобальных пакетов, как описано в разделе "Управление глобальными пакетами и папками кэша". Указан абсолютный путь.
NUGET_FALLBACK_PACKAGES Глобальные резервные пакеты папок. Абсолютные пути к папкам, разделенные точкой с запятой (;).
NUGET_HTTP_CACHE_PATH Путь к использованию для папки http-cache , как описано в разделе "Управление глобальными пакетами и папками кэша". Указан абсолютный путь.
NUGET_OBSERVE_RETRY_AFTER Отказ от использования http-ответа Retry-After delay durations До NuGet 6.5 NuGet повторит все неудачные запросы с той же стратегией резервного копирования. Начиная с NuGet 6.5, NuGet по умолчанию будет использовать период задержки Retry-After, предоставленный сервером. Установите эту переменную среды, чтобы false игнорировать заголовок ответа Retry-After. См. также NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS Задает дополнительные аргументы MSBuild. Передайте аргументы, идентичные способу передачи их в msbuild.exe. Пример задания свойства проекта Foo из командной строки значением "Строка" будет /p:Foo=Bar
NUGET_RETRY_HTTP_429 Изменение поведения повторных попыток в ответах HTTP 429 До NuGet 6.5 NuGet не будет повторять запросы, которые приводят к HTTP 429 на 408. Значением по умолчанию является true, и эта переменная среды может быть задана, чтобы false выбрать более старое поведение NuGet (не повторяйте запрос)
NUGET_RESTORE_MSBUILD_VERBOSITY Задает детализацию журнала MSBuild. Значение по умолчанию тихо ("/v:q"). Возможные значения q[uiet], m[inimal], n[ormal], d[etailed], и diag[nostic].
NUGET_SHOW_STACK Определяет, должно ли отображаться полное исключение (включая трассировку стека) пользователю. Указано как true или false (по умолчанию).
NUGET_UPDATEFILETIME_MAXRETRIES Задает количество попыток NuGet задать метку времени файла при извлечении пакетов. В антивирусном программном обеспечении Windows может временно открывать файлы, предотвращая изменение метки времени NuGet. NuGet использует экспоненциальный откат, в котором длительность ожидания между попытками Math.Pow(2, retryNumber)составляет. Максимальное число повторных попыток по умолчанию равно 9, то есть общая длительность ожидания по умолчанию до сбоя будет примерно одна секунда.
NUGET_XMLDOC_MODE Определяет способ обработки извлечения XML-файлов XML-документации сборок. Поддерживаемые режимы пропускаются (не извлекают XML-файлы документации), сжимают (хранят XML-файлы документов в виде zip-архива) или нет (по умолчанию обрабатывают XML-файлы документации как обычные файлы).
NUGET_CERT_REVOCATION_MODE Определяет, как состояние отзыва проверка сертификата, используемого для подписи пакета, выполняется при установке или восстановлении подписанного пакета. Если параметр не задан, по умолчанию используется onlineзначение . Возможные значения в сети (по умолчанию) в автономном режиме. Связанные с NU3028
NUGET_ENABLE_ENHANCED_HTTP_RETRY Включает или отключает расширенную повторную попытку HTTP в NuGet. Возможные значения: true (по умолчанию) или false.
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT Настраивает максимальное количество попыток при включении расширенных повторных попыток при получении HTTP-подключения. Число, представляющее количество повторных попыток, значение 6по умолчанию .
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Настраивает время ожидания в миллисекундах перед повтором HTTP-подключения при включении расширенных повторных попыток. Число миллсекунд для ожидания, значение по умолчанию равно 1000.
NUGET_EXPERIMENTAL_USE_NJ_FOR_FILE_PARSING Определяет, используется ли Netwonsoft.Json для синтаксического анализа файла ресурсов во время восстановления. Возможные значения: true или false (по умолчанию).