Variables d’environnement de la CLI NuGet

Le comportement du CLI nuget.exe peut être configuré via un certain nombre de variables d’environnement, qui affectent nuget.exe au niveau ordinateur, utilisateur ou processus. Les variables d’environnement remplacent toujours les paramètres dans les fichiers NuGet.Config, ce qui permet aux serveurs de version de modifier les paramètres appropriés sans modifier de fichiers.

En général, les options spécifiées directement sur la ligne de commande ou dans les fichiers de configuration NuGet sont prioritaires, mais il existe quelques exceptions telles que FORCE_NUGET_EXE_INTERACTIVE. Si vous constatez que nuget.exe se comporte différemment entre différents ordinateurs, une variable d’environnement peut être la cause. Par exemple, Azure Web Apps Kudu (utilisé pendant le déploiement) a NUGET_XMLDOC_MODE défini sur ignorer pour accélérer les performances de restauration des packages et économiser de l’espace disque.

La CLI NuGet utilise MSBuild pour lire les fichiers projet. Toutes les variables d’environnement sont disponibles en tant que propriétés pendant l’évaluation MSBuild. La liste des propriétés documentées dans le pack NuGet et la restauration en tant que cibles MSBuild peuvent également être définies en tant que variables d’environnement.

Variable	Description	Notes
http_proxy	Proxy HTTP utilisé pour les opérations HTTP NuGet.	Cet attribut doit être spécifié en tant que http://<username>:<password>@proxy.com.
no_proxy	Configure les domaines à contourner à l’aide du proxy.	Spécifié en tant que domaines séparés par des virgules (,).
EnableNuGetPackageRestore	Indique si NuGet doit accorder implicitement le consentement s’il est requis par le package lors de la restauration.	L’indicateur spécifié est traité comme vrai ou 1, toute autre valeur traitée comme indicateur non défini.
NUGET_CLI_LANGUAGE	Modifie le langage de sortie nuget.exe	Disponible dans les versions 6.5 et supérieures. Les valeurs prises en charge sont les noms régionaux des langues Visual Studio prises en charge : 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 et tr-tr.
NUGET_EXE_NO_PROMPT	Empêche l’exe de demander des informations d’identification.	Toute valeur à l’exception de nul ou de chaîne vide sera traitée comme cet indicateur défini/vrai.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS	Durée maximale entre nouvelles tentatives lorsque la réponse HTTP contient un en-tête Retry-After	Lorsque NUGET_OBSERVE_RETRY_AFTER est activé (tel qu’il est par défaut) et qu’une réponse HTTP contient un en-tête Retry-After, cette variable d’environnement définit la durée maximale qui sera le temps d’attente. Notez que les nouvelles tentatives peuvent fournir une durée (delta) ou un horodatage (date). Si le serveur retourne un horodatage et que l’horloge de votre ordinateur n’est pas synchronisée avec le serveur, la durée calculée peut être très longue (ou négative).
FORCE_NUGET_EXE_INTERACTIVE	Variable d’environnement globale pour forcer le mode interactif.	Toute valeur à l’exception de nul ou de chaîne vide sera traitée comme cet indicateur défini/vrai.
NUGET_PACKAGES	Chemin d’accès à utiliser pour le dossier global-packages, comme décrit dans Gestion des packages globaux et des dossiers de cache.	Spécifié comme chemin d’accès absolu.
NUGET_FALLBACK_PACKAGES	Dossiers de packages de secours globaux.	Chemins d’accès aux dossiers absolus séparés par des points-virgules (;).
NUGET_HTTP_CACHE_PATH	Chemin d’accès à utiliser pour le dossier http-cache, comme décrit dans Gestion des dossiers globaux de packages et cache.	Spécifié comme chemin d’accès absolu.
NUGET_OBSERVE_RETRY_AFTER	Refuser l’utilisation des durées de délai de nouvelle tentative de message de réponse HTTP	Avant NuGet 6.5, NuGet réessayerait toutes les demandes ayant échoué avec la même stratégie d’interruption. À compter de NuGet 6.5, NuGet utilise par défaut la période de délai de nouvelle tentative fournie par le serveur. Définissez cette variable d’environnement pour false pour ignorer l’en-tête de réponse Retry-After. Voir également NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS	Définit des arguments MSBuild supplémentaires.	Transmettez des arguments identiques à la façon dont vous les transféreriez à msbuild.exe. Un exemple de définition d’une propriété de projet Foo à partir de la ligne de commande sur la barre de valeurs est /p:Foo=Bar
NUGET_RETRY_HTTP_429	Modifiez le comportement de nouvelle tentative sur les réponses HTTP 429	Avant NuGet 6.5, NuGet n’effectue pas de nouvelles tentatives de requêtes qui entraînent HTTP 429 sur 408. La valeur par défaut est true, et cette variable d’environnement peut être définie pour false pour choisir un comportement NuGet plus ancien (ne réessayez pas la requête)
NUGET_RESTORE_MSBUILD_VERBOSITY	Définit la verbosité du journal MSBuild.	La valeur par défaut est léger (« /v:q »). Valeurs possibles q[uiet], m[inimal], n[ormal], d[etailed] et diag[nostic].
NUGET_SHOW_STACK	Détermine si l’exception complète (y compris le rapport des appels de procédure) doit être affichée à l’utilisateur.	Spécifié comme vrai ou faux (valeur par défaut).
NUGET_UPDATEFILETIME_MAXRETRIES	Définit le nombre de fois où NuGet tente de définir l’horodatage du fichier lors de l’extraction de packages.	Sur le logiciel antivirus Windows, peut temporairement ouvrir des fichiers, empêchant NuGet de modifier l’horodatage. NuGet utilise un back-off exponentiel où la durée d’attente entre les tentatives est Math.Pow(2, retryNumber). Le nombre maximal de nouvelles tentatives par défaut est 9, ce qui signifie que la durée d’attente totale par défaut avant l’échec sera d’environ une seconde.
NUGET_XMLDOC_MODE	Détermine la façon dont l’extraction des fichiers de documentation XML des assemblys doit être gérée.	Les modes pris en charge sont skip (n’extraient pas les fichiers de documentation XML), compress (stockent les fichiers de documentation XML sous forme d’archive zip) ou aucun (par défaut, traitent les fichiers de documentation XML comme des fichiers standard).
NUGET_CERT_REVOCATION_MODE	Détermine comment la case activée de révocation du certificat utilisé pour signer un package est effectué lorsqu’un package signé est installé ou restauré. Si non défini, la valeur par défaut est online.	Valeurs possibles connecté (valeur par défaut), hors connexion. Associé à NU3028
NUGET_ENABLE_ENHANCED_HTTP_RETRY	Active ou désactive une nouvelle tentative HTTP améliorée dans NuGet.	Les valeurs possibles sont true (par défaut) ou false.
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT	Configure le nombre maximal de fois où une connexion HTTP doit être retentée lorsque les tentatives améliorées sont activées.	Nombre représentant le nombre de nouvelles tentatives à effectuer, la valeur par défaut est de 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS	Configure la durée d’attente en millisecondes avant de réessayer une connexion HTTP lorsque des tentatives améliorées sont activées.	Le nombre de millisecondes à attendre par défaut est de 1000.
NUGET_EXPERIMENTAL_USE_NJ_FOR_FILE_PARSING	Détermine si Netwonsoft.Json est utilisé ou non pour analyser le fichier d'actifs lors de la restauration	Les valeurs possibles sont true ou false(par défaut).