upgrade perintah (winget)

upgrade Perintah alat WinGet meningkatkan aplikasi yang ditentukan. Opsional, Anda dapat menggunakan perintah list untuk mengidentifikasi aplikasi yang ingin Anda upgrade.

Perintah upgrade mengharuskan Anda menentukan string yang tepat ke upgrade. Jika terjadi ambiguitas, Anda akan diminta untuk memfilter perintah upgrade lebih lanjut agar mengarah ke aplikasi yang spesifik.

Alias

Alias berikut tersedia untuk perintah ini:

• update

Penggunaan

winget upgrade [[-q] <query> ...] [<options>]

Argumen

Argumen berikut tersedia.

Argumen	Deskripsi
-q,--query	Kueri yang digunakan untuk mencari aplikasi.

Catatan

Argumen kueri bersifat posisional. Sintaks gaya kartubebas tidak didukung. Ini paling sering adalah string karakter yang Anda harapkan untuk membantu menemukan paket yang Anda perbarui.

Opsi

Opsi ini memungkinkan Anda menyesuaikan upgrade pengalaman untuk memenuhi kebutuhan Anda.

Opsi	Deskripsi
-m, --manifest	Harus diikuti dengan jalur ke file manifes (YAML). Anda dapat menggunakan manifes untuk menjalankan pengalaman upgrade dari file YAML lokal.
--Id	Membatasi upgrade pada ID aplikasi.
--Nama	Membatasi pencarian pada nama ID aplikasi.
--Moniker	Membatasi pencarian ke moniker yang terdaftar untuk aplikasi.
-v, --version	Memungkinkan Anda menentukan versi yang tepat ke upgrade. Jika tidak ditentukan, yang terbaru akan upgrade menjadi aplikasi dengan versi tertinggi.
-s, --source	Membatasi pencarian ke nama sumber yang disediakan. Harus diikuti dengan nama sumber.
-e, -- yang tepat	Menggunakan string yang tepat dalam kueri, termasuk memeriksa sensitivitas huruf besar/kecil. Ini tidak akan menggunakan perilaku default dari substring.
-i, --interaktif	Menjalankan alat penginstal dalam mode interaktif. Tampilan standar menunjukkan kemajuan instalasi.
-h, -- senyap	Menjalankan alat penginstal dalam mode diam. Ini menonaktifkan semua UI. Tampilan standar menunjukkan kemajuan instalasi.
--membersihkan	Menghapus semua file dan direktori dalam direktori paket (portabel)
-o, --log	Mengarahkan pencatatan ke berkas log. Anda harus menyediakan jalan ke file yang hak tulisnya Anda miliki.
--kustom	Argumen yang akan diteruskan ke alat penginstal selain default.
--mengganti	String yang akan diteruskan langsung ke alat penginstal.
-l, --location (lokasi)	Lokasi ke upgrade (jika didukung).
--ruang lingkup	Pilih filter cakupan paket yang diinstal (pengguna atau mesin).
a, --arsitektur	Pilih arsitektur yang akan diinstal.
--installer-type	Pilih jenis alat penginstal ke upgrade. Lihat jenis penginstal yang didukung untuk klien WinGet.
--lokalisasi	Menentukan lokal mana yang akan digunakan (format BCP47).
--abaikan-hash-keamanan	Abaikan kegagalan pemeriksaan hash penginstal. Tidak direkomendasikan.
--allow-reboot (izinkan restart)	Memungkinkan boot ulang jika berlaku.
--skip-dependencies	Melewati dependensi paket pemrosesan dan fitur Windows.
--abaikan-pemindaian-malware-arsip-lokal	Abaikan pemindaian malware yang dilakukan sebagai bagian dari menginstal paket jenis arsip dari manifes lokal.
--menerima-perjanjian-paket	Digunakan untuk menerima perjanjian lisensi, dan menghindari perintah.
--terima-persetujuan-sumber	Digunakan untuk menerima perjanjian lisensi kode sumber, dan menghindari tampilan konfirmasi.
--Header	Header HTTP opsional untuk sumber REST pada Windows-Package-Manager.
--authentication-mode	Tentukan preferensi jendela autentikasi (senyap, silentPreferred atau interaktif).
--akun-autentikasi	Tentukan akun yang akan digunakan untuk autentikasi.
-r, --recurse, --all	Tingkatkan semua paket yang diinstal ke versi terbaru jika tersedia.
-u, --tidak-diketahui, --termasuk-tidak-diketahui	Tingkatkan paket meskipun versinya saat ini tidak dapat ditentukan.
--pinned,--include-pinned	Tingkatkan paket bahkan jika mereka memiliki pin non-pemblokiran.
--uninstall- sebelumnya	Copot pemasangan versi paket sebelumnya saat upgrade. Perilaku akan bergantung pada paket individual. Beberapa alat penginstal dirancang untuk menginstal versi baru secara berdampingan. Beberapa penginstal menyertakan manifes yang menentukan "uninstallPrevious" sehingga versi sebelumnya dihapus instalasinya tanpa perlu menggunakan bendera perintah ini. Dalam hal ini, menggunakan winget upgrade --uninstall-previous perintah akan memberi tahu WinGet untuk menghapus instalan versi sebelumnya terlepas dari apa yang ada dalam manifes paket. Jika manifes paket tidak menyertakan "uninstallPrevious" dan bendera --uninstall-previous tidak digunakan, maka perilaku default untuk alat penginstal akan berlaku.
--force	Jalankan perintah secara langsung dan lanjutkan dengan masalah terkait non-keamanan.
-?,--bantuan	Menampilkan bantuan tentang perintah terpilih.
--Tunggu	Meminta pengguna untuk menekan tombol apa pun sebelum keluar.
--logs,--open-logs	Buka lokasi log default.
--verbose, --verbose-logs	Digunakan untuk mengambil alih pengaturan pengelogan dan membuat log verbose.
--nowarn (jangan tampilkan peringatan), --ignore-warnings (abaikan peringatan)	Menyembunyikan keluaran peringatan.
--nonaktifkan-interaktivitas	Nonaktifkan perintah interaktif.
--Proxy	Atur proksi yang akan digunakan untuk eksekusi ini.
--no-proxy	Nonaktifkan penggunaan proksi untuk eksekusi ini.

