ayarlar komutu (winget)

WinGet'inayarlar komutu, Windows Paket Yöneticisi istemci deneyiminizi özelleştirmenize olanak tanır. Varsayılanları değiştirebilir ve istemcinizde kullanılabilen deneysel özellikleri deneyebilirsiniz.

Ayarlar komutu varsayılan JSON düzenleyicinizi başlatır. Windows varsayılan olarak Not Defteri'yi bir seçenek olarak başlatır. Visual Studio code gibi bir araç kullanmanızı öneririz.

Uyarı

Yazarak Visual Studio Code'u kolayca yükleyebilirsiniz winget install Microsoft.VisualStudioCode

Takma Adlar

Bu komut için aşağıdaki diğer adlar kullanılabilir:

• konfigürasyon

Alt komutlar

Aşağıdaki alt komutlar kullanılabilir.

Sub-Command	Açıklama
dışa aktarım	Ayarları dışarı aktarır.
ayarla	Yönetici ayarının değerini ayarlar.
sıfırlama	Yönetici ayarını varsayılan değerine sıfırlar.

Seçenekler

Aşağıdaki seçenekler kullanılabilir:

Tartışma	Açıklama
--etkinleştirmek	Belirtilen yönetici ayarını etkinleştirir.
--devre dışı bırakmak	Belirtilen yönetici ayarını devre dışı bırakır.
- ?, --yardım	Seçili komutla ilgili 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.

Winget ayarları komutunu kullanma

Varsayılan JSON düzenleme aracınızı başlatın: winget settings

Ayarları ilk kez başlattığınızda, hiçbir ayar belirtilmez. JSON dosyasının üst kısmında, en son deneysel özellikleri ve ayarları keşfedebileceğiniz bir WinGet CLI Ayarları bağlantısı sunuyoruz.

Aşağıdaki kod parçacığında, görsel çıkış değişiklikleri ve deneysel özellikler etkinleştirildiğinde ayarlar dosyanızın nasıl görünebileceğine ilişkin bir örnek gösterilmektedir.

{
    "$schema": "https://aka.ms/winget-settings.schema.json",

    "visual": {
        "enableSixels": true,
        "progressBar": "rainbow"
    },
    "experimentalFeatures": {
        "experimentalARG": true,
        "experimentalCMD": true
    }
}

Ayrıca ayarlar dosyası için bir şema tanımladık. Bu, JSON düzenleyiciniz JSON şemalarını destekliyorsa ayarları ve söz dizimini keşfetmek için SEKME kullanmanıza olanak tanır.

Ayarları güncelleştirme

Windows Paket Yöneticisi'nin 1.28 sürümü için aşağıdaki ayarlar kullanılabilir.

kaynak ayarları

Ayarlar WinGet source kaynağına yapılandırmayı içerir.

"source": {
    "autoUpdateIntervalInMinutes": 60
},

otomatikGüncellemeAralığıDakikaCinsinden

Pozitif tamsayı, güncelleştirme aralığını dakika cinsinden temsil eder. Güncelleştirme denetimi yalnızca bir kaynak kullanıldığında gerçekleşir. Sıfır, kaynak güncelleştirmeleri denetimini devre dışı bırakır. Diğer tüm değerler geçersiz.

• Devre dışı bırak: 0
• Varsayılan: 15

Kaynağı el ile güncelleştirmek için kullanın winget source update.

görsel ayarları

Ayarlar, WinGet visual tarafından görüntülenen görsel unsurları içerir

"visual": {
    "enableSixels": true,
    "progressBar": "rainbow"
},

ilerleme çubuğu

Bağımsız değişkenler tarafından belirtilmediğinde WinGet'in görüntülediği ilerleme çubuğunun rengi.

• vurgu (varsayılan)
• gökkuşağı
• Retro
• sixel
• engelli

Görüntülenen Yolları Anonimleştir

Bazı bilinen klasör yollarını ilgili ortam değişkenleriyle değiştirir.

enableSixels

Belirli bağlamlarda sixel görüntülerin çıkışını etkinleştirir.

kayıt ayarları

Ayarlar logging günlük dosyalarındaki ayrıntı düzeyini denetler. --verbose-logs bu ayarı geçersiz kılar ve her zaman ayrıntılı bir günlük oluşturur.

"logging": {
    "level": "verbose"
}

seviye

Aşağıdaki günlük düzeyleri kullanılabilir. info Değerin ayarlanmaması veya geçersiz olması durumunda varsayılan olarak ayarlanır.

• fazla kelimeli
• Bilgi
• uyarı
• hata
• kritik

channels

Bu channels ayar log çıktısını belirli log kanallarıyla kısıtlar. Özel değerler default (varsayılan kanal kümesi) ve all (tüm kanallar) da kabul edilir. Geçersiz değerler yoksayılır.

"logging": {
    "channels": ["default"]
}

dosya

Ayarlar, file varsayılan günlük dizinindeki günlük dosyalarının otomatik olarak temizlenmesini denetler. Temizleme her WinGet işleminin başlangıcında çalışır ve yalnızca varsayılan kayıt konumuna uygulanır.

Setting	Açıklama	Varsayılan
ageLimitInDays	Günlük dizinindeki dosyaların gün sayısı üst sınırı; eski dosyalar silinir. Devre dışı bırakmak için 0 olarak ayarlayın.	7
totalSizeLimitInMB	Günlük dizinindeki tüm dosyaların megabayt cinsinden toplam boyutu üst sınırı; en eski dosyalar önce silinir. Devre dışı bırakmak için 0 ayarlayın.	128
countLimit	Günlük dizinindeki en fazla dosya sayısı; en eski dosyalar önce silinir. Devre dışı bırakmak için 0 olarak ayarlayın.	0 (devre dışı)
individualSizeLimitInMB	Tek bir günlük dosyasının boyut üst sınırı megabayt cinsinden. Bir dosya bu sınırı aşarsa günlükler dairesel şekilde devam eder. Devre dışı bırakmak için 0 olarak ayarlayın.	16

"logging": {
    "level": "verbose",
    "file": {
        "ageLimitInDays": 7,
        "totalSizeLimitInMB": 128,
        "countLimit": 0,
        "individualSizeLimitInMB": 16
    }
}

tercihler ve gereksinimler ayarları

Bazı ayarlar preferences ve requirements altında tekrarlanır.

• Ayar, preferences üzerinde işlem yapmak istediğiniz seçeneği seçerken kullanılabilen çeşitli seçeneklerin nasıl sıralanacağını denetler. Örneğin, paket yüklemelerinin varsayılan kapsamı geçerli kullanıcı içindir, ancak bu bir seçenek değilse bir makine düzeyi yükleyicisi seçilir.
• Bu requirements ayar seçenekleri filtreleyerek boş bir liste ve yükleme hatasına neden olabilir. Önceki örnekte, bir kullanıcı kapsamı gereksinimi, geçerli yükleyicilerin olmaması ve bir hatayla sonuçlanacaktır.

Komut satırına geçirilen tüm bağımsız değişkenler, bu komutun süresi boyunca eşleşen requirement ayarı etkili bir şekilde geçersiz kılar.

kapsam

scope davranışı, geçerli kullanıcı veya tüm makine için paket yükleme seçimini kontrol eder. Eşleşen parametre şeklindedir --scopeve aynı değerleri (user veya machine) kullanır. Paket yükleme kapsamıile ilgili bilinen sorunlara bakın.

"installBehavior": {
    "preferences": {
        "scope": "user"
    }
},

Yerel ayar

Davranış, locale yükleyici yerel ayarına göre yükleyici seçimini denetler. Eşleşen parametre şeklindedir --localeve bcp47 dil etiketini kullanır.

"installBehavior": {
    "preferences": {
        "locale": [ "en-US", "fr-FR" ]
    }
},

Mimarileri

Davranış, architectures bir paket yüklenirken hangi mimarilerin seçileceğini denetler. Eşleşen parametre şeklindedir --architecture. Yalnızca sisteminizle uyumlu mimariler seçilebilir.

    "installBehavior": {
        "preferences": {
            "architectures": ["x64", "arm64"]
        }
    },

yükleyiciTürleri

