beállítások parancs (winget)

A WinGetbeállítási parancsával testre szabhatja a Windows Package Manager ügyfélélményét. Módosíthatja az alapértelmezett beállításokat, és kipróbálhatja az ügyfélben elérhető kísérleti funkciókat.

A beállítások parancs elindítja az alapértelmezett JSON-szerkesztőt. A Windows alapértelmezés szerint elindítja a Jegyzettömbet lehetőségként. Javasoljuk, hogy használjon olyan eszközt, mint a Visual Studio Code.

Megjegyzés:

Egyszerűen telepítheti a Visual Studio Code-ot, ha beírja a(z) winget install Microsoft.VisualStudioCode parancsot.

Aliasok

A parancshoz a következő aliasok érhetők el:

  • konfig

Alparancsok

Az alábbi alparancsok érhetők el.

Sub-Command Leírás
exportálási Exportálási beállítások.
beállítása Beállítja egy rendszergazdai beállítás értékét.
visszaállítás Alaphelyzetbe állítja a rendszergazdai beállításokat az alapértelmezett értékre.

Beállítások

A következő lehetőségek érhetők el:

érvelés Leírás
--engedélyez Engedélyezi a megadott rendszergazdai beállítást.
--letilt Letiltja a megadott rendszergazdai beállítást.
-?--segítség A kijelölt paranccsal kapcsolatos súgó megjelenítése.
--várj Arra kéri a felhasználót, hogy a kilépés előtt nyomja le bármelyik billentyűt.
--naplók,--napló-megnyitása Megnyitja az alapértelmezett naplóhelyet.
--verbose,--verbose-logs Lehetővé teszi a winget részletes naplózását.
--nowarn (ne figyelmeztessen),--ignore-warnings (figyelmeztetések mellőzése) Letiltja a figyelmeztető kimeneteket.
--interaktivitás-letiltása Letiltja az interaktív utasításokat.
--proxy Beállít egy proxyt a végrehajtáshoz.
--no-proxy Letiltja a proxy használatát ehhez a végrehajtáshoz.

A winget settings parancs használata

Indítsa el az alapértelmezett JSON-szerkesztő eszközt: winget settings

Amikor először indítja el a beállításokat, nincsenek megadva beállítások. A JSON-fájl tetején egy WinGet CLI-beállítások hivatkozást biztosítunk, ahol megismerheti a legújabb kísérleti funkciókat és beállításokat.

Az alábbi kódrészlet egy példát mutat be arra, hogyan nézhet ki a beállításfájl, ha engedélyezve van a vizuális kimenet módosítása és a kísérleti funkciók használata.

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

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

Meghatároztunk egy sémát is a beállításfájlhoz. Ez lehetővé teszi, hogy a TAB használatával felderítse a beállításokat és a szintaxist, ha a JSON-szerkesztő támogatja a JSON-sémákat.

Beállítások frissítése

A Következő beállítások érhetők el a Windows Package Manager 1.28-os kiadásához.

forrásbeállítások

A source beállítások a WinGet-forrás konfigurálására is kiterjednek.

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

automatikus frissítési intervallum percekben

A pozitív egész szám a frissítési időközt jelöli percekben. A frissítések ellenőrzése csak forrás használata esetén történik. A nulla letiltja a forrás frissítéseinek ellenőrzését. A többi érték érvénytelen.

  • Letiltás: 0
  • Alapértelmezett: 15

A forrás manuális frissítéséhez használja a következőt winget source update:

vizualizációs beállítások

A visual beállítások a WinGet által megjelenített vizuális elemeket is magukban foglalják

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

folyamatjelző sáv

Annak a folyamatsávnak a színe, amelyet a WinGet megjelenít, amikor az argumentumok nem határozzák meg.

  • ékezet (alapértelmezett)
  • szivárvány
  • retró
  • sixel
  • halványított

anonimizáltMegjelenítettÚtvonalak

Néhány ismert mappa elérési útját lecseréli a megfelelő környezeti változókra.

