pin perintah (winget)

Perintah ini wingetpin memungkinkan Anda membatasi Windows Package Manager meningkatkan paket ke rentang versi tertentu, atau dapat mencegahnya meningkatkan paket sama sekali. Paket yang disematkan mungkin masih upgrade sendiri dan ditingkatkan dari luar Windows Package Manager.

Jenis Pin

WinGet mendukung tiga jenis pin paket:

• Penyematan: Paket dikecualikan dari winget upgrade --all tetapi memungkinkan winget upgrade <package>. Anda dapat menggunakan --include-pinned argumen untuk membiarkan winget upgrade --all menyertakan paket yang disematkan.

• Pemblokiran: Paket diblokir dari winget upgrade --all atau winget upgrade <package>, Anda harus melepaskan semat paket untuk membiarkan WinGet melakukan upgrade. Opsi --force dapat digunakan untuk mengambil pinalih perilaku.

• Gating: Paket disematkan ke versi atau rentang versi tertentu. Anda dapat menentukan versi yang tepat yang Anda inginkan agar paket disematkan atau Anda dapat menggunakan karakter * kartubebas sebagai bagian versi terakhir untuk menentukan rentang versi. Misalnya, jika paket disematkan ke versi 1.2.*, versi apa pun di antaranya 1.2.01.2.x dianggap valid. Opsi --force dapat digunakan untuk mengambil pinalih perilaku.

Penggunaan

winget pin <subcommand> <options>

Opsi

Opsi berikut ini tersedia.

Opsi	Deskripsi
-?, --help	Mendapatkan bantuan tambahan pada perintah ini.
--wait	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, --ignore-warnings	Menekan output peringatan.
--disable-interactivity	Nonaktifkan perintah interaktif.
--proxy	Atur proksi yang akan digunakan untuk eksekusi ini.
--no-proxy	Nonaktifkan penggunaan proksi untuk eksekusi ini.

Subperintah

Perintah pin mendukung sub-perintah berikut.

Subperintah	Deskripsi
add	Tambahkan baru pin.
remove	Hapus paket pin.
list	Mencantumkan pin saat ini.
reset	Mereset pin

tambahkan

add Sub-perintah menambahkan baru pin. Sub perintah ini mengharuskan Anda menentukan paket yang tepat ke pin. Jika ada ambiguitas, Anda akan diminta untuk memfilter add sub-perintah lebih lanjut ke aplikasi yang tepat.

Penggunaan:

winget pin add [[-q] <query>] [<options>]

Argumen

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

Opsi

Opsi ini memungkinkan Anda menyesuaikan penambahan pin untuk memenuhi kebutuhan Anda.

Opsi	Deskripsi
--id	Membatasi pencarian ke ID aplikasi.
--name	Membatasi pencarian pada nama ID aplikasi.
--moniker	Membatasi pencarian ke moniker yang terdaftar untuk aplikasi.
--tag	Membatasi pencarian ke tag yang tercantum untuk aplikasi.
--cmd, --command	Membatasi pencarian ke perintah aplikasi.
-e, --exact	Menggunakan string yang tepat dalam kueri, termasuk memeriksa sensitivitas huruf besar/kecil. Hal ini tidak akan menggunakan perilaku default substring.
-v, --version	Memungkinkan Anda menentukan versi yang tepat ke pin. Wildcard * dapat digunakan sebagai bagian versi terakhir. Mengubah pin perilaku menjadi gating.
-s, --source	Membatasi pencarian ke nama sumber yang disediakan. Harus diikuti dengan nama sumber.
--header	Header HTTP sumber REST Windows-Package-Manager opsional.
--authentication-mode	Tentukan preferensi jendela autentikasi (senyap, silentPreferred atau interaktif).
--authentication-account	Tentukan akun yang akan digunakan untuk autentikasi.
--accept-source-agreements	Digunakan untuk menerima perjanjian lisensi sumber, dan menghindari perintah.
--force	Jalankan perintah secara langsung dan lanjutkan dengan masalah terkait non-keamanan.
--blocking	Blokir agar tidak memutakhirkan hingga pin dihapus, mencegah penimpaan argumen. Mengubah pin perilaku menjadi blocking.
--installed	Menyematkan versi tertentu yang terinstal
-?, --help	Dapatkan bantuan tambahan pada perintah ini.
--wait	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, --ignore-warnings	Menekan output peringatan.
--disable-interactivity	Nonaktifkan perintah interaktif.
--proxy	Atur proksi yang akan digunakan untuk eksekusi ini.
--no-proxy	Nonaktifkan penggunaan proksi untuk eksekusi ini.

Contoh

Contoh berikut menambahkan pin untuk aplikasi. Menambahkan ini pin akan mencegah paket ini ditingkatkan saat memanggil winget upgrade --all. --include-pinned Gunakan argumen dengan winget upgrade --all untuk menyertakan paket yang disematkan.

winget pin add powertoys

Contoh berikut menambahkan pemblokiran pin untuk aplikasi menggunakan ID-nya. Menambahkan pemblokiran pin akan mencegah paket ini ditingkatkan saat memanggil winget upgrade --all atau winget upgrade <package>. Anda harus membuka blokir paket untuk membiarkan WinGet melakukan upgrade.

winget pin add --id Microsoft.PowerToys --blocking

Contoh berikut menambahkan pembatasan pin untuk aplikasi menggunakan ID-nya. Menambahkan pembatasan pin akan mencegah peningkatan versi upgrade paket di luar versi tertentu atau rentang wildcard yang terjaga.

winget pin add --id Microsoft.PowerToys --version 0.70.*

hapus

remove Sub perintah menghapus pin. Sub-perintah ini mengharuskan Anda menentukan paket pin yang tepat untuk dihapus. Jika ada ambiguitas, Anda akan diminta untuk memfilter remove sub-perintah lebih lanjut ke aplikasi yang tepat.

Penggunaan:

winget pin remove [[-q] <query>] [<options>]

Argumen

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

Opsi

Opsi ini memungkinkan Anda menyesuaikan penghapusan pin untuk memenuhi kebutuhan Anda.

Opsi	Deskripsi
--id	Membatasi pencarian ke ID aplikasi.
--name	Membatasi pencarian pada nama ID aplikasi.
--moniker	Membatasi pencarian ke moniker yang terdaftar untuk aplikasi.
-s, --source	Membatasi pencarian ke nama sumber yang disediakan. Harus diikuti dengan nama sumber.
--tag	Membatasi pencarian ke tag yang tercantum untuk aplikasi.
--cmd, --command	Membatasi pencarian ke perintah aplikasi.
-e, --exact	Menggunakan string yang tepat dalam kueri, termasuk memeriksa sensitivitas huruf besar/kecil. Hal ini tidak akan menggunakan perilaku default substring.
--header	Header HTTP sumber REST Windows-Package-Manager opsional.
--authentication-mode	Tentukan preferensi jendela autentikasi (senyap, silentPreferred atau interaktif).
--authentication-account	Tentukan akun yang akan digunakan untuk autentikasi.
--accept-source-agreements	Digunakan untuk menerima perjanjian lisensi sumber, dan menghindari perintah.
--installed	Sematkan versi tertentu yang terinstal.
-?, --help	Dapatkan bantuan tambahan pada perintah ini.
--wait	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, --ignore-warnings	Menekan output peringatan.
--disable-interactivity	Nonaktifkan perintah interaktif.
--proxy	Atur proksi yang akan digunakan untuk eksekusi ini.
--no-proxy	Nonaktifkan penggunaan proksi untuk eksekusi ini.

Contoh

Contoh berikut menghapus pin untuk aplikasi.

winget pin remove powertoys

Contoh berikut menghapus pin untuk aplikasi menggunakan ID-nya.

winget pin remove --id Microsoft.PowerToys

daftar

list Sub-perintah mencantumkan semua pin saat ini.

Penggunaan:

winget pin list [[-q] <query>] [<options>]

Argumen

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

Opsi

Opsi ini memungkinkan Anda menyesuaikan pin daftar untuk memenuhi kebutuhan Anda.

Opsi	Deskripsi
--id	Membatasi pencarian ke ID aplikasi.
--name	Membatasi pencarian pada nama ID aplikasi.
--moniker	Membatasi pencarian ke moniker yang terdaftar untuk aplikasi.
-s, --source	Membatasi pencarian ke nama sumber yang disediakan. Harus diikuti dengan nama sumber.
--tag	Membatasi pencarian ke tag yang tercantum untuk aplikasi.
--cmd, --command	Membatasi pencarian ke perintah aplikasi.
-e, --exact	Menggunakan string yang tepat dalam kueri, termasuk memeriksa sensitivitas huruf besar/kecil. Hal ini tidak akan menggunakan perilaku default substring.
--header	Header HTTP sumber REST Windows-Package-Manager opsional.
--authentication-mode	Tentukan preferensi jendela autentikasi (senyap, silentPreferred atau interaktif).
--authentication-account	Tentukan akun yang akan digunakan untuk autentikasi.
--accept-source-agreements	Digunakan untuk menerima perjanjian lisensi sumber, dan menghindari perintah.
-?, --help	Dapatkan bantuan tambahan pada perintah ini.
--wait	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, --ignore-warnings	Menekan output peringatan.
--disable-interactivity	Nonaktifkan perintah interaktif.
--proxy	Atur proksi yang akan digunakan untuk eksekusi ini.
--no-proxy	Nonaktifkan penggunaan proksi untuk eksekusi ini.

Contoh

Contoh berikut mencantumkan semua pin saat ini.

winget pin list

Contoh berikut mencantumkan paket pintertentu .

winget pin list --id Microsoft.PowerToys

atur ulang

Sub-perintah reset mengatur ulang semua pin.

Menggunakan sub perintah ini tanpa --force argumen akan menampilkan pin yang akan dihapus.

Untuk mengatur ulang semua pin, sertakan --force argumen .

Penggunaan:

winget pin reset [<options>]

Opsi

Opsi ini memungkinkan Anda menyesuaikan penyetelan ulang pin untuk memenuhi kebutuhan Anda.

Opsi	Deskripsi
--force	Jalankan perintah secara langsung dan lanjutkan dengan masalah terkait non-keamanan.
-s, --source	Membatasi pencarian ke nama sumber yang disediakan. Harus diikuti dengan nama sumber.
-?, --help	Dapatkan bantuan tambahan pada perintah ini.
--wait	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, --ignore-warnings	Menekan output peringatan.
--disable-interactivity	Nonaktifkan perintah interaktif.
--proxy	Atur proksi yang akan digunakan untuk eksekusi ini.
--no-proxy	Nonaktifkan penggunaan proksi untuk eksekusi ini.

Contoh

Contoh berikut menunjukkan semua pin yang akan diatur ulang.

winget pin reset

Contoh berikut mereset semua pin yang ada.

winget pin reset --force