Gunakan alat winget untuk menginstal dan mengelola aplikasi

Alat baris perintah winget memungkinkan pengguna untuk menemukan, menginstal, meningkatkan, menghapus, dan mengonfigurasi aplikasi di komputer Windows 10 dan Windows 11. Alat ini adalah antarmuka klien ke layanan Pengelola Paket Windows.

Memasang winget

Pengelola Paket Windows alat baris perintah winget tersedia di Windows 11 dan versi modern Windows 10 sebagai bagian dari Penginstal Aplikasi.

Anda bisa mendapatkan Penginstal Aplikasi dari Microsoft Store. Jika sudah diinstal, pastikan sudah diperbarui dengan versi terbaru.

Catatan

Alat baris perintah winget hanya didukung pada Windows 10 1709 (build 16299) atau yang lebih baru saat ini. Alat winget tidak akan tersedia sampai Anda masuk ke Windows sebagai pengguna untuk pertama kalinya, memicu Microsoft Store untuk mendaftar Pengelola Paket Windows sebagai bagian dari proses asinkron. Jika Anda baru-baru ini masuk sebagai pengguna untuk pertama kalinya dan menemukan bahwa winget belum tersedia, Anda dapat membuka PowerShell dan memasukkan perintah berikut untuk meminta pendaftaran winget ini: Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.

Instal versi pratinjau winget [Khusus Pengembang]

WinGet disertakan dalam Penginstal Aplikasi Windows. Untuk mencoba fitur Pengelola Paket Windows terbaru, Anda dapat menginstal build pratinjau salah satu cara berikut:

  • Unduh versi pratinjau winget terbaru. Baca Catatan rilis untuk pratinjau winget untuk mempelajari fitur baru apa pun. Menginstal paket ini akan memberi Anda versi pratinjau klien WinGet, tetapi tidak akan mengaktifkan pembaruan otomatis versi pratinjau baru dari Microsoft Store.

  • Gunakan akun Akun Microsoft (MSA), kantor, sekolah, atau Azure Active Directory (AAD) untuk mendaftar ke Saluran Dev Windows Insider. Windows Insider Dev Channel menyertakan pembaruan otomatis versi pratinjau baru dari Microsoft Store.

  • Gunakan Akun Microsoft (MSA) untuk mendaftar program Pengelola Paket Windows Insiders. Setelah Akun Microsoft (MSA) Anda ditambahkan (beberapa hari setelah Anda menerima pemberitahuan email) Anda akan menerima pembaruan otomatis versi pratinjau baru dari Microsoft Store.

Pasang winget di Kotak Pasir Windows

Kotak Pasir Windows menyediakan lingkungan desktop yang ringan untuk menjalankan aplikasi dengan aman dalam isolasi. Perangkat lunak yang dipasang di dalam lingkungan Kotak Pasir Windows tetap "dikotakpasir" dan berjalan secara terpisah dari komputer host. Kotak Pasir Windows tidak termasuk winget, atau aplikasi Microsoft Store, jadi Anda harus mengunduh paket winget terbaru dari halaman rilis winget di GitHub.

Untuk menginstal rilis winget yang stabil di Kotak Pasir Windows, ikuti langkah-langkah ini dari prompt perintah Windows PowerShell:

$progressPreference = 'silentlyContinue'
Write-Information "Downloading WinGet and its dependencies..."
Invoke-WebRequest -Uri https://aka.ms/getwinget -OutFile Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle
Invoke-WebRequest -Uri https://aka.ms/Microsoft.VCLibs.x64.14.00.Desktop.appx -OutFile Microsoft.VCLibs.x64.14.00.Desktop.appx
Invoke-WebRequest -Uri https://github.com/microsoft/microsoft-ui-xaml/releases/download/v2.8.6/Microsoft.UI.Xaml.2.8.x64.appx -OutFile Microsoft.UI.Xaml.2.8.x64.appx
Add-AppxPackage Microsoft.VCLibs.x64.14.00.Desktop.appx
Add-AppxPackage Microsoft.UI.Xaml.2.8.x64.appx
Add-AppxPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle

Jika Anda ingin pratinjau atau versi Manajer Paket yang berbeda, buka https://github.com/microsoft/winget-cli/releases. Salin URL versi yang Anda inginkan dan perbarui Uri di atas.

Untuk informasi selengkapnya tentang Kotak Pasir Windows, termasuk cara menginstal kotak pasir dan apa yang diharapkan dari penggunaannya, lihat dokumen Kotak Pasir Windows.

Pertimbangan administrator

Perilaku penginstal dapat berbeda tergantung pada apakah Anda menjalankan winget dengan hak istimewa administrator.

  • Saat menjalankan winget tanpa hak istimewa administrator, beberapa aplikasi mungkin memerlukan elevasi untuk diinstal. Ketika alat penginstal berjalan, Windows akan meminta Anda untuk meningkatkan. Jika Anda memilih untuk tidak meningkatkan, aplikasi akan gagal diinstal.

  • Saat menjalankan winget di Prompt Perintah Administrator, Anda tidak akan melihat permintaan elevasi jika aplikasi memerlukannya. Selalu berhati-hatilah saat menjalankan prompt perintah Anda sebagai administrator, dan hanya menginstal aplikasi yang Anda percayai.

Gunakan winget

