Men-debug dan memecahkan masalah dengan alat WinGet

Jika WinGet tampaknya tidak diinstal dengan benar, ikuti langkah-langkah ini dari prompt perintah PowerShell:

Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Repair-WinGetPackageManager -Force -Latest

Ketika perintah WinGet gagal, terkadang perlu untuk melihat file log untuk lebih memahami perilaku.

Pengelola Paket Windows secara default membuat file log saat menjalankan perintah. Log ini berisi informasi yang dapat membantu dalam men-debug masalah dengan WinGet. Tidak ada ukuran maksimum untuk file log. Ukurannya biasanya hanya beberapa KB. Ketika jumlah file log di direktori melebihi 100, file log terlama akan mulai dihapus. Tidak ada penghapusan log berbasis waktu dan pengaturan ini tidak dapat dikonfigurasi. Jika Anda telah mencapai kapasitas log file 100, cukup pindahkan log WinGet apa pun yang ingin Anda pertahankan ke direktori yang berbeda.

Gunakan perintah winget --info untuk menemukan jalur direktori ke file log WinGet Anda. Jalur default untuk file log WinGet adalah:

%LOCALAPPDATA%\Packages\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\LocalState\DiagOutputDir

Anda dapat menyertakan opsi --logs atau --open-logs ke perintah apa pun untuk membuka direktori log setelah perintah selesai. Berikut adalah beberapa contoh penggunaan opsi --logs :

> winget list --logs
> winget source update --open-logs

Jika Anda memerlukan file log yang lebih komprehensif, yang menyediakan komunikasi lengkap dengan CDN dan sumber, sertakan --verbose atau --verbose-logs pada baris perintah juga. Berikut adalah beberapa contoh penggunaan opsi --verbose-logs :

> winget install vscode --verbose-logs
> winget search -n visual --verbose-logs
> winget source add -n mysource -t Microsoft.REST -a https://www.contoso.org --verbose

Daftar masalah yang diketahui dengan sumber dan perilaku tetap diperbarui di repositori Klien Pengelola Paket Windows. Jika Anda mengalami masalah saat menggunakan alat WinGet, buka di sini untuk pemecahan masalah.

Alat WinGet mengembalikan kode keluar untuk menunjukkan keberhasilan atau kegagalan perintah. Temukan tabel kode keluar dan maknanya dalam file "Kembalikan kode" dari repositori Klien Pengelola Paket Windows.

Tidak semua alat penginstal mendukung penginstalan dalam cakupan "pengguna" vs. cakupan "mesin" secara konsisten.

• Paket berbasis MSIX: Perilaku Reliable WinGet.
• Paket berbasis MSI biasanya mendukung konfigurasi WinGet yang andal, tetapi dalam beberapa kasus, disarangkan di dalam alat penginstal berbasis .exe sehingga mungkin ada lebih banyak varianbilitas.
• Perilaku alat penginstal berbasis EXE di sekitar cakupan belum tentu deterministik. Dalam beberapa kasus argumen untuk menentukan cakupan tidak tersedia, dan dalam kasus lain alat penginstal dapat membuat penentuan berdasarkan apakah pengguna adalah anggota grup administrator lokal. Paket yang diinstal dalam cakupan pengguna mungkin masih memerlukan otorisasi UAC (Kontrol Akun Pengguna) dari administrator.

Lihat detail selengkapnya tentang masalah terkait cakupan di repositori produk WinGet di GitHub.

Kesalahan Terlarang 403 dapat terjadi saat mencoba mengunduh paket menggunakan alat WinGet. Masalah ini dapat muncul jika Vendor Perangkat Lunak Independen (ISV) memilih tidak memiliki produk mereka yang didistribusikan oleh layanan manajer paket seperti WinGet.

Server yang bertanggung jawab untuk memulai unduhan biasanya memeriksa string agen pengguna yang disertakan dengan permintaan unduhan untuk mengidentifikasi perangkat atau klien (misalnya, browser, WinGet). Jika Anda dapat mengunduh alat penginstal menggunakan browser Anda, tetapi mengalami masalah dengan WinGet, ada kemungkinan bahwa ISV telah memblokir string agen pengguna WinGet.

String agen pengguna untuk WinGet memiliki format berikut:

winget-cli WindowsPackageManager/{Client Version} DesktopAppInstaller/Microsoft.DesktopAppInstaller {AppInstaller Version}

Contoh:

winget-cli WindowsPackageManager/1.9.25200 DesktopAppInstaller/Microsoft.DesktopAppInstaller v1.24.25200.0