perintah pengaturan (winget)

Perintah pengaturanWinGet memungkinkan Anda menyesuaikan pengalaman klien Pengelola Paket Windows Anda. Anda dapat mengubah default dan mencoba fitur eksperimental yang tersedia di klien Anda.

Perintah pengaturan 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:

  • konfig

Sub-perintah

Berbagai sub-perintah berikut tersedia.

Sub-Command Deskripsi
ekspor Pengaturan ekspor
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 pengelogan verbose 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.

Gunakan perintah pengaturan winget

Luncurkan alat pengeditan JSON default Anda: winget settings

Ketika Anda meluncurkan pengaturan untuk pertama kalinya, tidak akan ada pengaturan yang ditentukan. Di bagian atas file JSON, kami menyediakan tautan Pengaturan CLI WinGet , tempat Anda dapat menemukan fitur dan pengaturan eksperimental terbaru.

Cuplikan kode di bawah ini menunjukkan contoh seperti apa file pengaturan Anda 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 pengaturan. Ini memungkinkan Anda menggunakan TAB untuk menemukan pengaturan dan sintaksis jika editor JSON Anda mendukung skema JSON.

Memperbarui pengaturan

Pengaturan berikut tersedia untuk rilis 1.28 Pengelola Paket Windows.

pengaturan sumber

Pengaturan source melibatkan konfigurasi ke 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.

pengaturan visual

Pengaturan visual 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.

pengaturan pengelogan

Pengaturan logging 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

Pengaturan file mengontrol pembersihan otomatis file log di direktori log default. 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
    }
}

pengaturan preferensi dan persyaratan

Beberapa pengaturan diduplikasi pada 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 sesuai adalah --installer-type, yang akan menggantikan pengaturan.

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"]
        }
    },

pengaturan installBehavior

Pengaturan installBehavior mengontrol perilaku default menginstal dan meningkatkan 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

Pengaturan downloadBehavior mengontrol direktori default 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"
    },

Pengaturan telemetri

Pengaturan telemetry mengontrol apakah WinGet mencatat peristiwa ETW yang mungkin dikirim ke Microsoft pada penginstalan Windows secara default.

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.

Pengaturan jaringan

Pengaturan network memengaruhi bagaimana 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/winget-settings tempat Anda dapat melihat fitur eksperimental yang tersedia untuk Anda.

Pengaturan experimentalFeatures 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