Bagikan melalui


Gunakan alat WinGet untuk menginstal dan mengelola aplikasi

WinGet adalah alat baris perintah yang memungkinkan pengguna untuk menemukan, menginstal, meningkatkan, menghapus, dan mengonfigurasi aplikasi pada komputer Windows 10, Windows 11, dan Windows Server 2025. Alat ini adalah antarmuka klien ke layanan Pengelola Paket Windows.

Instal WinGet

WinGet Pengelola Paket Windows tersedia di Windows 11, versi modern Windows 10, dan Windows Server 2025 sebagai bagian dari Penginstal Aplikasi. Penginstal Aplikasi adalah Komponen Sistem yang dikirimkan dan diperbarui oleh microsoft store pada versi Windows Desktop, dan melalui Pembaruan pada Windows Server 2025.

Catatan

Alat baris perintah WinGet hanya didukung pada Windows 10 1709 (build 16299) atau yang lebih baru saat ini. WinGet tidak akan tersedia sampai Anda masuk ke Windows sebagai pengguna untuk pertama kalinya, memicu Microsoft Store untuk mendaftarkan 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.

Instal 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 menyertakan WinGet, atau aplikasi Microsoft Store, jadi Anda harus mengunduh paket WinGet terbaru dari halaman rilis WinGet di GitHub.

Untuk menginstal rilis Stabil WinGet di Kotak Pasir Windows, ikuti langkah-langkah ini dari prompt perintah Windows PowerShell:

$progressPreference = 'silentlyContinue'
Write-Host "Installing WinGet PowerShell module from PSGallery..."
Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Write-Host "Using Repair-WinGetPackageManager cmdlet to bootstrap WinGet..."
Repair-WinGetPackageManager
Write-Host "Done."

Untuk menginstal modul PowerShell dalam cakupan mesin, Anda dapat menggunakan -Scope AllUsers parameter dengan Install-Module cmdlet . Jika Anda menginginkan versi pratinjau WinGet, Anda dapat menambahkan -IncludePrerelease parameter dengan cmdlet Repair-WinGetPackageManager. Untuk melihat parameter yang tersedia untuk cmdlet Repair-WinGetPackageManager, Anda dapat menjalankan Get-Help Repair-WinGetPackageManager -Full.

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. baris perintah winget

  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. bantuan winget

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.
pasang Menginstal aplikasi yang ditentukan.
memperlihatkan 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.
hapus instalan 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
  • BAKAR
  • PORTABEL

Scripting WinGet

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 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 yang 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: