Variabel lingkungan NuGet CLI

Perilaku CLI nuget.exe dapat dikonfigurasi melalui sejumlah variabel lingkungan, yang memengaruhi nuget.exe pada tingkat komputer, pengguna, atau proses. Variabel lingkungan selalu mengambil alih pengaturan apa pun dalam NuGet.Config file, memungkinkan server build mengubah pengaturan yang sesuai tanpa memodifikasi file apa pun.

Secara umum, opsi yang ditentukan langsung pada baris perintah atau dalam file konfigurasi NuGet memiliki prioritas, tetapi ada beberapa pengecualian seperti FORCE_NUGET_EXE_INTERACTIVE. Jika Anda menemukan bahwa nuget.exe berulah secara berbeda antara komputer yang berbeda, variabel lingkungan bisa menjadi penyebabnya. Misalnya, Azure Web Apps Kudu (digunakan selama penyebaran) telah NUGET_XMLDOC_MODE diatur untuk melompati untuk mempercepat performa pemulihan paket dan menghemat ruang disk.

NuGet CLI menggunakan MSBuild untuk membaca file proyek. Semua variabel lingkungan tersedia sebagai properti selama evaluasi MSBuild. Daftar properti yang didokumentasikan dalam paket NuGet dan pemulihan sebagai target MSBuild juga dapat ditetapkan sebagai variabel lingkungan.

