inställningskommando (winget)

Med inställningskommandot för WinGet kan du anpassa din Windows Package Manager-klientupplevelse. Du kan ändra standardvärden och prova experimentella funktioner som är tillgängliga i klienten.

Inställningskommandot startar JSON-standardredigeraren. Windows startar som standard Anteckningar som ett alternativ. Vi rekommenderar att du använder ett verktyg som Visual Studio Code.

Anmärkning

Du kan enkelt installera Visual Studio Code genom att skriva winget install Microsoft.VisualStudioCode

Aliasnamn

Följande alias är tillgängliga för det här kommandot:

• konfig

Underkommandon

Följande underkommandon är tillgängliga.

Sub-Command	Beskrivning
exportera	Exportinställningar.
ställ in	Anger värdet för en administratörsinställning.
återställa	Återställer en administratörsinställning till standardvärdet.

Alternativ

Följande alternativ är tillgängliga:

Argumentation	Beskrivning
--möjliggöra	Aktiverar den angivna administratörsinställningen.
--inaktivera	Inaktiverar den angivna administratörsinställningen.
-?,--hjälp	Visar hjälp om det valda kommandot.
--vänta	Uppmanar användaren att trycka på valfri tangent innan den avslutas.
--loggar,--öppna-loggar	Öppnar standardloggplatsen.
--verbose,--verbose-logs	Aktiverar utförlig loggning för winget.
--nowarn (--ingen varning),--ignore-warnings (--ignorera varningar)	Undertrycker varningsutdata.
--disable-interactivity (avaktivera interaktivitet)	Inaktiverar interaktiva uppmaningar.
--proxy	Anger en proxy som ska användas för den här körningen.
--no-proxy	Inaktiverar användningen av proxy för denna exekvering.

Använd kommandot winget settings

Starta standardverktyget för JSON-redigering: winget settings

När du startar inställningarna för första gången anges inga inställningar. Överst i JSON-filen tillhandahåller vi en WinGet CLI-inställningslänk , där du kan identifiera de senaste experimentella funktionerna och inställningarna.

Kodfragmentet nedan visar ett exempel på hur din inställningsfil kan se ut med visuella utdataändringar och experimentella funktioner aktiverade.

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

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

Vi har också definierat ett schema för inställningsfilen. På så sätt kan du använda TAB för att identifiera inställningar och syntax om JSON-redigeraren stöder JSON-scheman.

Uppdatera inställningar

Följande inställningar är tillgängliga för versionen 1.11 av Windows Package Manager.

källinställningar

source Inställningarna omfattar konfiguration av WinGet-källan.

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

automatuppdateringsintervalliMinuter

Ett positivt heltal representerar uppdateringsintervallet i minuter. Kontrollen av uppdateringar sker bara när en källa används. En nolla inaktiverar kontrollen av uppdateringar till en källa. Andra värden är ogiltiga.

• Inaktivera: 0
• Förvalt värde: 15

Om du vill uppdatera källan manuellt använder du winget source update.

visuella inställningar

visual Inställningarna omfattar visuella element som visas av WinGet

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

progressBar

Färg på förloppsindikatorn som WinGet visar när den inte anges av argument.

• accent (förvald)
• regnbåge
• Retro
• sixel
• funktionshindrad

anonymiseraVisadeSökvägar

Ersätter några kända mappsökvägar med respektive miljövariabler.

enableSizels

Aktiverar utdata från sixel-bilder i vissa sammanhang.

loggningsinställningar

logging Inställningarna styr detaljnivån i loggfilerna. --verbose-logs åsidosätter den här inställningen och skapar alltid en utförlig logg.

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

nivå

Följande loggningsnivåer är tillgängliga. Standardvärdet är info om värdet inte har angetts eller är ogiltigt.

• utförlig
• information
• varning
• fel
• kritisk

inställningar för preferenser och krav

Vissa av inställningarna dupliceras under preferences och requirements.

• Inställningen preferences styr hur de olika tillgängliga alternativen sorteras när du väljer den som ska användas. Standardomfånget för paketinstallationer är till exempel för den aktuella användaren, men om det inte är ett alternativ väljs ett installationsprogram på datornivå.
• Inställningen requirements filtrerar alternativen, vilket kan resultera i en tom lista och ett misslyckande att installera. I föregående exempel skulle ett krav på användaromfattning resultera i inga tillämpliga installationsprogram och ett fel.

Argument som skickas på kommandoraden åsidosätter i praktiken matchande requirement inställning under hela kommandot.

omfattning

Beteendet scope styr valet mellan att installera ett paket för den aktuella användaren eller för hela datorn. Den matchande parametern är --scopeoch använder samma värden (user eller machine). Se: kända problem som rör paketinstallationsomfånget.

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

