perintah upgrade (winget)

Perintah peningkatan alat WinGet meningkatkan aplikasi yang ditentukan. Secara opsional, Anda dapat menggunakan perintah daftar untuk mengidentifikasi aplikasi yang ingin Anda tingkatkan.

Perintah peningkatan mengharuskan Anda menentukan string yang tepat untuk ditingkatkan. Jika ada ambiguitas, Anda akan diminta untuk memfilter perintah peningkatan lebih lanjut ke aplikasi yang tepat.

Alias

Alias berikut tersedia untuk perintah ini:

• perbarui

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 pengalaman peningkatan untuk memenuhi kebutuhan Anda.

Opsi	Deskripsi
-m, --manifest	Harus diikuti dengan jalur ke file manifes (YAML). Anda dapat menggunakan manifes untuk menjalankan pengalaman peningkatan dari file YAML lokal.
--Id	Membatasi pembaruan ke 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 untuk ditingkatkan. Jika tidak ditentukan, yang terbaru akan meningkatkan aplikasi 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. Antarmuka default menunjukkan kemajuan proses penginstalan.
--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 untuk ditingkatkan ke (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 untuk dimutakhirkan. 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	Uninstal versi aplikasi sebelumnya selama pemutakhiran. 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 dengan peningkatan 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 meningkatkan beberapa aplikasi.

winget upgrade Microsoft.Edit Microsoft.NuGet

Menggunakan upgrade

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

perbarui --all

upgrade --all akan meningkatkan semua aplikasi yang diinstal yang memiliki pembaruan yang tersedia. Ketika Anda menjalankan winget upgrade --all, Pengelola Paket Windows akan mencari semua aplikasi yang memiliki pembaruan tersedia dan berusaha untuk menginstal pembaruan tersebut. Gunakan peningkatan tanpa argumen terlebih dahulu untuk mempratinjau aplikasi mana yang akan ditingkatkan.

Catatan

Beberapa aplikasi tidak menyediakan versi. Mereka selalu yang terbaru. Karena Pengelola Paket Windows tidak dapat mengidentifikasi apakah ada versi aplikasi yang lebih baru, peningkatan 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.

tingkatkan --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 alat penginstal dirancang untuk menginstal versi baru secara berdampingan, sedangkan alat penginstal lainnya menyertakan manifes yang menentukan uninstallPrevious sebagai perilaku peningkatan default mereka (sehingga versi sebelumnya dihapus instalasinya tanpa perlu menggunakan flag perintah).

Jika manifes paket tidak termasuk uninstallPrevious sebagai perilaku peningkatan dan flag --uninstall-previous tidak digunakan dengan perintah peningkatan, maka perilaku default untuk penginstal akan berlaku.