perintah instal (winget)

Perintah instalWinGet menginstal aplikasi yang ditentukan. Gunakan perintah pencarian untuk mengidentifikasi aplikasi yang ingin Anda instal. Gunakan perintah tampilkan untuk melihat detail tentang aplikasi dan penginstal yang dipilih oleh WinGet untuk sistem Anda.

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

Penggunaan

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

Cuplikan layar mencantumkan opsi bantuan perintah impor winget.

Aliasi

Alias berikut tersedia untuk perintah ini:

  • tambahkan

Argumen

Argumen berikut tersedia.

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

Catatan

Argumen kueri ditentukan berdasarkan posisi. Secara default, winget melakukan kecocokan substring yang tidak peka huruf besar/kecil terhadap nama paket, ID, dan moniker. Sintaksis kartubebas tidak didukung. Gunakan -e, --exact untuk memerlukan kecocokan yang tepat (peka huruf besar/kecil). Gunakan --id, --name, atau --moniker untuk membatasi bidang mana yang dicari.

Opsi

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

Opsi Deskripsi
-m, --manifest Harus diikuti dengan jalur menuju file manifes (YAML). Anda dapat menggunakan manifes untuk menjalankan pengalaman penginstalan dari file YAML lokal.
--Id Membatasi penginstalan ke ID aplikasi.
--Nama Membatasi pencarian pada nama ID aplikasi.
--Moniker Pembatasan pencarian hanya pada nama julukan yang terdaftar untuk aplikasi.
-v, --version Memungkinkan Anda menentukan versi yang tepat untuk diinstal. Jika tidak ditentukan, yang terbaru akan menginstal aplikasi versi tertinggi.
-s, --source Membatasi pencarian ke nama sumber yang disediakan. Harus diikuti dengan nama sumber.
--ruang lingkup Memungkinkan Anda untuk menentukan apakah alat penginstal harus menargetkan pengguna atau cakupan komputer. Lihat masalah umum yang berkaitan dengan cakupan penginstalan paket.
-a, --arsitektur Pilih arsitektur yang akan diinstal.
--installer-type Pilih jenis alat penginstal yang akan diinstal. Lihat jenis penginstal yang didukung untuk klien WinGet.
-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 default menunjukkan kemajuan penginstalan.
-h, -- senyap Menjalankan alat penginstal dalam mode diam. Ini menyembunyikan semua antarmuka pengguna. Tampilan default menunjukkan kemajuan penginstalan.
--locale Menentukan lokal mana yang akan digunakan (format BCP47).
-o, --log Mengarahkan log ke file log. Anda harus menyediakan jalan ke file yang hak tulisnya Anda miliki.
--custom Argumen yang akan diteruskan ke alat penginstal di samping pengaturan bawaan.
--mengganti String yang akan diteruskan langsung ke alat penginstal.
-l, --location (lokasi) Lokasi untuk menginstal (jika didukung).
--abaikan-hash-keamanan Abaikan kegagalan pemeriksaan hash penginstal. Tidak direkomendasikan.
--allow-reboot (izinkan restart) Memungkinkan boot ulang jika berlaku.
--skip-dependensies Melewati dependensi pemrosesan paket dan fitur Windows.
--abaikan-pemindaian-malware-arsip-lokal Abaikan pemindaian malware yang dilakukan sebagai bagian dari menginstal paket jenis arsip dari manifes lokal.
--sumber ketergantungan Temukan dependensi paket menggunakan sumber yang ditentukan.
--menerima-perjanjian-paket Menerima perjanjian lisensi atau EULA yang disajikan oleh penginstal paket, menekan prompt interaktif. Ini hanya berlaku untuk persyaratan lisensi paket sendiri - ini tidak memengaruhi komponen opsional atau perangkat lunak yang dibundel yang ditawarkan oleh alat penginstal. Untuk penginstalan yang sepenuhnya tidak interaktif, gabungkan dengan --silent (-h).
--no-upgrade (tanpa peningkatan) Lewati pembaruan jika versi yang terinstal sudah ada.
--Header Header HTTP opsional untuk sumber REST Windows-Package-Manager.
--authentication-mode Tentukan preferensi jendela autentikasi (senyap, silentPreferred atau interaktif).
--akun-autentikasi Tentukan akun yang akan digunakan untuk autentikasi.
--terima-persetujuan-sumber Menerima perjanjian lisensi untuk repositori WinGet, mengabaikan prompt interaktif. Ini terpisah dari lisensi paket apa pun - ini mencakup ketentuan penggunaan untuk sumber itu sendiri, seperti repositori komunitas winget.
-r, --rename Nilai untuk mengganti nama file yang dapat dieksekusi (portabel).
--uninstall- sebelumnya Hapus instalan versi paket sebelumnya selama peningkatan.
--force Jalankan perintah secara langsung dan lanjutkan dengan masalah terkait non-keamanan.
-?, --help 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 mengesampingkan pengaturan pencatatan dan membuat log rinci.
--nowarn (jangan tampilkan peringatan), --ignore-warnings (abaikan peringatan) Menyembunyikan output 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 menginstal versi aplikasi tertentu.