Bu davranış, installerTypes paket yüklenirken hangi yükleyici türlerinin seçileceğini etkiler. Ayrıca, bir bildirimin birden çok türü varsa varsayılan olarak hangi türün yükleneceğini de belirleyebilir: Liste öncelik sırasına göredir ve listelenen ilk tür diğerlerine göre tercih edilir ve bu şekilde devam eder. Bu, örneğin taşınabilir paketleri veya MSIX/AppX yüklemelerini tercih eden kullanıcılar için kullanışlıdır. Ayarları geçersiz kılacak olan eşleşen parametre --installer-type.

Sürüm 1.12.470 itibarıyla izin verilen değerler şunlardır: , , , , , appxburn, exefontinnomsimsix, msstorenullsoftportablewixzip

Varsayılan olarak ve diğer tüm özellikler eşit olduğunda, paket henüz yüklenmemişse, WinGet varsayılan olarak bildirimin yükleyici YAML'sinde ilk listelenen yükleyici türünü kullanır. Zaten yüklüyse, düzgün bir yükseltmeyi sağlamak için aynı yükleyici türü gerekir.

    "installBehavior": {
        "preferences": {
            "installerTypes": ["msix", "msi"]
        }
    },

installBehavior ayarları

Ayarlar, installBehavior paketleri yükleme ve yükseltme (uygun olduğunda) için varsayılan davranışı denetler.

Yükleme Notlarını Devre Dışı Bırak

Bu ayar, disableInstallNotes yükleme notlarının başarılı bir yüklemeden sonra gösterilip gösterilmeyeceğini belirler. Eğer değer ayarlanmadıysa veya geçersizse, varsayılan false olarak belirlenir.

    "installBehavior": {
        "disableInstallNotes": true
    },

portablePackageUserRoot ayarı

ayarı, portablePackageUserRoot kapsam altındaki User paketleri yüklemek için varsayılan kök dizini tanımlar. Bu yalnızca yükleyici türüne portable sahip paketler için geçerlidir. Eğer değer ayarlanmadıysa veya geçersizse, varsayılan %LOCALAPPDATA%/Microsoft/WinGet/Packages/ olarak belirlenir.

Bu ayar değeri mutlak bir yol olmalıdır.

    "installBehavior": {
        "portablePackageUserRoot": "C:/Users/FooBar/Packages"
    },

portablePackageMachineRoot ayarı

ayarı, portablePackageMachineRoot kapsam altındaki Machine paketleri yüklemek için varsayılan kök dizini tanımlar. Bu yalnızca yükleyici türüne portable sahip paketler için geçerlidir. %PROGRAMFILES%/WinGet/Packages/ Değerin ayarlanmaması veya geçersiz olması durumunda varsayılan olarak ayarlanır.

Bu ayar değeri mutlak bir yol olmalıdır.

    "installBehavior": {
        "portablePackageMachineRoot": "C:/Program Files/Packages/Portable"
    },

defaultInstallRoot

Ayar, defaultInstallRoot yükleme konumu belirtilmemişse, açık yükleme yolu gerektiren paketler için varsayılan yükleme konumunu belirtir.

maxResumes

Bu ayar, maxResumes tek bir özgeçmiş kimliği için izin verilen en fazla özgeçmiş denemesi sayısını belirtir. Bu, yeniden başlatma gerektiren bir yükleme düzgün algılanmazsa sürekli yeniden başlatmaları önler.

arşiv çıkarma yöntemi

Ayar, archiveExtractionMethod yükleyicinin arşivleri nasıl ayıklayacağını denetler. Desteklenen değerler shellApi ve tar.

• shellApi arşivleri açmak için Windows Kabuk API'sini kullanır.

• tar arşivleri ayıklamak için tar komutunu kullanır.

UninstallBehavior

Ayar, uninstallBehavior varsayılan kaldırma işleminin bu paketle ilgili tüm dosyaları ve dizinleri kaldırıp kaldırmayacağını denetler. Yalnızca taşınabilir installerTypeiçin geçerlidir.

TaşınabilirPaketiTemizle

purgePortablePackage ayarı, taşınabilir paketin kaldırıma işlemi için varsayılan davranışı kontrol eder. olarak ayarlanırsa true, kaldırma işlemi paketle portable ilgili tüm dosyaları ve dizinleri kaldırır. Bu ayar yalnızca yükleyici türüne portable sahip paketler için geçerlidir. Eğer değer ayarlanmadıysa veya geçersizse, varsayılan false olarak belirlenir.

    "uninstallBehavior": {
        "purgePortablePackage": true
    },

