settings perintah (winget)

Perintah settingsWinGet memungkinkan Anda menyesuaikan pengalaman klien Windows Package Manager Anda. Anda dapat mengubah default dan mencoba fitur eksperimental yang tersedia di klien Anda.

Perintah settings akan meluncurkan editor JSON default Anda. Windows secara default akan meluncurkan Notepad sebagai opsi. Sebaiknya gunakan alat seperti Visual Studio Code.

Nota

Anda dapat dengan mudah menginstal Visual Studio Code dengan mengetik winget install Microsoft.VisualStudioCode

Nama Lain

Alias berikut tersedia untuk perintah ini:

  • config

Sub-perintah

Berbagai sub-perintah berikut tersedia.

Sub-Command Deskripsi
ekspor settingsEkspor .
mengatur Mengatur nilai pengaturan administrator.
Reset Mereset pengaturan administrator ke nilai defaultnya.

Opsi

Opsi berikut ini tersedia:

Argumen Deskripsi
--mengaktifkan Mengaktifkan pengaturan administrator yang ditentukan.
--menonaktifkan Menonaktifkan pengaturan administrator yang ditentukan.
-?,--bantuan Menampilkan bantuan tentang perintah terpilih.
--tunggu Meminta pengguna untuk menekan tombol apa pun sebelum keluar.
--logs,--open-logs Membuka lokasi log default.
--verbose,--verbose-logs Mengaktifkan pencatatan log terperinci untuk winget.
--nowarn (jangan tampilkan peringatan), --ignore-warnings (abaikan peringatan) Menghilangkan output peringatan.
--nonaktifkan-interaktivitas Menonaktifkan perintah interaktif.
--Proxy Mengatur proksi yang akan digunakan untuk eksekusi ini.
--no-proxy Menonaktifkan penggunaan proksi untuk eksekusi ini.

winget settings Gunakan perintah

Luncurkan alat pengeditan JSON default Anda: winget settings

Saat Anda menjalankan settings untuk pertama kalinya, belum ada settings yang ditentukan. Di bagian atas file JSON, kami menyediakan tautan Pengaturan WinGet CLI , di mana Anda dapat menemukan fitur eksperimental terbaru dan settings.

Cuplikan kode di bawah ini menunjukkan contoh seperti apa file Anda settings dengan modifikasi output visual dan fitur eksperimental diaktifkan.

{
    "$schema": "https://aka.ms/winget-settings.schema.json",

    "visual": {
        "enableSixels": true,
        "progressBar": "rainbow"
    },
    "experimentalFeatures": {
        "experimentalARG": true,
        "experimentalCMD": true
    }
}

Kami juga telah menentukan skema untuk file tersebut settings . Ini memungkinkan Anda menggunakan TAB untuk menemukan settings dan sintaksis jika editor JSON Anda mendukung skema JSON.

Sedang memperbarui settings

Berikut settings tersedia untuk rilis 1.28 dari Windows Package Manager.

Sumber settings

source settings melibatkan konfigurasi pada sumber WinGet.

"source": {
    "autoUpdateIntervalInMinutes": 60
},

IntervalPembaruanOtomatisDalamMenit

Bilangan bulat positif mewakili interval pembaruan dalam hitungan menit. Pemeriksaan pembaruan hanya terjadi ketika sumber digunakan. Nilai nol akan menonaktifkan pemeriksaan pembaruan terhadap sebuah sumber. Nilai lain tidak valid.

  • Nonaktifkan: 0
  • Bawaan: 15

Untuk memperbarui sumber secara manual gunakan winget source update.

visual settings

visual settings melibatkan elemen visual yang ditampilkan oleh WinGet

"visual": {
    "enableSixels": true,
    "progressBar": "rainbow"
},

bilah kemajuan

Warna bilah kemajuan yang ditampilkan WinGet ketika tidak ditentukan oleh argumen.

  • aksen (default)
  • pelangi
  • Retro
  • sixel
  • dinonaktifkan

anonimkanJalurYangDitampilkan

Mengganti beberapa jalur folder yang diketahui dengan variabel lingkungan masing-masing.

aktifkan Sixels

Memungkinkan penggunaan keluaran gambar sixel dalam konteks tertentu.

pencatatan log settings

logging settings mengontrol tingkat detail dalam file log. --verbose-logs akan mengambil alih pengaturan ini dan selalu membuat log verbose.

"logging": {
    "level": "verbose"
}

level

Tingkat pengelogan berikut tersedia. Akan menggunakan info jika nilai tidak diatur atau tidak valid.

  • penyedehanaan kata
  • Info
  • peringatan
  • galat
  • kritis

channels

Pengaturan channels membatasi output pengelogan ke saluran log tertentu. Nilai default khusus (kumpulan saluran default) dan all (semua saluran) juga diterima. Nilai yang tidak valid diabaikan.

"logging": {
    "channels": ["default"]
}

berkas

file settings mengontrol pembersihan otomatis file log di direktori log bawaan. Pembersihan berjalan pada awal setiap proses WinGet dan hanya berlaku untuk lokasi log default.

Setting Deskripsi Default
ageLimitInDays Usia maksimum file dalam satuan hari pada direktori log; file yang lebih tua akan dihapus. Atur ke 0 untuk menonaktifkan. 7
totalSizeLimitInMB Ukuran total maksimum dalam megabyte semua file di direktori log; file terlama dihapus terlebih dahulu. Atur ke 0 untuk menonaktifkan. 128
countLimit Jumlah maksimum file dalam direktori log; file terlama dihapus terlebih dahulu. Atur ke 0 untuk menonaktifkan. 0 (dinonaktifkan)
individualSizeLimitInMB Ukuran maksimum dalam megabyte dari satu file log. Jika file akan melebihi batas ini, bungkus log. Atur ke 0 untuk menonaktifkan. 16 
"logging": {
    "level": "verbose",
    "file": {
        "ageLimitInDays": 7,
        "totalSizeLimitInMB": 128,
        "countLimit": 0,
        "individualSizeLimitInMB": 16
    }
}

preferensi dan persyaratan settings

Beberapa settings diduplikasi di bawah preferences dan requirements.

  • preferences Pengaturan mengontrol bagaimana berbagai opsi yang tersedia diurutkan saat memilih opsi yang akan ditindaklanjuti. Misalnya, cakupan default penginstalan paket adalah untuk pengguna saat ini, tetapi jika itu bukan opsi, penginstal tingkat komputer akan dipilih.
  • Pengaturan requirements memfilter opsi, berpotensi mengakibatkan daftar kosong dan kegagalan untuk menginstal. Dalam contoh sebelumnya, persyaratan cakupan pengguna akan menghasilkan tidak adanya penginstal yang berlaku dan menyebabkan kesalahan.

Setiap argumen yang diteruskan pada baris perintah akan secara efektif menggantikan pengaturan requirement yang cocok selama durasi perintah tersebut.

cakupan

Perilaku scope mengontrol pilihan antara menginstal paket untuk pengguna saat ini atau untuk seluruh komputer. Parameter yang cocok adalah --scope, dan menggunakan nilai yang sama (user atau machine). Lihat masalah yang diketahui yang terkait dengan cakupan penginstalan paket.

"installBehavior": {
    "preferences": {
        "scope": "user"
    }
},

lokal

Perilaku locale mengontrol pilihan alat penginstal berdasarkan lokal alat penginstal. Parameter yang cocok adalah --localedan menggunakan tag bahasa BCP47.

"installBehavior": {
    "preferences": {
        "locale": [ "en-US", "fr-FR" ]
    }
},

Arsitektur

Perilaku architectures mengontrol arsitektur apa yang akan dipilih saat menginstal paket. Parameter yang sesuai adalah --architecture. Hanya arsitektur yang kompatibel dengan sistem Anda yang dapat dipilih.

    "installBehavior": {
        "preferences": {
            "architectures": ["x64", "arm64"]
        }
    },

jenis penginstal

Perilaku installerTypes memengaruhi jenis penginstal yang akan dipilih saat menginstal paket. Ini juga dapat menentukan jenis mana yang akan diinstal secara default jika manifes memiliki beberapa jenis: Daftar berada dalam urutan prioritas, dengan jenis pertama yang tercantum lebih disukai daripada yang lain, dan sebagainya. Ini nyaman bagi pengguna yang misalnya lebih suka paket portabel atau penginstalan MSIX/AppX. Parameter yang cocok adalah --installer-type, yang akan mengambil alih settings.

Nilai yang diizinkan pada versi 1.12.470 meliputi: appx, , , burnexe, fontinnomsimsix, msstore, nullsoft, , , portablewixzip

Secara default, dan dengan semua properti lain sama, WinGet akan memilih jenis penginstal yang tercantum terlebih dahulu dalam YAML manifes penginstal jika paket belum diinstal. Jika sudah diinstal, jenis alat penginstal yang sama akan diperlukan untuk memastikan peningkatan yang tepat.

    "installBehavior": {
        "preferences": {
            "installerTypes": ["msix", "msi"]
        }
    },

installBehavior settings

installBehavior settings mengendalikan perilaku bawaan pemasangan dan pemutakhiran paket (jika berlaku).

disableInstallNotes

Pengaturan disableInstallNotes menentukan apakah catatan penginstalan ditampilkan setelah penginstalan berhasil. Default ke false jika nilai tidak diatur atau tidak valid.

    "installBehavior": {
        "disableInstallNotes": true
    },

pengaturan portablePackageUserRoot

Pengaturan portablePackageUserRoot menentukan direktori akar default untuk menginstal paket dalam cakupan User. Ini hanya berlaku untuk paket dengan portable jenis alat penginstal. Default ke %LOCALAPPDATA%/Microsoft/WinGet/Packages/ jika nilai tidak diatur atau tidak valid.

Nilai pengaturan ini harus merupakan jalur absolut.

    "installBehavior": {
        "portablePackageUserRoot": "C:/Users/FooBar/Packages"
    },

pengaturan portablePackageMachineRoot

Pengaturan portablePackageMachineRoot menentukan direktori akar default untuk menginstal paket dalam cakupan Machine. Ini hanya berlaku untuk paket dengan portable jenis alat penginstal. Akan menggunakan %PROGRAMFILES%/WinGet/Packages/ jika nilai tidak diatur atau tidak valid.

Nilai pengaturan ini harus merupakan jalur absolut.

    "installBehavior": {
        "portablePackageMachineRoot": "C:/Program Files/Packages/Portable"
    },

defaultInstallRoot

Pengaturan defaultInstallRoot menentukan lokasi penginstalan default untuk paket yang memerlukan jalur penginstalan eksplisit, jika lokasi penginstalan tidak ditentukan.

maxResumes

Pengaturan maxResumes menentukan jumlah maksimum upaya resume yang diizinkan untuk satu ID resume. Ini mencegah reboot berkelanjutan jika penginstalan yang memerlukan boot ulang tidak terdeteksi dengan benar.

archiveExtractionMethod

Pengaturan archiveExtractionMethod mengontrol bagaimana alat penginstal mengekstrak arsip. Nilai yang didukung adalah shellApi dan tar.

  • shellApi menggunakan WINDOWS Shell API untuk mengekstrak arsip.

  • tar menggunakan perintah tar untuk mengekstrak arsip.

PerilakuPenghapusanInstalan

Pengaturan uninstallBehavior mengontrol apakah proses penghapusan instalasi default menghapus semua file dan direktori yang relevan dengan paket ini. Hanya berlaku untuk portabel installerType.

bersihkanPaketPortabel

Pengaturan purgePortablePackage mengontrol perilaku default untuk menghapus instalan paket portabel. Jika diatur ke true, hapus instalan akan menghapus semua file dan direktori yang relevan dengan portable paket. Pengaturan ini hanya berlaku untuk paket dengan portable jenis alat penginstal. Default ke false jika nilai tidak diatur atau tidak valid.

    "uninstallBehavior": {
        "purgePortablePackage": true
    },