winget install powertoys --version 0.91.1

Contoh berikut menginstal aplikasi dari ID-nya.

winget install --id Microsoft.PowerToys

Contoh berikut menginstal aplikasi berdasarkan versi dan ID.

winget install --id Microsoft.PowerToys --version 0.91.1

Menginstal beberapa paket

Anda dapat menginstal beberapa paket dalam satu perintah dengan mencantumkan ID yang dipisahkan oleh spasi.

winget install Microsoft.VisualStudioCode Microsoft.PowerShell Git.Git

WinGet menginstal setiap paket secara berurutan. Ini berguna untuk menyiapkan komputer baru dengan cepat atau berbagi sekumpulan alat dengan kolega.

Petunjuk / Saran

Untuk set paket yang lebih besar, pertimbangkan untuk menggunakan ekspor winget dan impor winget untuk menyimpan dan memulihkan daftar paket lengkap, atau konfigurasi winget untuk menginstal paket bersama konfigurasi komputer lain dalam satu file.

Hasil disambiguasi

Jika kueri yang diberikan kepada WinGet tidak menghasilkan satu aplikasi, maka WinGet akan menampilkan hasil pencarian. Ini akan memberi Anda data tambahan yang diperlukan untuk menyempurnakan pencarian untuk penginstalan yang benar.

Cara terbaik untuk membatasi pilihan ke satu file adalah dengan menggunakan id aplikasi yang dikombinasikan dengan opsi kueri yang tepat . Contohnya:

winget install --id Git.Git -e

Jika beberapa sumber dikonfigurasi, dimungkinkan untuk memiliki entri duplikat. Menentukan sumber diperlukan untuk membedakan lebih lanjut.

winget install --id Git.Git -e --source winget

Sumber msstore menggunakan pengidentifikasi unik sebagai "Id" untuk paket. Ini tidak memerlukan opsi kueri yang tepat . Contohnya:

winget install XP9KHM4BK9FZ7Q -s msstore

Penginstalan lokal

Opsi manifes memungkinkan Anda menginstal aplikasi dengan meneruskan file YAML langsung ke klien. Jika manifes adalah manifes multi-file, direktori yang berisi file harus digunakan. Opsi manifes memiliki penggunaan berikut.

Penggunaan: winget install --manifest \<path>

Opsi Deskripsi
-m, --manifest Jalur ke manifes aplikasi yang akan diinstal.

Menginstal paket dari file manifes lokal mungkin memiliki risiko. Sebagai tindakan pencegahan ekstra, fitur ini perlu diaktifkan oleh administrator. Untuk mengaktifkan fitur ini, jalankan winget settings --enable LocalManifestFiles. Untuk menonaktifkan fitur ini, jalankan winget settings --disable LocalManifestFiles.

Log file

File log untuk WinGet kecuali dialihkan, akan terletak di folder berikut: \%LOCALAPPDATA%\\Packages\\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\\LocalState\\DiagOutputDir\\*.log

Perjanjian Lisensi

Beberapa aplikasi saat diinstal akan mengharuskan pengguna untuk menyetujui lisensi atau perjanjian lain sebelum menginstal. Ketika ini terjadi, Pengelola Paket Windows akan meminta pengguna untuk menyetujui perjanjian. Jika pengguna tidak setuju, aplikasi tidak akan diinstal.

Cuplikan layar permintaan perjanjian pengguna di winget.

Dari baris perintah, Anda dapat menerima perjanjian secara otomatis dengan meneruskan opsi --accept-package-agreements berikut pada baris perintah. Ini dapat bermanfaat saat membuat skrip Pengelola Paket Windows.