příkaz nastavení (winget)

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

Příkaz nastavení 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:

• konfig

Dílčí příkazy

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

Sub-Command	Popis
exportu	Exportuje nastavení.
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	Umožňuje verbosní 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 winget settings

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

Při prvním spuštění nastavení nebudou zadána žádná nastavení. 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 nastavení.

Následující fragment kódu ukazuje příklad toho, jak může soubor nastavení vypadat s úpravami vizuálního 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 pro soubor nastavení. To vám umožní pomocí tabulátoru zjistit nastavení a syntaxi, pokud editor JSON podporuje schémata JSON.

Aktualizace nastavení

Následující nastavení jsou k dispozici pro verzi 1.11 Správce balíčků systému Windows.

nastavení zdroje

Nastavení source zahrnuje 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.

Nastavení vizuálu

Nastavení visual zahrnuje 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í.

enableSizels

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

nastavení protokolování

Nastavení logging řídí ú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ý

předvolby a nastavení požadavků

Některá nastavení jsou duplikována v části 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 určuje, jaké typy instalačního programu budou vybrány při instalaci balíčku. Odpovídající parametr je --installer-type.

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

nastavení instalačního chování

Nastavení installBehavior řídí výchozí chování při instalaci a upgrade balíčků (kde je to možné).

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í

Nastavení downloadBehavior řídí výchozí adresář, do kterého se stáhnou instalační programy.

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"
    },

Nastavení telemetrie

Nastavení telemetry určuje, zda WinGet zapisuje události ETW, které mohou být odeslány společnosti Microsoft při výchozí instalaci Windows.

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.

Nastavení sítě

Nastavení network ovlivňují, jak WinGet používá síť k načtení 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/winget-settings místo, kde můžete zobrazit experimentální funkce, které jsou vám k dispozici.