Mengonfigurasi Perilaku

Pengaturan ConfigureBehavior menentukan direktori akar default tempat modul PowerShell diinstal saat menerapkan konfigurasi.

Perilaku Unduhan

downloadBehavior settings mengatur direktori bawaan tempat penginstal diunduh.

defaultDownloadDirectory

Pengaturan defaultDownloadDirectory mengontrol direktori default tempat paket diunduh. Default ke %USERPROFILE%/Downloads jika nilai tidak diatur atau tidak valid.

Nilai pengaturan ini harus merupakan jalur absolut.

    "downloadBehavior": {
        "defaultDownloadDirectory": "C:/Users/FooBar/Downloads"
    },

Telemetri settings

telemetry settings menentukan apakah WinGet mencatat peristiwa ETW yang mungkin dikirim ke Microsoft pada instalasi default Windows.

Lihat detail tentang telemetri, dan pernyataan privasi utama kami.

nonaktifkan

"telemetry": {
    "disable": true
},

Jika diatur ke true, telemetry.disable pengaturan akan mencegah kejadian ditulis oleh program.

Jaringan settings

network settings memengaruhi cara WinGet menggunakan jaringan untuk mengambil paket dan metadata.

pengunduh

Pengaturan downloader mengontrol kode mana yang digunakan saat mengunduh paket. Defaultnya adalah do, yang mungkin dikelola oleh Kebijakan Grup.

wininet menggunakan API WinINet , saat do menggunakan layanan Pengoptimalan Pengiriman .

"network": {
    "downloader": "wininet"
}

doProgressTimeoutInSeconds

doProgressTimeoutInSeconds menentukan jumlah detik untuk menunggu tanpa kemajuan sebelum fallback.

Interaktivitas

Interactivity Pengaturan mengontrol apakah perintah interaktif ditampilkan oleh klien Pengelola Paket Windows.

Mengaktifkan fitur eksperimental

Untuk menemukan fitur eksperimental mana yang tersedia, buka https://aka.ms/wingethttps://aka.ms/winget-settings tempat Anda dapat melihat fitur eksperimental yang tersedia untuk Anda.

experimentalFeatures settings melibatkan konfigurasi fitur "eksperimental" ini. Fitur individual dapat diaktifkan di bawah simpul ini:

"experimentalFeatures": {
    "directMSI": true,
    "resume": true
}

directMSI

Fitur ini memungkinkan Pengelola Paket Windows untuk langsung menginstal paket MSI dengan API MSI daripada melalui msiexec. Perhatikan bahwa ketika penginstalan senyap digunakan, ini sudah berlaku, karena paket MSI yang memerlukan elevasi akan gagal dalam skenario tersebut tanpanya.

"experimentalFeatures": {
    "directMSI": true
}

lanjutkan

Fitur ini memungkinkan dukungan untuk beberapa perintah untuk dilanjutkan setelah boot ulang.

"experimentalFeatures": {
    "resume": true
}

Font

Fitur ini memungkinkan dukungan untuk font melalui winget settings. Perintah winget font list akan mencantumkan keluarga font yang diinstal dan jumlah wajah font yang diinstal.

"experimentalFeatures": {
    "fonts": true
}

sourcePriority

Fitur ini memungkinkan sumber memiliki nilai prioritas yang ditetapkan. Sumber dengan prioritas yang lebih tinggi akan muncul sebelumnya di hasil pencarian dan akan dipilih untuk menginstal paket baru ketika beberapa sumber memiliki paket yang cocok.

Perhatikan bahwa pengurutan hasil pencarian tergantung pada beberapa faktor, dan prioritas sumber adalah bidang terendah saat ini (kualitas dan bidang pencocokan lebih penting).

"experimentalFeatures": {
    "sourcePriority": true
}
  • Last updated on