perintah pin (winget)
Perintah pin winget memungkinkan Anda membatasi Pengelola Paket Windows meningkatkan paket ke rentang versi tertentu, atau dapat mencegahnya meningkatkan paket sama sekali. Paket yang disematkan masih dapat ditingkatkan sendiri dan ditingkatkan dari luar Pengelola Paket Windows.
Jenis Pin
WinGet mendukung tiga jenis pin paket:
Penyematan: Paket dikecualikan dari
winget upgrade --alltetapi memungkinkanwinget upgrade <package>. Anda dapat menggunakan--include-pinnedargumen untuk membiarkanwinget upgrade --allmenyertakan paket yang disematkan.Pemblokiran: Paket diblokir dari
winget upgrade --allatauwinget upgrade <package>, Anda harus melepaskan semat paket untuk membiarkan WinGet melakukan peningkatan. Opsi--forceini dapat digunakan untuk mengambil alih perilaku pin.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 versi1.2.*, versi apa pun di antaranya1.2.x1.2.0dianggap valid. Opsi--forceini dapat digunakan untuk mengambil alih perilaku pin.
Penggunaan
winget pin <subcommand> <options>
Opsi
Opsi berikut ini tersedia.
| Opsi | Deskripsi |
|---|---|
| -?--Tolong | Mendapatkan bantuan tambahan pada perintah ini. |
| --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,--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 sematkan mendukung sub-perintah berikut.
| Subperintah | Deskripsi |
|---|---|
| penambahan | Tambahkan pin baru. |
| buka | Hapus pin paket. |
| daftar | Mencantumkan pin saat ini. |
| Reset | Mereset pin |
tambahkan
Tambahkan sub-perintah menambahkan pin baru. Sub perintah ini mengharuskan Anda menentukan paket yang tepat untuk disematkan. Jika ada ambiguitas, Anda akan diminta untuk memfilter lebih lanjut, tambahkan sub-perintah 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 untuk disematkan. Wildcard * dapat digunakan sebagai bagian versi terakhir. Mengubah perilaku pin 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. |
| --paksa | Jalankan perintah secara langsung dan lanjutkan dengan masalah terkait non-keamanan. |
| --Memblokir | Blokir agar tidak memutakhirkan hingga pin dihapus, mencegah penimpaan argumen. Mengubah perilaku pin menjadi blocking. |
| --Diinstal | Menyematkan versi tertentu yang terinstal |
| -?--Tolong | Dapatkan bantuan tambahan pada perintah ini. |
| --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,--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 pin ini 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 pin pemblokiran untuk aplikasi menggunakan ID-nya. Menambahkan pin pemblokiran akan mencegah paket ini ditingkatkan saat memanggil winget upgrade --all atau winget upgrade <package>. Anda harus membuka blokir paket untuk membiarkan WinGet melakukan peningkatan.
winget pin add --id Microsoft.PowerToys --blocking
Contoh berikut menambahkan pin gating untuk aplikasi menggunakan ID-nya. Menambahkan pin pembatasan akan mencegah peningkatan yang meningkatkan versi paket di luar versi tertentu atau rentang wildcard yang terjaga.
winget pin add --id Microsoft.PowerToys --version 0.70.*
buka
Sub perintah hapus akan menghapus pin. Sub perintah ini mengharuskan Anda menentukan pin paket yang tepat untuk dihapus. Jika ada ambiguitas, Anda akan diminta untuk memfilter lebih lanjut penghapusan sub-perintah 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. |
| --Diinstal | Sematkan versi tertentu yang terinstal. |
| -?--Tolong | Dapatkan bantuan tambahan pada perintah ini. |
| --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,--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
list
Sub-perintah daftar 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. |
| -?--Tolong | Dapatkan bantuan tambahan pada perintah ini. |
| --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,--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 pin paket tertentu.
winget pin list --id Microsoft.PowerToys
mengatur 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 |
|---|---|
| --paksa | 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. |
| -?--Tolong | Dapatkan bantuan tambahan pada perintah ini. |
| --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,--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
Windows developer