enableSixels

Engedélyezi a sixel képek kimenetét bizonyos környezetekben.

naplózási beállítások

A logging beállítások szabályozzák a naplófájlok részletességi szintjét. --verbose-logs felülbírálja ezt a beállítást, és mindig létrehoz egy részletes naplót.

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

szint

A következő naplózási szintek érhetők el. Alapértelmezés szerint info-re áll, ha az érték nincs beállítva vagy érvénytelen.

  • bővebb
  • információ
  • figyelmeztetés
  • hiba
  • kritikus

channels

A channels beállítás a naplózási kimenetet adott naplócsatornákra korlátozza. A speciális értékek default (az alapértelmezett csatornakészlet) és all (az összes csatorna) is elfogadottak. A rendszer figyelmen kívül hagyja az érvénytelen értékeket.

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

fájl

A file beállítások szabályozzák a naplófájlok automatikus törlését az alapértelmezett naplókönyvtárban. A törlés minden WinGet-folyamat elején fut, és csak az alapértelmezett naplóhelyre vonatkozik.

Setting Leírás Alapértelmezett
ageLimitInDays Maximális életkor a naplófájltárban lévő fájlok napjaiban; régebbi fájlok törlődnek. Állítsa 0 értékre a letiltáshoz. 7
totalSizeLimitInMB A naplókönyvtárban lévő összes fájl maximális teljes mérete megabájtban; először a legrégebbi fájlokat törli a rendszer. Állítsa 0 értékre a letiltáshoz. 128
countLimit A naplókönyvtárban található fájlok maximális száma; először a legrégebbi fájlokat törli a rendszer. Állítsa 0 értékre a letiltáshoz. 0 (kikapcsolva)
individualSizeLimitInMB Egyetlen naplófájl maximális mérete megabájtban. Ha egy fájl túllépné ezt a korlátot, a naplófájlok felülíródnak. Állítsa 0 -ra a letiltáshoz. 16
"logging": {
    "level": "verbose",
    "file": {
        "ageLimitInDays": 7,
        "totalSizeLimitInMB": 128,
        "countLimit": 0,
        "individualSizeLimitInMB": 16
    }
}

preferenciák és követelmények beállításai

Néhány beállítás duplikálva van az preferences és requirements alatt.

  • A preferences beállítás azt szabályozza, hogy a különböző elérhető lehetőségek hogyan legyenek rendezve, amikor kiválasztja azt, amelyiken cselekedni szeretne. A csomagtelepítések alapértelmezett hatóköre például az aktuális felhasználóra érvényes, de ha ez nem lehetőség, akkor gépszintű telepítő lesz kiválasztva.
  • A requirements beállítás szűri a beállításokat, ami üres listát és sikertelen telepítést eredményezhet. Az előző példában a felhasználói hatókörre vonatkozó követelmény nem eredményezne megfelelő telepítőket és hibát.

A parancssorban átadott argumentumok hatékonyan felülbírálják az adott parancs időtartamára vonatkozó egyező requirement beállítást.

hatókör

A scope viselkedés szabályozza, hogy az aktuális felhasználó vagy a teljes gép csomagjának telepítése között mi a választás. Az egyező paraméter az --scope, és ugyanazokat az értékeket használja (user vagy machine). Lásd a csomagtelepítés hatókörével kapcsolatos ismert problémákat.

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

területi beállítás

A locale viselkedés a telepítő területi beállításai alapján szabályozza a telepítő kiválasztását. Az egyező paraméter a --locale, és a bcp47 nyelvi címkét használja.

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

Architektúrák

A architectures viselkedés szabályozza, hogy milyen architektúrák legyenek kiválasztva egy csomag telepítésekor. A megfelelő paraméter --architecture. Csak a rendszerével kompatibilis architektúrák választhatók ki.

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

telepítő típusok

