settings příkaz (winget)

Příkaz settingsWinGet umožňuje přizpůsobit prostředí klienta Windows Správce balíčků. Můžete změnit výchozí hodnoty a vyzkoušet experimentální funkce, které jsou dostupné ve vašem klientovi.

Příkaz settings spustí výchozí editor JSON. Windows ve výchozím nastavení spustí Poznámkový blok jako možnost. Doporučujeme použít nástroj, jako je Visual Studio Code.

Poznámka:

Visual Studio Code můžete snadno nainstalovat zadáním winget install Microsoft.VisualStudioCode

Přezdívky

Pro tento příkaz jsou k dispozici následující aliasy:

config

Dílčí příkazy

K dispozici jsou následující dílčí příkazy.

Sub-Command	Popis
exportu	Exportovat settings.
nastavit	Nastaví hodnotu nastavení správce.
resetování	Obnoví nastavení správce na výchozí hodnotu.

Možnosti

K dispozici jsou následující možnosti:

Důvod	Popis
--enable	Povolí zadané nastavení správce.
--vypnout	Zakáže zadané nastavení správce.
-?--Pomoc	Zobrazuje nápovědu k vybranému příkazu.
--Počkej	Před ukončením vyzve uživatele, aby stiskl libovolnou klávesu.
--logy,--otevřít-logy	Otevře výchozí umístění protokolů.
--verbose,--verbose-logs	Povolí podrobné protokolování pro winget.
--nowarn,--ignore-warnings (bez varování, ignorovat varování)	Potlačí varovné výstupy.
--zakázat-interaktivitu	Zakáže interaktivní výzvy.
--proxy	Nastaví proxy server, který se má použít pro toto spuštění.
--no-proxy	Zakáže použití proxy serveru pro toto spuštění.

Použijte příkaz wingetsettings

Spusťte výchozí nástroj pro úpravy JSON: winget settings

Při prvním spuštění settings nebude zadána žádná settings. V horní části souboru JSON poskytujeme odkaz na nastavení rozhraní příkazového řádku WinGet , kde můžete zjistit nejnovější experimentální funkce a settings.

Následující fragment kódu ukazuje příklad toho, jak může soubor settings vypadat s vizuálními úpravami výstupu a povolenými experimentálními funkcemi.

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

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

Také jsme definovali schéma souboru settings . To vám umožní pomocí tabulátoru zjistit settings a syntaxi, pokud editor JSON podporuje schémata JSON.

Aktualizuje se settings

Pro verzi 1.28 Windows Správce balíčků jsou k dispozici následující settings.

Zdroj settings

source settings zahrnují konfiguraci zdroje WinGet.

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

intervalAutomatickéAktualizaceVeMinutách

Kladné celé číslo představuje interval aktualizace v minutách. Ke kontrole aktualizací dochází jenom v případě, že se použije zdroj. Nula zakáže kontrolu aktualizací zdroje. Všechny ostatní hodnoty jsou neplatné.

Zakázat: 0
Výchozí hodnota: 15

Chcete-li zdroj aktualizovat ručně, použijte winget source update.

vizuální settings

Zahrnuje visualsettings vizuální prvky, které jsou zobrazeny nástrojem WinGet.

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

progressBar

Barva indikátoru průběhu, který WinGet zobrazí, když není určen pomocí argumentů.

akcent (výchozí)
duha
retro
sixel
neaktivní

anonymizeDisplayedPaths

Nahradí některé známé cesty ke složkám odpovídajícími proměnnými prostředí.

enableSixels

Umožňuje výstup sixel obrázků v určitých kontextech.

protokolování settings

Určuje loggingsettings úroveň podrobností v souborech protokolu. --verbose-logs toto nastavení přepíše a vždy vytvoří podrobný protokol.

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

úroveň

Následující úrovně protokolování jsou k dispozici. Výchozí hodnota je info , pokud hodnota není nastavená nebo je neplatná.

podrobný
informace
upozornění
chyba
kritický

channels

Nastavení channels omezuje výstup protokolování na konkrétní kanály protokolu. Přijímají se také speciální hodnoty default (výchozí sada kanálů) a all (všechny kanály). Neplatné hodnoty jsou ignorovány.

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

soubor

file settings řídí automatické čištění souborů protokolů ve výchozím adresáři protokolů. Vyčištění se spustí na začátku každého procesu WinGet a vztahuje se pouze na výchozí umístění protokolu.

Setting	Popis	Výchozí
`ageLimitInDays`	Maximální stáří souborů ve dnech v adresáři protokolu; starší soubory se odstraní. Nastavte na `0`, abyste zakázali.	7
`totalSizeLimitInMB`	Maximální celková velikost v megabajtech všech souborů v adresáři protokolu; nejstarší soubory jsou nejprve odstraněny. Nastavte na `0`, abyste zakázali.	128
`countLimit`	Maximální počet souborů v adresáři protokolu; nejstarší soubory jsou nejprve odstraněny. Nastavte na `0`, abyste zakázali.	0 (zakázáno)
`individualSizeLimitInMB`	Maximální velikost v megabajtech jednoho souboru protokolu. Pokud by soubor tento limit překročil, protokoly se zabalí. Nastavte na `0`, abyste zakázali.	16

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

předvolby a požadavky settings

Některé z settings se zobrazují duplicitně pod preferences a requirements.

Nastavení preferences určuje, jak se různé dostupné volby seřadí při jejich výběru. Výchozí obor instalací balíčků je například pro aktuálního uživatele, ale pokud to není možnost, zvolí se instalační program na úrovni počítače.
Nastavení requirements filtruje možnosti, což může mít za následek prázdný seznam a selhání instalace. V předchozím příkladu by požadavek na obor uživatele vedl k žádným použitelným instalačním programům a chybě.

Všechny argumenty předané na příkazovém řádku účinně přepíší všechna nastavení odpovídající requirement po dobu trvání tohoto příkazu.

obor

Chování scope řídí volbu mezi instalací balíčku pro aktuálního uživatele nebo pro celý počítač. Odpovídající parametr je --scopea používá stejné hodnoty (user nebo machine). Viz známé problémy související s rozsahem instalace balíčku.

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

národní prostředí

Chování locale řídí výběr instalačního programu na základě národního prostředí instalačního programu. Odpovídající parametr je --localea používá značku jazyka bcp47.

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

architektury

Chování architectures určuje, jaké architektury budou vybrány při instalaci balíčku. Odpovídající parametr je --architecture. Je možné vybrat pouze architektury kompatibilní s vaším systémem.

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

typy_instalátoru

Chování installerTypes ovlivňuje, jaké typy instalačního programu budou vybrány při instalaci balíčku. Může také určit, který typ se má ve výchozím nastavení nainstalovat, pokud má manifest více typů: Seznam je v pořadí priority, přičemž první uvedený typ se upřednostňuje před ostatními a tak dále. To je vhodné pro uživatele, kteří například dávají přednost přenositelným balíčkům nebo instalacím MSIX/AppX. Odpovídající parametr je --installer-type, který přepíše settings.

Povolené hodnoty od verze 1.12.470: appx, , burn, exefont, inno, msi, msix, msstore, nullsoft, , portablewixzip

Ve výchozím nastavení, se všemi ostatními vlastnostmi, které jsou stejné, WinGet zvolí typ instalačního programu uvedený jako první v manifestu YAML instalačního programu, pokud balíček ještě nebyl nainstalován. Pokud už je nainstalovaný, bude k zajištění správného upgradu potřeba stejný typ instalačního programu.

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

chování instalace settings

installBehavior settings řídí výchozí chování při instalaci a aktualizaci balíčků (podle potřeby).

disableInstallNotes

Nastavení disableInstallNotes určuje, jestli se po úspěšné instalaci zobrazí poznámky k instalaci. Výchozí hodnota je false , pokud hodnota není nastavená nebo je neplatná.

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

Nastavení portablePackageUserRoot

Nastavení portablePackageUserRoot definuje výchozí kořenový adresář pro instalaci balíčků v User rámci oboru. To platí jenom pro balíčky s typem instalačního portable programu. Výchozí hodnota je %LOCALAPPDATA%/Microsoft/WinGet/Packages/ , pokud hodnota není nastavená nebo je neplatná.

Tato hodnota nastavení musí být absolutní cestou.

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

Nastavení portablePackageMachineRoot

Nastavení portablePackageMachineRoot definuje výchozí kořenový adresář pro instalaci balíčků v Machine rámci oboru. To platí jenom pro balíčky s typem instalačního portable programu. Výchozí hodnota je %PROGRAMFILES%/WinGet/Packages/ , pokud hodnota není nastavená nebo je neplatná.

Tato hodnota nastavení musí být absolutní cestou.

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

defaultInstallRoot

Nastavení defaultInstallRoot určuje výchozí umístění instalace pro balíčky, které vyžadují explicitní instalační cestu, pokud umístění instalace není zadané.

maxResumes

Nastavení maxResumes určuje maximální počet pokusů o obnovení povolených pro jedno ID obnovení. Tím se zabrání průběžnému restartování, pokud se správně nerozpozná instalace vyžadující restartování.

metoda extrakce archivu

Nastavení archiveExtractionMethod určuje, jak instalační program extrahuje archivy. Podporované hodnoty jsou shellApi a tar.

shellApi k extrakci archivů používá rozhraní API prostředí Windows.
tar pomocí příkazu tar extrahuje archivy.

Chování při odinstalaci

Nastavení uninstallBehavior určuje, zda výchozí proces odinstalace odebere všechny soubory a adresáře relevantní pro tento balíček. Platí pouze pro přenosnou verzi installerType.