YapılandırDavranış

ayarı, ConfigureBehavior yapılandırma uygulanırken PowerShell modüllerinin yüklendiği varsayılan kök dizini belirtir.

indirmeDavranışı

Ayarlar, downloadBehavior yükleyicilerin indirildiği varsayılan dizini denetler.

varsayılan indirme dizini

ayarı, defaultDownloadDirectory paketlerin indirildiği varsayılan dizini denetler. Eğer değer ayarlanmadıysa veya geçersizse, varsayılan %USERPROFILE%/Downloads olarak belirlenir.

Bu ayar değeri mutlak bir yol olmalıdır.

    "downloadBehavior": {
        "defaultDownloadDirectory": "C:/Users/FooBar/Downloads"
    },

Telemetri ayarları

WinGet'in ETW olaylarını varsayılan bir Windows yüklemesinde Microsoft'a gönderilebilecek şekilde yazıp yazmayacağını telemetry ayarları denetler.

telemetriayrıntılarına vebirincil gizlilik bildirimimize bakın.

devre dışı bırak

"telemetry": {
    "disable": true
},

True olarak ayarlanırsa, telemetry.disable ayar herhangi bir olayın program tarafından yazılmasını engeller.

Ağ ayarları

Ayarlar, WinGet'in network paketleri ve meta verileri almak için ağı nasıl kullandığını etkiler.

indirici

Ayarı, downloader paketleri indirirken hangi kodun kullanılacağını denetler. Varsayılan değer do olup, Grup İlkesi tarafından yönetilebilir.

wininet WinINet API'lerini kullanırken, doTeslim İyileştirme hizmetini kullanır.

"network": {
    "downloader": "wininet"
}

doProgressTimeoutInSeconds

doProgressTimeoutInSeconds herhangi bir ilerleme olmadan önce beklenmesi gereken saniye sayısını belirtir.

Etkileşim

Bu ayar, Interactivity Etkileşimli istemlerin Windows Paket Yöneticisi istemcisi tarafından gösterilip gösterilmediğini denetler.

Deneysel özellikleri etkinleştirme

Mevcut deneysel özellikleri keşfetmek için, kullanabileceğiniz deneysel özellikleri görmek üzere https://aka.ms/winget-settings'a gidin.

Ayarlar, experimentalFeatures bu "deneysel" özelliklerin yapılandırılmasını içerir. Bu düğüm altında tek tek özellikler etkinleştirilebilir:

"experimentalFeatures": {
    "directMSI": true,
    "resume": true
}

directMSI

Bu özellik, Windows Paket Yöneticisi'nin MSI paketlerini msiexec yerine MSI API'leriyle doğrudan yüklemesini sağlar. Sessiz yükleme kullanıldığında, yükseltme gerektiren MSI paketleri bu senaryo olmadan başarısız olacağı için bunun zaten geçerli olduğunu unutmayın.

"experimentalFeatures": {
    "directMSI": true
}

özgeçmiş

Bu özellik, yeniden başlatma sonrasında bazı komutların devam etmesi için destek sağlar.

"experimentalFeatures": {
    "resume": true
}

Yazı tip -leri

Bu özellik aracılığıyla winget settingsyazı tipleri için destek sağlar. Komutu, winget font list yüklü yazı tipi ailelerini ve yüklü yazı tipi yüzlerinin sayısını listeler.

"experimentalFeatures": {
    "fonts": true
}

kaynakÖnceliği

Bu özellik, kaynakların atanmış bir öncelik değerine sahip olmasını sağlar. Daha yüksek önceliğe sahip kaynaklar arama sonuçlarında daha önce görünür ve birden çok kaynağın eşleşen bir paketi olduğunda yeni paketleri yüklemek için seçilir.

Arama sonucu sıralamanın birkaç faktöre bağlı olduğunu ve kaynak önceliğinin şu anda en düşük alan olduğunu unutmayın (kalite ve alan eşleştirme daha önemlidir).

"experimentalFeatures": {
    "sourcePriority": true
}