Aracılığıyla paylaş


Uygulamaları yüklemek ve yönetmek için WinGet kullanma

WinGet , kullanıcıların Windows 10, Windows 11 ve Windows Server 2025 bilgisayarlarında uygulamaları bulmalarını, yüklemelerini, yükseltmelerini, kaldırmalarını ve yapılandırmalarını sağlayan bir komut satırı aracıdır. Bu araç, Windows Paket Yöneticisi hizmetinin istemci arabirimidir.

WinGet'i yükleme

WinGet Windows Paket Yöneticisi, Uygulama Yükleyicisi'nin bir parçası olarak Windows 11, Windows 10'un modern sürümleri ve Windows Server 2025'te kullanılabilir. Uygulama Yükleyicisi, Windows Masaüstü sürümlerinde ve Windows Server 2025'te Güncelleştirmeler aracılığıyla Microsoft mağazası tarafından teslim edilen ve güncelleştirilen bir Sistem Bileşenidir.

Uyarı

WinGet komut satırı aracı yalnızca Windows 10 sürüm 1809 (derleme 17763) veya sonraki sürümlerde desteklenir. Windows'ta ilk kez kullanıcı olarak oturum açana kadar WinGet kullanılamaz ve Microsoft Store'un zaman uyumsuz bir işlemin parçası olarak Windows Paket Yöneticisi'ni kaydetmesini tetikler. Kısa süre önce ilk kez kullanıcı olarak oturum açtıysanız ve WinGet'in henüz kullanılabilir olmadığını fark ettiyseniz, PowerShell'i açabilir ve bu WinGet kaydını istemek için aşağıdaki komutu girebilirsiniz: Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.

WinGet önizleme sürümünü yükleme [Yalnızca Geliştiriciler]

WinGet, Uygulama Yükleyicisi'ne eklenir. En son Windows Paket Yöneticisi özelliklerini denemek için aşağıdaki yollardan birini kullanarak bir önizleme derlemesi yükleyebilirsiniz:

  • En son WinGet önizleme sürümünü indirin. Yeni özellikler hakkında bilgi edinmek için WinGet önizleme sürümü notlarını okuyun. Bu paketin yüklenmesi size WinGet istemcisinin önizleme sürümünü verir, ancak Microsoft Store'dan yeni önizleme sürümlerinin otomatik güncelleştirmelerini etkinleştirmez.

  • Kanarya veya Geliştirici KanallarındaWindows Insider Programı'na kaydolmak için bir Microsoft Hesabı (MSA), iş, okul veya Azure Active Directory (AAD) hesabı kullanın. Windows Insider Kanarya ve Geliştirme Kanalları, Microsoft Store'dan WinGet'in yeni önizleme sürümlerinin otomatik güncelleştirmelerini içerir.

  • Windows Paket Yöneticisi Insider Programı'na kaydolmak için bir Microsoft Hesabı (MSA) kullanın. Microsoft Hesabınız (MSA) eklendikten sonra (e-posta bildirimi aldıktan birkaç gün sonra) Microsoft Store'dan yeni önizleme sürümlerinin otomatik güncelleştirmelerini alırsınız.

Windows Korumalı Alanı'na WinGet'i yükleyin

Windows Korumalı Alanı, uygulamaları yalıtarak güvenli bir şekilde çalıştırmak için basit bir masaüstü ortamı sağlar. Windows Korumalı Alan ortamına yüklenen yazılımlar "korumalı" kalır ve konak makineden ayrı olarak çalışır. Windows Korumalı Alanı, WinGet veya Microsoft Store uygulamasını içermez, bu nedenle GitHub'da WinGet sürümleri sayfasından en son WinGet paketini indirmeniz veya Repair-WinGetPackageManager cmdlet'ini kullanmanız gerekir.

Windows Korumalı Alanı'nda WinGet'in kararlı sürümünü yüklemek için bir Windows PowerShell komut isteminden şu adımları izleyin:

$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 -AllUsers
Write-Host "Done."

Makine kapsamında WinGet PowerShell modülünü yüklemek için -Scope AllUsers parametresi ile Install-Module cmdlet'ini kullanabilirsiniz. WinGet'in önizleme sürümünü istiyorsanız, Repair-WinGetPackageManager cmdlet'iyle parametre ekleyebilirsiniz -IncludePrerelease . Repair-WinGetPackageManager cmdlet'i için kullanılabilir parametreleri görmek için komutunu çalıştırabilirsiniz Get-Help Repair-WinGetPackageManager -Full.

Korumalı alanın nasıl yükleneceği ve kullanımdan nelerin bekleneceği dahil olmak üzere Windows Korumalı Alanı hakkında daha fazla bilgi için bkz. Windows Korumalı Alanı belgeleri.

Yöneticiyle ilgili dikkat edilmesi gerekenler

WinGet'i yönetici ayrıcalıklarıyla çalıştırıp çalıştırmadığınıza bağlı olarak yükleyici davranışı farklı olabilir.

  • WinGet'i yönetici ayrıcalıkları olmadan çalıştırırken, bazı uygulamaların yüklenmesi için yükseltme gerekebilir. Yükleyici çalıştırıldığında, Windowsyükseltmenizi ister. Yükseltmemeyi seçerseniz uygulama yüklenemeyebilir.

  • WinGet'i bir Yönetici Komut İsteminde çalıştırırken, uygulama gerektiriyorsa yükseltme istemlerini görmezsiniz. Komut isteminizi yönetici olarak çalıştırırken her zaman dikkatli olun ve yalnızca güvendiğiniz uygulamaları yükleyin.

WinGet kullanma

Uygulama Yükleyicisi yüklendikten sonra, Komut İsteminden 'winget' yazarak WinGet'i çalıştırabilirsiniz.