A installerTypes viselkedés befolyásolja, hogy milyen telepítőtípusok lesznek kiválasztva egy csomag telepítésekor. Azt is meghatározhatja, hogy melyik típust kell alapértelmezés szerint telepíteni, ha egy jegyzék több típussal rendelkezik: A lista prioritási sorrendben van, az első felsorolt típust részesíti előnyben a többivel szemben, és így tovább. Ez kényelmes azoknak a felhasználóknak, akik például a hordozható csomagokat vagy az MSIX/AppX-telepítéseket részesítik előnyben. Az egyező paraméter az --installer-type, amely felülbírálja a beállításokat.

Az 1.12.470-es verzió engedélyezett értékei a következők: appx, , burn, exe, , fontinnomsimsixmsstorenullsoftportablewixzip

Alapértelmezés szerint, és az összes többi tulajdonság egyenlő, a WinGet alapértelmezés szerint az elsőként felsorolt telepítőtípusnak felel meg a jegyzékfájl telepítőjének YAML-jében, ha a csomag még nincs telepítve. Ha már telepítve van, a megfelelő frissítés biztosításához ugyanazzal a telepítőtípussal kell rendelkeznie.

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

installBehavior beállítások

A installBehavior beállítások szabályozzák a csomagok telepítésének és frissítésének alapértelmezett viselkedését (ahol van).

jegyzetek telepítésének letiltása

A disableInstallNotes beállítás meghatározza, hogy a telepítés sikeres telepítése után megjelennek-e a telepítési megjegyzések. Ha nincs beállítva vagy érvénytelen az érték, az alapértelmezett false.

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

portablePackageUserRoot beállítás

A portablePackageUserRoot beállítás meghatározza az alapértelmezett gyökérkönyvtárat a User hatókör alá tartozó csomagok telepítéséhez. Ez csak a telepítőtípusú portable csomagokra vonatkozik. Ha nincs beállítva vagy érvénytelen az érték, az alapértelmezett %LOCALAPPDATA%/Microsoft/WinGet/Packages/.

Ennek a beállítási értéknek abszolút elérési útnak kell lennie.

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

portablePackageMachineRoot beállítás

A portablePackageMachineRoot beállítás meghatározza az alapértelmezett gyökérkönyvtárat a Machine hatókör alá tartozó csomagok telepítéséhez. Ez csak a telepítőtípusú portable csomagokra vonatkozik. Alapértelmezés szerint %PROGRAMFILES%/WinGet/Packages/-re áll, ha az érték nincs beállítva vagy érvénytelen.

Ennek a beállítási értéknek abszolút elérési útnak kell lennie.

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

defaultInstallRoot

A defaultInstallRoot beállítás megadja az explicit telepítési útvonalat igénylő csomagok alapértelmezett telepítési helyét, ha a telepítési hely nincs megadva.

maxResumes

A maxResumes beállítás megadja az egy önéletrajz-azonosítóhoz engedélyezett önéletrajz-kísérletek maximális számát. Ez megakadályozza a folyamatos újraindítást, ha az újraindítást igénylő telepítés nem észlelhető megfelelően.

ArchívumtömörítésiMódszer

A archiveExtractionMethod beállítás szabályozza, hogy a telepítő hogyan nyeri ki az archívumokat. A támogatott értékek shellApi és tar.

  • shellApi A Windows Shell API-t használja az archívumok kinyeréséhez.

  • tar a tar paranccsal kinyeri az archívumokat.

UninstallBehavior

A uninstallBehavior beállítás azt szabályozza, hogy az alapértelmezett eltávolítási folyamat eltávolítja-e a csomaghoz kapcsolódó összes fájlt és könyvtárat. Csak a hordozható installerType.

hordozható csomag törlése

A purgePortablePackage beállítás szabályozza a hordozható csomagok eltávolításának alapértelmezett viselkedését. Ha be van állítva, trueaz eltávolítás eltávolítja a portable csomaghoz kapcsolódó összes fájlt és könyvtárat. Ez a beállítás csak a portable telepítőtípusú csomagokra vonatkozik. Ha nincs beállítva vagy érvénytelen az érték, az alapértelmezett false.

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

