Variables d’environnement CLI NuGetNuGet CLI environment variables

Le comportement de l’interface CLI de nuget.exe peut être configuré via un nombre de variables d’environnement, qui affectent nuget.exe sur l’ordinateur, utilisateur ou le traitement des niveaux.The behavior of the nuget.exe CLI can be configured through a number of environment variables, which affect nuget.exe on computer-wide, user, or process levels. Variables d’environnement remplacent toujours les paramètres dans NuGet.Config fichiers, ce qui permet des serveurs pour modifier les paramètres appropriés sans modifier tous les fichiers de builds.Environment variables always override any settings in NuGet.Config files, allowing build servers to change appropriate settings without modifying any files.

En règle générale, les options spécifiées directement sur la ligne de commande ou dans les fichiers de configuration NuGet ont une priorité, mais il existe quelques exceptions comme FORCE_NUGET_EXE_INTERACTIVE.In general, options specified directly on the command line or in NuGet configuration files have precedence, but there are a few exceptions such as FORCE_NUGET_EXE_INTERACTIVE. Si vous trouvez que nuget.exe se comporte différemment entre différents ordinateurs, une variable d’environnement peut être la cause.If you find that nuget.exe behaves differently between different computers, an environment variable could be the cause. Par exemple, Azure Web Apps Kudu (utilisé au cours du déploiement) a NUGET_XMLDOC_MODE définie sur ignorer pour accélérer les performances de restauration de package et d’économiser l’espace disque.For example, Azure Web Apps Kudu (used during deployment) has NUGET_XMLDOC_MODE set to skip to speed up package restore performance and save disk space.

La CLI NuGet utilise MSBuild pour lire les fichiers de projet.The NuGet CLI uses MSBuild to read the project files. Toutes les variables d’environnement sont disponibles en tant que propriétés lors de l’évaluation de MSBuild.All environment variables are available as properties during the MSBuild evaluation. La liste de propriétés présentée dans NuGet pack et restore en tant que cibles de MSBuild peut également être définie en tant que variables d’environnement.The list of properties documented in NuGet pack and restore as MSBuild targets can also be set as environment variables.

VariableVariable DescriptionDescription NotesRemarks
http_proxyhttp_proxy Proxy HTTP utilisé pour les opérations HTTP de NuGet.Http proxy used for NuGet HTTP operations. Cela serait spécifiée en tant que http://<username>:<password>@proxy.com.This would be specified as http://<username>:<password>@proxy.com.
no_proxyno_proxy Configure les domaines de contourner l’utilisation de proxy.Configures domains to bypass from using proxy. Spécifié en tant que domaines séparés par des virgules (,).Specified as domains separated by comma (,).
EnableNuGetPackageRestoreEnableNuGetPackageRestore Indicateur pour si NuGet doit implicitement donner son consentement si requis par le package lors de la restauration.Flag for if NuGet should implicitly grant consent if that's required by package on restore. Indicateur spécifié est traité comme true ou 1, toute autre valeur traitée en tant qu’indicateur pas définie.Specified flag is treated as true or 1, any other value treated as flag not set.
NUGET_EXE_NO_PROMPTNUGET_EXE_NO_PROMPT Empêche le fichier exe pour demander des informations d’identification.Prevents the exe for prompting for credentials. N’importe quelle valeur sauf une chaîne null ou vide est considérée comme cet indicateur ensemble/true.Any value except null or empty string will be treated as this flag set/true.
FORCE_NUGET_EXE_INTERACTIVEFORCE_NUGET_EXE_INTERACTIVE Variable d’environnement global pour forcer le mode interactif.Global environment variable to force interactive mode. N’importe quelle valeur sauf une chaîne null ou vide est considérée comme cet indicateur ensemble/true.Any value except null or empty string will be treated as this flag set/true.
NUGET_PACKAGESNUGET_PACKAGES Chemin d’accès à utiliser pour le global-packages dossier comme décrit sur gérer les packages globaux et les dossiers de cache.Path to use for the global-packages folder as described on Managing the global packages and cache folders. Spécifié en tant que chemin d’accès absolu.Specified as absolute path.
NUGET_FALLBACK_PACKAGESNUGET_FALLBACK_PACKAGES Dossiers de packages de secours globaux.Global fallback packages folders. Chemins d’accès du dossier absolu séparées par des points-virgules ( ;).Absolute folder paths separated by semicolon (;).
NUGET_HTTP_CACHE_PATHNUGET_HTTP_CACHE_PATH Chemin d’accès à utiliser pour le http-cache dossier comme décrit sur gérer les packages globaux et les dossiers de cache.Path to use for the http-cache folder as described on Managing the global packages and cache folders. Spécifié en tant que chemin d’accès absolu.Specified as absolute path.
NUGET_PERSIST_DGNUGET_PERSIST_DG Indicateur spécifiant si les fichiers de groupe de distribution (données collectées à partir de MSBuild) doivent être rendue persistante.Flag indicating if dg files (data collected from MSBuild) should be persisted. Spécifié en tant que true ou false (valeur par défaut), si la valeur pas NUGET_PERSIST_DG_PATH est stockée dans le répertoire temporaire (dossier NuGetScratch dans le répertoire temp de l’environnement actuel).Specified as true or false (default), if NUGET_PERSIST_DG_PATH not set will be stored to temporary directory (NuGetScratch folder in current environment temp directory).
NUGET_PERSIST_DG_PATHNUGET_PERSIST_DG_PATH Chemin d’accès pour conserver les fichiers de groupe de distribution.Path to persist dg files. Spécifié en tant que chemin d’accès absolu, cette option est utilisée uniquement lorsque NUGET_PERSIST_DG est définie sur true.Specified as absolute path, this option is only used when NUGET_PERSIST_DG is set to true.
NUGET_RESTORE_MSBUILD_ARGSNUGET_RESTORE_MSBUILD_ARGS Définit les autres arguments MSBuild.Sets additional MSBuild arguments. Passer des arguments identique à la façon dont vous pouvez les transmettre à msbuild.exe.Pass arguments identical to how you would pass them to msbuild.exe. Un exemple de définition d’une propriété de projet Foo à partir de la ligne de commande à la barre de valeur serait /p:Foo = barreAn example of setting a project property Foo from the command line to value Bar would be /p:Foo=Bar
NUGET_RESTORE_MSBUILD_VERBOSITYNUGET_RESTORE_MSBUILD_VERBOSITY Définit le niveau de détail du journal MSBuild.Sets the MSBuild log verbosity. Valeur par défaut est silencieux (« / v : q »).Default is quiet ("/v:q"). Les valeurs possibles q [uiet], m [inimal], n [ormal], d [etailed], et diag [nostic].Possible values q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic].
NUGET_SHOW_STACKNUGET_SHOW_STACK Détermine si l’exception complète (y compris la trace de pile) doit être affichée à l’utilisateur.Determines whether the full exception (including stack trace) should be displayed to the user. Spécifié en tant que true ou false (valeur par défaut).Specified as true or false (default).
NUGET_XMLDOC_MODENUGET_XMLDOC_MODE Détermine comment l’extraction du fichier assemblys XML documentation doit être gérée.Determines how assemblies XML documentation file extraction should be handled. Modes pris en charge sont ignorer (ne pas extraire les fichiers de documentation XML), compresser (stocker les fichiers de document XML comme une archive zip) ou aucun (par défaut, traiter des fichiers de document XML comme standard fichiers).Supported modes are skip (do not extract XML documentation files), compress (store XML doc files as a zip archive) or none (default, treat XML doc files as regular files).
NUGET_CERT_REVOCATION_MODENUGET_CERT_REVOCATION_MODE Détermine comment pour vérifier l’état de révocation du certificat utilisé pour signer un package, est effectuée lorsqu’un package signé est installé ou restauré.Determines how the revocation status check of the certificate used to sign a package, is performed when a signed package is installed or restored. Si ne pas la valeur, valeur par défaut est online.When not set, defaults to online. Les valeurs possibles online (valeur par défaut), hors connexion.Possible values online (default), offline. Associées à NU3028Related to NU3028