Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
WinGet kullanıcıların Windows 10, Windows 11 ve Windows Server 2025 bilgisayarlarında uygulamaları bulmasına, yüklemesine, yükseltmesine, kaldırmasına ve yapılandırmasına olanak tanıyan bir komut satırı aracıdır. Bu araç, Windows Package Manager hizmetinin istemci arabirimidir.
WinGet'i yükleme
WinGet Windows Package Manager Windows 11, modern Windows 10 sürümlerinde ve App Installer kapsamında Windows Server 2025'te kullanılabilir. App Installer Windows Desktop sürümlerinde ve Windows Server 2025 güncelleştirmeleri aracılığıyla Microsoft mağazası tarafından sunulan 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'a bir kullanıcı olarak ilk kez oturum açana kadar WinGet kullanılamaz; bu, Microsoft Store'un Windows Package Manager'ı zaman uyumsuz bir sürecin parçası olarak 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 Package Manager ö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ştirme Kanallarında Windows Insider Program’a kaydolmak için 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 Korumalı Alanı'nda WinGet yükleme
Windows Sandbox 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.
WinGet'in kararlı sürümünü Windows Korumalı Alan'a yüklemek için 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 de dahil olmak üzere Windows Korumalı Alanı hakkında daha fazla bilgi için bkz. Windows Sandbox 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 Windows sizden elevate istemenizi 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.
İ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.
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.
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. |
| show | Belirtilen uygulamanın ayrıntılarını görüntüler. |
| kaynak | WinGet tarafından erişilen Windows Package Manager depolarını ekler, kaldırır ve güncelleştirir. |
| arama | Bir uygulamayı arar. |
| list | 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 | Manifest dosyasını Windows Package Manager deposuna göndermek için doğrular. |
| Ayarlar | Ayarları açın. |
| özellikleri | Deneysel özelliklerin durumunu gösterir. |
| export | Yüklü paketlerin listesini dışarı aktarır. |
| import | Tüm paketleri bir dosyaya yükler. |
| pin | Paket pinlerini yönetme. |
| Yapılandırmak | Sistemi istenen bir duruma yapılandırıyor. |
| download | Belirtilen uygulamanın yükleyicisini indirir. |
| repair | Seçili uygulamayı onarıyor. |
| dscv3 | PowerShell Desired State Configuration (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 Gallery'de 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ı, GitHub https://github.com/microsoft/winget-cli/ deposunda bulunan open source yazılımdır. İstemciyi derlemek için kaynak, src klasöründebulunur.
WinGet kaynağı 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 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:
GitHub'da bizimle işbirliği yapın
Bu içeriğin kaynağı GitHub'da bulunabilir; burada ayrıca sorunları ve çekme isteklerini oluşturup gözden geçirebilirsiniz. Daha fazla bilgi için katkıda bulunan kılavuzumuzu inceleyin.
Windows developer