Lokalisering

Beteendet locale styr valet av installationsprogram baserat på installationsspråk. Den matchande parametern är --localeoch använder bcp47-språktagg.

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

Arkitekturer

Beteendet architectures styr vilka arkitekturer som ska väljas när du installerar ett paket. Den matchande parametern är --architecture. Endast arkitekturer som är kompatibla med systemet kan väljas.

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

installatörstyper

Beteendet installerTypes styr vilka installationstyper som ska väljas när du installerar ett paket. Den matchande parametern är --installer-type.

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

installBehavior-inställningar

Inställningarna installBehavior styr standardbeteendet för att installera och uppgradera (om tillämpligt) paket.

inaktiveraInstallationsanteckningar

Inställningen disableInstallNotes avgör om installationsanteckningar visas efter en lyckad installation. Standardvärdet blir false om värdet inte har angetts eller är ogiltigt.

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

portablePackageUserRoot-inställning

Inställningen portablePackageUserRoot definierar standardrotkatalogen för att installera paket under omfånget User . Detta gäller endast för paket med portable installationstypen. Standardvärdet blir %LOCALAPPDATA%/Microsoft/WinGet/Packages/ om värdet inte har angetts eller är ogiltigt.

Det här inställningsvärdet måste vara en absolut sökväg.

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

portablePackageMachineRoot-inställning

Inställningen portablePackageMachineRoot definierar standardrotkatalogen för att installera paket under omfånget Machine . Detta gäller endast för paket med portable installationstypen. Standardvärdet är %PROGRAMFILES%/WinGet/Packages/ om värdet inte har angetts eller är ogiltigt.

Det här inställningsvärdet måste vara en absolut sökväg.

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

defaultInstallRoot

Inställningen defaultInstallRoot anger standardinstallationsplatsen för paket som kräver en explicit installationssökväg, om installationsplatsen inte har angetts.

maxResumes

Inställningen maxResumes anger det maximala antalet återuppta-försök som tillåts för ett enda återuppta-ID. Detta förhindrar kontinuerliga omstarter om en installation som kräver en omstart inte identifieras korrekt.

metod för arkivutvinning

Inställningen archiveExtractionMethod styr hur installationsprogrammet extraherar arkiv. Värden som stöds är shellApi och tar.

• shellApi använder Windows Shell-API:et för att extrahera arkiv.

• tar använder tjärkommandot för att extrahera arkiv.

Avinstallationsbeteende

Inställningen uninstallBehavior styr om standardavinstallationsprocessen tar bort alla filer och kataloger som är relevanta för det här paketet. Gäller endast för den bärbara installerType.

rensa bärbart paket

Inställningen purgePortablePackage styr standardbeteendet för att avinstallera ett bärbart paket. Om värdet är trueinställt på tar avinstallationen bort alla filer och kataloger som är relevanta för portable paketet. Den här inställningen gäller endast för paket med portable installationstypen. Standardvärdet blir false om värdet inte har angetts eller är ogiltigt.

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

ConfigureBehavior

Inställningen ConfigureBehavior anger standardrotkatalogen där PowerShell-moduler installeras vid tillämpning av en konfiguration.

nedladdningsbeteende

Inställningarna downloadBehavior styr standardkatalogen där installationsprogram laddas ned till.

standardnedladdningsmapp

Inställningen defaultDownloadDirectory styr standardkatalogen där paket laddas ned till. Standardvärdet blir %USERPROFILE%/Downloads om värdet inte har angetts eller är ogiltigt.

Det här inställningsvärdet måste vara en absolut sökväg.

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

Inställningar för telemetri

Inställningarna telemetry styr om WinGet skriver ETW-händelser som kan skickas till Microsoft vid en standardinstallation av Windows.

Se information om telemetri och vår primära sekretesspolicy.

inaktivera

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

Om värdet är true telemetry.disable förhindrar inställningen att någon händelse skrivs av programmet.

Nätverksinställningar

Inställningarna network påverkar hur WinGet använder nätverket för att hämta paket och metadata.

nedladdare

Inställningen downloader styr vilken kod som används vid nedladdning av paket. Standardvärdet är do, som kan hanteras av en gruppolicy.

wininet använder WinINet-API :erna medan doleveransoptimeringstjänsten används.

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

doProgressTimeoutInSeconds

doProgressTimeoutInSeconds Anger hur många sekunder som väntas utan förlopp innan återgång.

Interaktivitet

Inställningen Interactivity styr om interaktiva frågor visas av Windows Package Manager-klienten.

Aktivera experimentella funktioner

Om du vill ta reda på vilka experimentella funktioner som är tillgängliga går du till https://aka.ms/winget-settings platsen där du kan se de experimentella funktionerna som är tillgängliga för dig.