En yaygın kullanım senaryolarından biri, sık kullanılan bir aracı aramak ve yüklemektir.

  1. Araç aramak için yazınız winget search <appname>.

  2. İstediğiniz aracın kullanılabilir olduğunu onayladıktan sonra yazarak aracı winget install <appname>. WinGet aracı yükleyiciyi başlatır ve uygulamayı bilgisayarınıza yükler. winget komut satırı

  3. Yükleme ve aramaya ek olarak , WinGet uygulamalarla ilgili ayrıntıları göstermenizi , kaynakları değiştirmenizi ve paketleri doğrulamanızı sağlayan bir dizi başka komut sağlar. Komutların tam listesini almak için şunu yazın: winget --help. winget yardımı

Bazı kullanıcılar, istemcinin PATH'lerinde olmamasıyla ilgili sorunlar bildirdi.

Komutlar

WinGet aracının geçerli önizlemesi aşağıdaki komutları destekler.

Komut Açıklama
yükleme Belirtilen uygulamayı yükler.
göster Belirtilen uygulamanın ayrıntılarını görüntüler.
kaynak WinGet tarafından erişilen Windows Paket Yöneticisi depolarını ekler, kaldırır ve güncelleştirir.
arama Bir uygulamayı arar.
liste Yüklü paketleri görüntüleme.
yükseltme Belirtilen uygulamayı yükselter.
kaldır Belirtilen uygulamayı kaldırır.
Hash Yükleyici için SHA256 karması oluşturur.
doğrulama Windows Paket Yöneticisi deposuna gönderilmek üzere bir bildirim dosyasını doğrular.
Ayarlar Ayarları açın.
özellikleri Deneysel özelliklerin durumunu gösterir.
dışa aktarım Yüklü paketlerin listesini dışarı aktarır.
içeri aktarma Tüm paketleri bir dosyaya yükler.
iğne Paket pinlerini yönetme.
Yapılandırmak Sistemi istenen bir duruma yapılandırıyor.
indirme Belirtilen uygulamanın yükleyicisini indirir.
repair Seçili uygulamayı onarıyor.
dscv3 PowerShell İstenen Durum Yapılandırması (DSC) v3 kaynak komutları.

Seçenekler

WinGet aracı aşağıdaki seçenekleri destekler.

Seçenek Açıklama
-v, --version WinGet'in geçerli sürümünü döndürür.
--Bilgi Lisans, gizlilik bildirimi ve yapılandırılmış grup ilkelerine bağlantılar da dahil olmak üzere WinGet hakkında tüm ayrıntılı bilgileri sağlar.
-?, --yardım WinGet için ek yardım gösterir.
-- bekleyin Kullanıcıdan çıkmadan önce herhangi bir tuşa basmasını ister.
--logs, --open-logs (kayıt dosyaları, kayıt dosyalarını aç) Varsayılan günlüklerin konumunu açar.
--verbose,--verbose-logs Winget için ayrıntılı günlüğe kaydetmeyi etkinleştirir.
--nowarn (uyarıları gösterme), --ignore-warnings (uyarıları yoksay) Uyarı çıkışlarını gizler.
--disable-interactivity (etkileşimi devre dışı bırak) Etkileşimli istemleri devre dışı bırakır.
--proxy Bu yürütme için kullanılacak bir ara sunucu ayarlar.
--ara sunucu yok Bu yürütme için proxy kullanımını devre dışı bırakır.

Desteklenen yükleyici biçimleri

WinGet aşağıdaki yükleyici türlerini destekler:

  • EXE (Silent ve SilentWithProgress bayraklarıyla)
  • Zip
  • INNO
  • NULLSOFT
  • MSI
  • WIX
  • APPX
  • MSIX
  • YANMAK
  • TAŞINABİLİR

WinGet İçin Betik Yazma

Microsoft.WinGet.Client PowerShell modülü PowerShell Galerisi'nde kullanılabilir.

Hata ayıklama ve sorun giderme

WinGet , sorunları tanılamaya yardımcı olmak için günlük kaydı sağlar. Hata ayıklama ve sorun giderme ile ilgili günlük kayıtları ve ayrıntılar için bkz. hata ayıklama ve sorun giderme.

Eksik araçlar

Topluluk deposu aracınızı veya uygulamanızı içermiyorsa depomuza bir paket gönderin. Sık kullandığınız aracı ekleyerek sizin ve diğer herkesin kullanımına sunulacaktır.

WinGet ayarlarını özelleştirme

settings.json dosyasını değiştirerek WinGet komut satırı deneyimini yapılandırabilirsiniz. Daha fazla bilgi için ayarlar komutunun sayfasına bakın.

Açık kaynak ayrıntıları

WinGet aracı, deposundaki https://github.com/microsoft/winget-cli/GitHub'da bulunan açık kaynak yazılımdır. İstemciyi derlemek için kaynak, src klasöründebulunur.

WinGet kaynağı bir Visual Studio 2022 C++ çözümünde yer alır. Çözümü doğru şekilde oluşturmak için depoyu kopyalayın ve ".github" dizininde bulunan uygun WinGet Yapılandırma dosyasını çalıştırın.

GitHub'da WinGet kaynağına katkıda bulunmanızı öneririz. Öncelikle Microsoft CLA'yi kabul etmeniz ve imzalamanız gerekir. Pull request'ler kendi fork'unuzdaki bir daldan gelmelidir.

Sorun giderme

Winget-cli deposu, yaygın sorunların ve sık karşılaşılan hataların listesinin yanı sıra aşağıdakilerin nasıl çözüleceğini gösteren öneriler sağlar: