perintah pengaturan (winget)

Perintah pengaturan alat winget memungkinkan Anda menyesuaikan pengalaman klien Pengelola Paket Windows Anda. Anda dapat mengubah default dan mencoba fitur eksperimental yang diaktifkan di klien Anda.

Perintah pengaturan akan meluncurkan editor teks default Anda. Windows secara default akan meluncurkan Notepad sebagai opsi. Sebaiknya gunakan alat seperti kode Visual Studio.

Alias

Alias berikut tersedia untuk perintah ini:

• config

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 tempat Anda dapat menemukan fitur dan pengaturan eksperimental terbaru.

Cuplikan kode di bawah ini adalah contoh seperti apa file pengaturan Anda jika Anda ingin mengaktifkan atau memodifikasi beberapa fitur dan pengaturan eksperimental ini.

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

    // For documentation on these settings, see: https://aka.ms/winget-settings
    "experimentalFeatures": {
	  "dependencies": true,
	  "directMSI": false,
	  "zipInstall": false,
    },
    "visual": {
        "progressBar": "rainbow"
    },
    "source": {
        "autoUpdateIntervalInMinutes": 5
    },
}

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.0 Pengelola Paket Windows.

pengaturan sumber

Pengaturan source melibatkan konfigurasi ke sumber WinGet.

"source": {
    "autoUpdateIntervalInMinutes": 3
},

autoUpdateIntervalInMinutes

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

• Nonaktifkan: 0
• Default: 5

Untuk memperbarui penggunaan winget source updatesumber secara manual .

pengaturan visual

Pengaturan visual melibatkan elemen visual yang ditampilkan oleh WinGet

"visual": {
    "progressBar": "accent"
},

bilah kemajuan

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

• aksen (default)
• retro
• pelangi

pengaturan installBehavior

Pengaturan installBehavior memengaruhi perilaku default menginstal dan meningkatkan paket (jika berlaku).

disableInstallNotes

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

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

pengaturan portablePackageUserRoot

Pengaturan memengaruhi portablePackageUserRoot direktori akar default tempat paket diinstal di bawah User cakupan. Pengaturan ini hanya berlaku untuk paket dengan portable jenis alat penginstal. Default ke %LOCALAPPDATA%/Microsoft/WinGet/Packages/ jika nilai tidak diatur atau tidak valid.

Catatan: Nilai pengaturan ini harus merupakan jalur absolut.

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

pengaturan portablePackageMachineRoot

Pengaturan memengaruhi portablePackageMachineRoot direktori akar default tempat paket diinstal di bawah Machine cakupan. Pengaturan ini hanya berlaku untuk paket dengan portable jenis alat penginstal. Default ke %PROGRAMFILES%/WinGet/Packages/ jika nilai tidak diatur atau tidak valid.

Catatan: Nilai pengaturan ini harus merupakan jalur absolut.

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

pengaturan preferensi dan persyaratan

Beberapa pengaturan diduplikasi di bawah preferences dan requirements.

• Pengaturan preferences memengaruhi 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 tidak akan mengakibatkan penginstal dan kesalahan yang berlaku.

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

cakupan

Perilaku memengaruhi scope 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 umum yang berkaitan dengan cakupan penginstalan paket.

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

lokal

Perilaku memengaruhi locale pilihan alat penginstal berdasarkan lokal alat penginstal. Parameter yang cocok adalah --locale, dan menggunakan tag bahasa bcp47.

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

Arsitektur

Perilaku memengaruhi architectures arsitektur apa yang akan dipilih saat menginstal paket. Parameter yang cocok adalah --architecture. Perhatikan bahwa hanya arsitektur yang kompatibel dengan sistem Anda yang dapat dipilih.

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

installerTypes

Perilaku memengaruhi installerTypes jenis alat penginstal apa yang akan dipilih saat menginstal paket. Parameter yang cocok adalah --installer-type.

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

uninstallBehavior

Pengaturan uninstallBehavior memengaruhi perilaku default menghapus instalan (jika berlaku).

purgePortablePackage

Perilaku memengaruhi purgePortablePackage 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
    },

downloadBehavior

Pengaturan downloadBehavior memengaruhi perilaku default mengunduh paket.

defaultDownloadDirectory

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

Catatan: Nilai pengaturan ini harus merupakan jalur absolut.

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

pengaturan telemetri

Pengaturan telemetry mengontrol apakah winget menulis peristiwa ETW yang mungkin dikirim ke Microsoft pada penginstalan 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.

pengaturan jaringan

Pengaturan network memengaruhi bagaimana winget menggunakan jaringan untuk mengambil paket dan metadata.

downloader

Pengaturan downloader mengontrol kode mana yang digunakan saat mengunduh paket. Defaultnya adalah default, yang mungkin merupakan salah satu opsi berdasarkan penentuan kami.

wininetmenggunakan API WinINet, saat do menggunakan layanan Pengoptimalan Pengiriman.

"network": {
    "downloader": "do"
}

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

tingkat

Tingkat pengelogan berikut tersedia. Default ke info jika nilai tidak diatur atau tidak valid.

• verbose
• info
• peringatan
• kesalahan
• critical

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.