Contoh kueri

Contoh berikut mencantumkan aplikasi yang memiliki upgrade yang tersedia.

winget upgrade

Contoh berikut meningkatkan versi aplikasi tertentu.

winget upgrade powertoys --version 0.15.2

Contoh berikut meningkatkan aplikasi menggunakan ID-nya.

winget upgrade --id Microsoft.PowerToys

Contoh berikut menunjukkan peningkatan semua aplikasi.

winget upgrade --all

Contoh berikut akan upgrade beberapa aplikasi.

winget upgrade Microsoft.Edit Microsoft.NuGet

Menggunakan upgrade

Untuk mengidentifikasi aplikasi mana yang membutuhkan update, cukup gunakan upgrade tanpa argumen apa pun untuk menampilkan semua peningkatan yang tersedia.

upgrade --Semua

upgrade --all akan upgrade semua aplikasi yang terinstal yang memiliki update yang tersedia. Saat Anda menjalankan wingetupgrade --all, Windows Package Manager mencari semua aplikasi yang memiliki pembaruan yang tersedia dan mencoba menginstal pembaruan. Gunakan upgrade tanpa argumen apa pun terlebih dahulu untuk mempratinjau aplikasi mana yang akan ditingkatkan.

Catatan

Beberapa aplikasi tidak menyediakan versi. Mereka selalu yang terbaru. Karena Windows Package Manager tidak dapat mengidentifikasi apakah ada versi aplikasi yang lebih baru, upgrade tidak akan dimungkinkan kecuali opsi -u, --unknown, --include-unknown ditentukan

Catatan

Beberapa aplikasi mungkin telah disematkan menggunakan WinGet dan tidak akan diperbarui jika opsi --all dipilih kecuali opsi --include-pinned dipilih. Dalam hal ini, hanya aplikasi yang tidak memblokir pin yang akan ditingkatkan.

upgrade --uninstall-previous

upgrade --uninstall-previous akan menghapus instalan versi sebelumnya sebelum menginstal versi paket yang lebih baru. Saat menggunakan --uninstall-previous, perilaku akan bergantung pada paket individual. Beberapa penginstal dirancang untuk menginstal versi baru secara berdampingan sementara penginstal lain menyertakan manifes yang menentukan uninstallPrevious sebagai perilaku default upgrade mereka (sehingga versi sebelumnya dihapus instalasinya tanpa perlu menggunakan bendera perintah).

Jika manifes paket tidak mencantumkan uninstallPrevious sebagai perilaku upgrade dan bendera --uninstall-previous tidak digunakan dengan perintah upgrade, perilaku bawaan penginstal akan diterapkan.