purgePortablePackage

Nastavení purgePortablePackage řídí výchozí chování při odinstalaci přenosného balíčku. Pokud je tato možnost nastavená, trueodinstalace odebere všechny soubory a adresáře, které jsou pro portable balíček relevantní. Toto nastavení platí jenom pro balíčky s typem instalačního portable programu. Výchozí hodnota je false , pokud hodnota není nastavená nebo je neplatná.

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

Konfigurace chování

Nastavení ConfigureBehavior určuje výchozí kořenový adresář, do kterého se při použití konfigurace nainstalují moduly PowerShellu.

stahovací chování

downloadBehavior settings určují výchozí adresář, do kterého se stahují instalační soubory.

výchozí adresář pro stahování

Nastavení defaultDownloadDirectory řídí výchozí adresář, do kterého se stahují balíčky. Výchozí hodnota je %USERPROFILE%/Downloads , pokud hodnota není nastavená nebo je neplatná.

Tato hodnota nastavení musí být absolutní cestou.

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

Telemetrie settings

telemetry settings určují, zda WinGet zapisuje události ETW (Event Tracing for Windows), které můžou být ve výchozí instalaci systému Windows odesílány společnosti Microsoft.

Viz podrobnosti o telemetriia naše zásady ochrany osobních údajů.

vypnout

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

Pokud je nastavená telemetry.disable hodnota true, nastavení zabrání zápisu jakékoli události programem.

Síť settings

network settings ovlivňují způsob, jakým WinGet používá síť k získávání balíčků a metadat.

stahovací program

Nastavení downloader určuje, který kód se používá při stahování balíčků. Výchozí hodnota je do, která může být spravována zásadami skupiny.

wininet používá rozhraní API WinINet , zatímco do používá službu Optimalizace doručení .

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

doProgressTimeoutInSeconds

Určuje doProgressTimeoutInSeconds počet sekund čekání bez postupu před přechodem.

Interaktivita

Nastavení Interactivity určuje, jestli jsou interaktivní výzvy zobrazeny klientem Správce balíčků systému Windows.

Povolení experimentálních funkcí

Pokud chcete zjistit, které experimentální funkce jsou k dispozici, přejděte na https://aka.ms/wingethttps://aka.ms/winget-settings kde můžete zobrazit experimentální funkce, které jsou vám k dispozici.

experimentalFeatures settings zahrnují konfiguraci těchto „experimentálních“ funkcí. Jednotlivé funkce je možné povolit v tomto uzlu:

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

directMSI

Tato funkce umožňuje Správci balíčků systému Windows přímo instalovat balíčky MSI pomocí rozhraní API MSI, nikoli prostřednictvím msiexec. Mějte na paměti, že pokud se použije bezobslužná instalace, je to již v platnosti, protože balíčky MSI, které vyžadují zvýšení oprávnění, v tomto scénáři selžou.

"experimentalFeatures": {
    "directMSI": true
}

pokračovat

Tato funkce umožňuje podporu některých příkazů k obnovení po restartování.

"experimentalFeatures": {
    "resume": true
}

Písma

Tato funkce umožňuje podporu písem prostřednictvím winget settings. Příkaz winget font list zobrazí seznam nainstalovaných rodin písem a počet nainstalovaných řezů písma.

"experimentalFeatures": {
    "fonts": true
}

Priorita zdroje

Tato funkce umožňuje zdrojům přiřadit hodnotu priority. Zdroje s vyšší prioritou se zobrazí dříve ve výsledcích hledání a budou vybrány pro instalaci nových balíčků, pokud má více zdrojů odpovídající balíček.

Všimněte si, že řazení výsledků hledání závisí na několika faktorech, přičemž priorita zdroje je aktuálně méně významným kriteriem (shoda kvality a pole mají větší význam).

"experimentalFeatures": {
    "sourcePriority": true
}

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-05-20

settings příkaz (winget)

Přezdívky

Dílčí příkazy

Možnosti

Použijte příkaz wingetsettings

Aktualizuje se settings

Zdroj settings

intervalAutomatickéAktualizaceVeMinutách

vizuální settings

progressBar

anonymizeDisplayedPaths

enableSixels

protokolování settings

úroveň

channels

soubor

předvolby a požadavky settings

obor

národní prostředí

architektury

typy_instalátoru

chování instalace settings

disableInstallNotes

Nastavení portablePackageUserRoot

Nastavení portablePackageMachineRoot

defaultInstallRoot

maxResumes

metoda extrakce archivu

Chování při odinstalaci

purgePortablePackage

Konfigurace chování

stahovací chování

výchozí adresář pro stahování

Telemetrie settings

vypnout

Síť settings

stahovací program

doProgressTimeoutInSeconds

Interaktivita

Povolení experimentálních funkcí

directMSI

pokračovat

Písma

Priorita zdroje

Váš názor

Další materiály