Viselkedés Konfigurálása

A ConfigureBehavior beállítás megadja az alapértelmezett gyökérkönyvtárat, ahová a PowerShell-modulok telepítve vannak a konfiguráció alkalmazásakor.

letöltési viselkedés

A downloadBehavior beállítások szabályozzák azt az alapértelmezett könyvtárat, ahová a telepítők letöltődnek.

alapértelmezett letöltési könyvtár

A defaultDownloadDirectory beállítás szabályozza azt az alapértelmezett könyvtárat, amelybe a csomagok letöltődnek. Ha nincs beállítva vagy érvénytelen az érték, az alapértelmezett %USERPROFILE%/Downloads.

Ennek a beállítási értéknek abszolút elérési útnak kell lennie.

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

Telemetriai beállítások

A telemetry beállítások szabályozzák, hogy a WinGet olyan ETW-eseményeket ír-e, amelyeket a Windows alapértelmezett telepítésekor küldhet a Microsoftnak.

Tekintse meg a telemetriarészleteit, valamint a elsődleges adatvédelmi nyilatkozat.

letilt

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

Ha igaz értékre van állítva, a telemetry.disable beállítás megakadályozza, hogy a program bármilyen eseményt megírjon.

Hálózati beállítások

A network beállítások befolyásolják, hogy a WinGet hogyan használja a hálózatot a csomagok és metaadatok lekérésére.

letöltő

A downloader beállítás szabályozza, hogy melyik kódot használja a csomagok letöltésekor. Az alapértelmezett a do, amely a csoportházirend által felügyelhető.

wininet a WinINet API-kat használja, míg do a Kézbesítésoptimalizálás szolgáltatást.

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

doProgressTimeoutIdőtúllépésMásodpercekben

A doProgressTimeoutInSeconds visszalépés előtti várakozási másodpercek számát adja meg.

Interaktivitás

A Interactivity beállítás azt szabályozza, hogy a Windows Package Manager-ügyfél megjelenítse-e az interaktív kéréseket.

Kísérleti funkciók engedélyezése

Ha szeretné felderíteni, hogy mely kísérleti funkciók érhetők el, keresse https://aka.ms/winget-settings fel a rendelkezésre álló kísérleti funkciókat.

A experimentalFeatures beállítások magukban foglalják a "kísérleti" funkciók konfigurálását. Az egyes funkciók engedélyezhetők ezen a csomóponton:

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

directMSI

Ez a funkció lehetővé teszi, hogy a Windows Package Manager közvetlenül telepítse az MSI-csomagokat az MSI API-kkal, nem pedig az msiexec használatával. Vegye figyelembe, hogy a csendes telepítés használatakor ez már érvényben van, mivel a jogosultságszint-emelést igénylő MSI-csomagok ebben a forgatókönyvben nélküle meghiúsulnak.

"experimentalFeatures": {
    "directMSI": true
}

folytatás

Ez a funkció lehetővé teszi, hogy egyes parancsok újrainduljanak az újraindítás után.

"experimentalFeatures": {
    "resume": true
}

Betűtípusok

Ez a funkció lehetővé teszi a betűtípusok támogatását a következővel: winget settings. A winget font list parancs felsorolja a telepített betűtípuscsaládokat és a telepített betűtípus-arcok számát.

"experimentalFeatures": {
    "fonts": true
}

forrásPrioritás

Ez a funkció lehetővé teszi a források számára, hogy prioritásértéket rendeljenek hozzá. A magasabb prioritású források korábban megjelennek a keresési eredményekben, és új csomagok telepítéséhez lesznek kiválasztva, ha több forrás rendelkezik egyező csomaggal.

Vegye figyelembe, hogy a keresési eredmények sorrendje több tényezőtől függ, és a forrás prioritása jelenleg a legalacsonyabb mező (az egyezés minősége és a mező fontosabb).

"experimentalFeatures": {
    "sourcePriority": true
}