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)	Menekan 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 ini tersedia untuk rilis 1.11 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
• Default: 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.

enableSizels

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

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 mengontrol jenis penginstal apa yang akan dipilih saat menginstal paket. Parameter yang sesuai adalah --installer-type.

    "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 utama default untuk menginstal paket pada 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.