Variabel	Deskripsi	Keterangan
http_proxy	Proksi http yang digunakan untuk operasi HTTP NuGet.	Ini akan ditentukan sebagai http://<username>:<password>@proxy.com.
no_proxy	Mengonfigurasi domain untuk melewati dari menggunakan proksi.	Ditentukan sebagai domain yang dipisahkan oleh koma (,).
AktifkanNuGetPackageRestore	Bendera untuk jika NuGet harus secara implisit memberikan persetujuan jika diperlukan oleh paket saat pemulihan.	Bendera yang ditentukan diperlakukan sebagai true atau 1, nilai lain yang diperlakukan sebagai bendera tidak diatur.
NUGET_CLI_LANGUAGE	Perubahan nuget.exe bahasa output	Tersedia dalam versi 6.5 dan yang lebih tinggi. Nilai yang didukung adalah nama lokal bahasa Visual Studio yang didukung: zh-cn, , , cs-czzh-tw, en-uses-es, fr-fr, , de-deit-it, , ja-jp, ko-kr, , pt-brpl-pl, , , ru-rudan .tr-tr
NUGET_EXE_NO_PROMPT	Mencegah exe untuk meminta kredensial.	Nilai apa pun kecuali string null atau kosong akan diperlakukan sebagai set/true bendera ini.
NUGET_MAX_RETRY_AFTER_DELAY_SECONDS	Durasi maksimum antara percobaan ulang saat respons HTTP berisi header Coba Lagi-Setelah	Ketika NUGET_OBSERVE_RETRY_AFTER diaktifkan (apa adanya secara default) dan respons HTTP berisi header Coba Lagi-Setelah, variabel lingkungan ini mengatur durasi maksimum yang akan ditunggu. Perhatikan bahwa Coba Lagi-Setelah dapat memberikan durasi (delta) atau stempel waktu (tanggal). Jika server mengembalikan stempel waktu dan jam komputer Anda tidak sinkron dengan server, durasi yang dihitung mungkin sangat panjang (atau negatif).
FORCE_NUGET_EXE_INTERACTIVE	Variabel lingkungan global untuk memaksa mode interaktif.	Nilai apa pun kecuali string null atau kosong akan diperlakukan sebagai set/true bendera ini.
NUGET_PACKAGES	Jalur yang akan digunakan untuk folder paket global seperti yang dijelaskan pada Mengelola paket global dan folder cache.	Ditentukan sebagai jalur absolut.
NUGET_FALLBACK_PACKAGES	Folder paket fallback global.	Jalur folder absolut dipisahkan oleh titik koma (;).
NUGET_HTTP_CACHE_PATH	Jalur yang akan digunakan untuk folder http-cache seperti yang dijelaskan pada Mengelola paket global dan folder cache.	Ditentukan sebagai jalur absolut.
NUGET_OBSERVE_RETRY_AFTER	Menolak menggunakan pesan respons HTTP Coba Lagi-Setelah durasi penundaan	Sebelum NuGet 6.5, NuGet akan mencoba kembali semua permintaan yang gagal dengan strategi back-off yang sama. Dimulai dengan NuGet 6.5, NuGet secara default akan menggunakan periode penundaan Coba Lagi Setelah disediakan oleh server. Atur variabel lingkungan ini ke false untuk mengabaikan header respons Coba Lagi-Setelah. Lihat juga NUGET_MAX_RETRY_AFTER_DELAY_SECONDS
NUGET_RESTORE_MSBUILD_ARGS	Mengatur argumen MSBuild tambahan.	Teruskan argumen yang identik dengan bagaimana Anda akan meneruskannya ke msbuild.exe. Contoh pengaturan properti proyek Foo dari baris perintah ke bilah nilai adalah /p:Foo=Bar
NUGET_RETRY_HTTP_429	Mengubah perilaku coba lagi pada respons HTTP 429	Sebelum NuGet 6.5, NuGet tidak akan mencoba kembali permintaan yang menghasilkan HTTP 429 pada 408. Nilai defaultnya adalah true, dan variabel lingkungan ini dapat diatur ke untuk false ikut serta ke perilaku NuGet yang lebih lama (jangan coba lagi permintaan)
NUGET_RESTORE_MSBUILD_VERBOSITY	Mengatur verbositas log MSBuild.	Defaultnya adalah diam ("/v:q"). Kemungkinan nilai q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic].
NUGET_SHOW_STACK	Menentukan apakah pengecualian penuh (termasuk pelacakan tumpukan) harus ditampilkan kepada pengguna.	Ditentukan sebagai true atau false (default).
NUGET_UPDATEFILETIME_MAXRETRIES	Mengatur berapa kali NuGet akan mencoba mengatur tanda waktu file saat mengekstrak paket.	Pada perangkat lunak anti-virus Windows mungkin membuka sementara berkas, mencegah NuGet mengubah tanda waktu. NuGet menggunakan back-off eksponensial di mana durasi tunggu antara upaya adalah Math.Pow(2, retryNumber). Percobaan ulang maks default adalah 9, yang berarti total durasi tunggu default sebelum kegagalan akan menjadi sekitar satu detik.
NUGET_XMLDOC_MODE	Menentukan bagaimana ekstraksi file dokumentasi XML rakitan harus ditangani.	Mode yang didukung dilewati (jangan ekstrak file dokumentasi XML), kompres (simpan file dokumen XML sebagai arsip zip) atau tidak ada (default, perlakukan file dokumen XML sebagai file reguler).
NUGET_CERT_REVOCATION_MODE	Menentukan bagaimana pemeriksaan status pencabutan sertifikat yang digunakan untuk menandatangani paket, dilakukan saat paket yang ditandatangani diinstal atau dipulihkan. Ketika tidak diatur, default ke online.	Nilai yang mungkin online (default), offline. Terkait dengan NU3028
NUGET_ENABLE_ENHANCED_HTTP_RETRY	Mengaktifkan atau menonaktifkan percobaan ulang HTTP yang ditingkatkan di NuGet.	Kemungkinan nilainya adalah true (default) atau false.
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT	Mengonfigurasi berapa kali koneksi HTTP harus dicoba kembali ketika percobaan ulang yang ditingkatkan diaktifkan.	Angka yang menunjukkan berapa banyak percobaan ulang yang akan dilakukan, nilai defaultnya adalah 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS	Mengonfigurasi jumlah waktu untuk menunggu dalam milidetik sebelum mencoba kembali koneksi HTTP saat percobaan ulang yang ditingkatkan diaktifkan.	Jumlah milsetik untuk menunggu, nilai defaultnya adalah 1000.
NUGET_EXPERIMENTAL_USE_NJ_FOR_FILE_PARSING	Menentukan apakah digunakan atau tidak Netwonsoft.Json untuk mengurai file aset selama pemulihan	Nilai yang mungkin adalah true atau false (default).