Setelah Penginstal Aplikasi diinstal, Anda dapat menjalankan winget dengan mengetik 'winget' dari Prompt Perintah.

Salah satu skenario penggunaan yang paling umum adalah mencari dan menginstal alat favorit.

  1. Untuk mencari alat, ketik winget search <appname>.

  2. Setelah Anda mengonfirmasi bahwa alat yang Anda inginkan tersedia, Anda dapat menginstal alat dengan mengetik winget install <appname>. Alat winget akan meluncurkan alat penginstal dan menginstal aplikasi di PC Anda. winget commandline

  3. Selain menginstal dan mencari, winget menyediakan sejumlah perintah lain yang memungkinkan Anda menampilkan detail tentang aplikasi, mengubah sumber, dan memvalidasi paket. Untuk mendapatkan daftar lengkap perintah, ketik: winget --help. winget help

Beberapa pengguna telah melaporkan masalah dengan klien yang tidak berada di PATH mereka.

Perintah

Pratinjau alat winget saat ini mendukung perintah berikut.

Perintah Deskripsi
info Menampilkan metadata tentang sistem (nomor versi, arsitektur, lokasi log, dll). Berguna untuk pemecahan masalah.
Menginstal Menginstal aplikasi yang ditentukan.
Tampilkan Menampilkan detail untuk aplikasi yang ditentukan.
sumber Menambahkan, menghapus, dan memperbarui repositori Pengelola Paket Windows yang diakses oleh alat winget.
cari Mencari aplikasi.
daftar Tampilkan paket yang terinstal.
Upgrade Meningkatkan paket yang diberikan.
Uninstall Menghapus instalan paket yang diberikan.
Hash Menghasilkan hash SHA256 untuk alat penginstal.
Memvalidasi Memvalidasi file manifes untuk pengiriman ke repositori Pengelola Paket Windows.
pengaturan Buka pengaturan.
fitur Memperlihatkan status fitur eksperimental.
ekspor Mengekspor daftar paket yang diinstal.
impor Menginstal semua paket dalam file.
pin Mengelola pin paket.
Mengkonfigurasi Mengonfigurasi sistem ke dalam status yang diinginkan.
unduh Mengunduh alat penginstal aplikasi yang ditentukan.

Opsi

Alat winget mendukung opsi berikut.

Opsi Deskripsi
-v, --version Mengembalikan versi winget saat ini.
--Info Memberi Anda semua informasi terperinci tentang winget, termasuk tautan ke lisensi, pernyataan privasi, dan kebijakan grup yang dikonfigurasi.
-?--Tolong Menampilkan bantuan tambahan untuk winget.

Format alat penginstal yang didukung

Alat winget mendukung jenis alat penginstal berikut:

  • EXE (dengan bendera Silent dan SilentWithProgress )
  • ZIP
  • INNO
  • NULLSOFT
  • MSI
  • WIX
  • APPX
  • MSIX
  • MEMBAKAR
  • PORTABEL

Winget pembuatan skrip

Anda dapat menggunakan sintaks berikut untuk menginstal beberapa aplikasi dalam satu perintah.

USAGE: winget install <query1> <query2> ...

Contoh

winget install Microsoft.WindowsTerminal Microsoft.PowerToys Microsoft.VisualStudioCode

Catatan

Ketika diskrip, winget akan meluncurkan aplikasi dalam urutan yang ditentukan. Ketika alat penginstal mengembalikan keberhasilan atau kegagalan, winget akan meluncurkan alat penginstal berikutnya. Jika alat penginstal meluncurkan proses lain, ada kemungkinan bahwa itu akan kembali ke winget sebelum waktunya. Ini akan menyebabkan winget menginstal penginstal berikutnya sebelum alat penginstal sebelumnya selesai.

Penelusuran kesalahan dan pemecahan masalah

winget menyediakan pengelogan untuk membantu mendiagnosis masalah. Untuk pemecahan masalah dan detail tentang pengelogan, lihat Penelusuran kesalahan dan pemecahan masalah.

Alat yang hilang

Jika repositori komunitas tidak menyertakan alat atau aplikasi Anda, kirimkan paket ke repositori kami. Dengan menambahkan alat favorit Anda, alat tersebut akan tersedia untuk Anda dan orang lain.

Menyesuaikan pengaturan winget

Anda dapat mengonfigurasi pengalaman baris perintah winget dengan memodifikasi file settings.json . Untuk informasi selengkapnya, lihat https://aka.ms/winget-settings . Perhatikan bahwa pengaturan masih dalam status eksperimental dan belum diselesaikan untuk versi pratinjau alat.

Detail sumber terbuka

Alat winget adalah perangkat lunak sumber terbuka tersedia di GitHub di repositori https://github.com/microsoft/winget-cli/. Sumber untuk membangun klien terletak di folder src.

Sumber untuk winget terkandung dalam solusi C++ Visual Studio 2019. Untuk membangun solusi dengan benar, instal Visual Studio terbaru dengan beban kerja C++.

Kami mendorong Anda untuk berkontribusi pada sumber winget di GitHub. Anda harus terlebih dahulu menyetujui dan menandatangani Microsoft CLA.

Pemecahan Masalah

Repositori winget-cli mempertahankan daftar masalah umum dan kesalahan umum, bersama dengan rekomendasi tentang cara mengatasinya: