settings opdracht (winget)

Met de opdracht settings van WinGet kunt u uw Windows Pakketbeheer-clientervaring aanpassen. U kunt de standaardinstellingen wijzigen en experimentele functies uitproberen die beschikbaar zijn in uw client.

Met de settings opdracht wordt uw standaard-JSON-editor gestart. In Windows wordt Kladblok standaard automatisch als een van de opties gestart. U wordt aangeraden een hulpprogramma zoals Visual Studio Code te gebruiken.

Opmerking

U kunt Visual Studio Code eenvoudig installeren door te typen winget install Microsoft.VisualStudioCode

Aliassen

De volgende aliassen zijn beschikbaar voor deze opdracht:

  • config

Subopdrachten

De volgende subopdrachten zijn beschikbaar.

Sub-Command Beschrijving
exporteren Exporteert settings.
instellen Hiermee stelt u de waarde van een beheerdersinstelling in.
opnieuw instellen Hiermee stelt u een beheerderinstelling opnieuw in op de standaardwaarde.

Opties

De volgende opties zijn beschikbaar:

Argumentatie Beschrijving
--inschakelen Hiermee schakelt u de opgegeven beheerdersinstelling in.
--uitschakelen Hiermee schakelt u de opgegeven beheerdersinstelling uit.
-?,--help Geeft hulp bij het geselecteerde commando.
--wachten Vraagt de gebruiker om, voordat het programma wordt afgesloten, op een willekeurige toets te drukken.
--logs,--open-logs Hiermee opent u de standaardlocatie voor logboeken.
--uitgebreide,--verbose-logs Hiermee schakelt u gedetailleerde logboekregistratie in voor winget.
--nowarn, geen waarschuwingen weergeven; --ignore-warnings, waarschuwingen negeren Onderdrukt waarschuwingsuitvoer.
--disable-interactivity (interactiviteit uitschakelen) Hiermee schakelt u interactieve prompts uit.
--proxy Hiermee stelt u een proxy in voor deze uitvoering.
--no-proxy Hiermee wordt het gebruik van proxy uitgeschakeld voor deze uitvoering.

winget settings De opdracht gebruiken

Start uw standaardhulpprogramma voor JSON-bewerking: winget settings

Wanneer u de settings eerste keer start, wordt er geen settings opgegeven. Boven aan het JSON-bestand bieden we een koppeling naar WinGet CLI-instellingen , waar u de nieuwste experimentele functies kunt ontdekken en settings.

In het onderstaande codefragment ziet u een voorbeeld van hoe uw settings bestand eruit kan zien met visuele uitvoerwijzigingen en experimentele functies ingeschakeld.

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

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

We hebben ook een schema voor het settings bestand gedefinieerd. Hiermee kun je TAB gebruiken om settings en syntaxis aan te vullen als je JSON-editor JSON-schema's ondersteunt.

Bijwerken settings

De volgende settings zijn beschikbaar voor de versie 1.28 van de Windows Pakketbeheer.

bron settings

De sourcesettings houden configuratie van de WinGet-bron in.

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

auto-update-interval in minuten

Een positief geheel getal vertegenwoordigt het update-interval in minuten. De controle op updates vindt alleen plaats wanneer een bron wordt gebruikt. Met een nul wordt de controle op updates voor een bron uitgeschakeld. Alle andere waarden zijn ongeldig.

  • Uitschakelen: 0
  • Standaard: 15

Om de bron handmatig bij te werken, gebruikt u winget source update.

visueel settings

De visualsettings betrokken visuele elementen die worden weergegeven door WinGet

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

voortgangsbalk

Kleur van de voortgangsbalk die WinGet weergeeft wanneer deze niet is opgegeven door argumenten.

  • accent (standaardinstelling)
  • regenboog
  • Retro
  • sixel
  • uitgeschakeld

anonymizeDisplayedPaths

Vervangt enkele bekende mappaden door hun respectieve omgevingsvariabelen.

enableSixels

Hiermee schakelt u uitvoer van sixel-afbeeldingen in bepaalde contexten in.

Logboekregistratie settings

De loggingsettings bepalen het detailniveau van logbestanden. --verbose-logs overschrijft deze instelling en maakt altijd een uitgebreid logboek.

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

niveau

De volgende logboekregistratieniveaus zijn beschikbaar. De standaardinstelling is info als de waarde niet is ingesteld of ongeldig is.

  • langdradig
  • informatie
  • waarschuwing
  • fout
  • cruciaal

channels

De channels instelling beperkt de logging uitvoer tot specifieke logboekkanalen. Speciale waarden default (de standaardset kanalen) en all (alle kanalen) worden ook geaccepteerd. Ongeldige waarden worden genegeerd.

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

bestand

De filesettings regelen het automatisch opschonen van logbestanden in de standaardmap voor logbestanden. Opschoning wordt uitgevoerd aan het begin van elk WinGet-proces en is alleen van toepassing op de standaardlogboeklocatie.

Configuratie Beschrijving Verstek
ageLimitInDays Maximale leeftijd in dagen van bestanden in de logboekmap; oudere bestanden worden verwijderd. Ingesteld op 0 om uit te schakelen. 7
totalSizeLimitInMB Maximale totale grootte in megabytes van alle bestanden in de logboekmap; de oudste bestanden worden eerst verwijderd. Ingesteld op 0 om uit te schakelen. 128
countLimit Maximum aantal bestanden in de logboekmap; de oudste bestanden worden eerst verwijderd. Ingesteld op 0 om uit te schakelen. 0 (uitgeschakeld)
individualSizeLimitInMB Maximale grootte in megabytes van één logboekbestand. Als een bestand deze limiet overschrijdt, worden logboeken verpakt. Ingesteld op 0 om uit te schakelen. 16 
"logging": {
    "level": "verbose",
    "file": {
        "ageLimitInDays": 7,
        "totalSizeLimitInMB": 128,
        "countLimit": 0,
        "individualSizeLimitInMB": 16
    }
}

voorkeuren en vereisten settings

Sommige van de settings zijn gedupliceerd onder preferences en requirements.

  • De preferences instelling bepaalt hoe de verschillende beschikbare opties worden gesorteerd bij het kiezen van de optie waarop u actie wilt ondernemen. Het standaardbereik van pakketinstallaties is bijvoorbeeld voor de huidige gebruiker, maar als dat geen optie is, wordt een installatieprogramma op computerniveau gekozen.
  • De requirements instelling filtert de opties, wat mogelijk resulteert in een lege lijst en een fout bij het installeren. In het vorige voorbeeld zou een gebruikersbereikvereiste leiden tot geen toepasselijke installatieprogramma's en een fout.

Argumenten die via de opdrachtregel worden doorgegeven, zullen de overeenkomende requirement-instelling voor de looptijd van die opdracht effectief overschrijven.

omvang

Het scope gedrag bepaalt de keuze tussen het installeren van een pakket voor de huidige gebruiker of voor de hele computer. De overeenkomende parameter is --scope, en gebruikt dezelfde waarden (user of machine). Bekijk bekende problemen met betrekking tot het pakketinstallatiebereik.

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

locatie

Het locale gedrag bepaalt de keuze van het installatieprogramma op basis van de landinstelling van het installatieprogramma. De overeenkomende parameter is --localeen gebruikt bcp47-taaltag.

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

Architecturen

Het architectures gedrag bepaalt welke architecturen worden geselecteerd bij het installeren van een pakket. De overeenkomende parameter is --architecture. Alleen architecturen die compatibel zijn met uw systeem, kunnen worden geselecteerd.

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

installatietypen

Het installerTypes gedrag is van invloed op de typen installatieprogramma's die worden geselecteerd bij het installeren van een pakket. Het kan ook bepalen welk type standaard moet worden geïnstalleerd als een manifest meerdere typen heeft: de lijst heeft een prioriteitsvolgorde, waarbij het eerste vermelde type de voorkeur heeft boven de andere, enzovoort. Dit is handig voor gebruikers die bijvoorbeeld voorkeur geven aan draagbare pakketten of MSIX-/AppX-installaties. De overeenkomende parameter is --installer-type, waarmee de settings wordt overschreven.

Toegestane waarden vanaf versie 1.12.470 zijn: appx, burn, exe, font, inno, msi, msix, msstore, nullsoft, portable, wix, zip

Standaard, met alle andere eigenschappen gelijk, kiest WinGet het installatietype dat als eerste wordt vermeld in de installer-YAML van het manifest als het pakket nog niet is geïnstalleerd. Als het installatieprogramma al is geïnstalleerd, is hetzelfde type installatieprogramma vereist om een juiste upgrade te garanderen.

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

installatiegedrag settings

De installBehaviorsettings bepalen het standaardgedrag voor het installeren en, indien van toepassing, bijwerken van pakketten.

installatienotities uitschakelen

De disableInstallNotes instelling bepaalt of installatienotities worden weergegeven na een geslaagde installatie. De standaardinstelling is false als de waarde niet is ingesteld of ongeldig is.

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

portablePackageUserRoot-instelling

De portablePackageUserRoot instelling definieert de standaardhoofdmap voor het installeren van pakketten onder het User bereik. Dit geldt alleen voor pakketten met het portable installatietype. De standaardinstelling is %LOCALAPPDATA%/Microsoft/WinGet/Packages/ als de waarde niet is ingesteld of ongeldig is.

Deze instellingswaarde moet een absoluut pad zijn.

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

portablePackageMachineRoot-instelling

De portablePackageMachineRoot instelling definieert de standaardhoofdmap voor het installeren van pakketten onder het Machine bereik. Dit geldt alleen voor pakketten met het portable installatietype. De standaardinstelling is %PROGRAMFILES%/WinGet/Packages/ als de waarde niet is ingesteld of ongeldig is.

Deze instellingswaarde moet een absoluut pad zijn.

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

defaultInstallRoot

De defaultInstallRoot instelling geeft de standaardinstallatielocatie op voor pakketten waarvoor een expliciet installatiepad is vereist, als de installatielocatie niet is opgegeven.

maxResumes

De maxResumes instelling geeft het maximum aantal cv-pogingen op dat is toegestaan voor één cv-id. Dit voorkomt continue herstart als een installatie waarvoor opnieuw opstarten is vereist, niet correct wordt gedetecteerd.

archiveExtractionMethod

De archiveExtractionMethod instelling bepaalt hoe het installatieprogramma archieven extraheert. Ondersteunde waarden zijn shellApi en tar.

  • shellApi gebruikt de Windows Shell-API om archieven te extraheren.

  • tar gebruikt de tar-opdracht om archieven te extraheren.

Deïnstallatiegedrag

Met de uninstallBehavior instelling bepaalt u of met het standaard verwijderingsproces alle bestanden en mappen worden verwijderd die relevant zijn voor dit pakket. Alleen van toepassing op de draagbare installerType.

verwijderDraagbaarPakket

De purgePortablePackage instelling bepaalt het standaardgedrag voor het verwijderen van een draagbaar pakket. Als true is ingesteld, verwijdert de installatie alle bestanden en directories die van belang zijn voor het portable-pakket. Deze instelling is alleen van toepassing op pakketten met het portable installatietype. De standaardinstelling is false als de waarde niet is ingesteld of ongeldig is.

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

ConfigureBehavior

Met de ConfigureBehavior instelling wordt de standaardhoofdmap opgegeven waarop PowerShell-modules worden geïnstalleerd bij het toepassen van een configuratie.

downloadgedrag

De downloadBehaviorsettings bepalen de standaardmap waar installatieprogramma's naartoe worden gedownload.

defaultDownloadDirectory

De defaultDownloadDirectory instelling bepaalt de standaardmap waarnaar pakketten worden gedownload. De standaardinstelling is %USERPROFILE%/Downloads als de waarde niet is ingesteld of ongeldig is.

Deze instellingswaarde moet een absoluut pad zijn.

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

Telemetrie settings

De telemetrysettings bepalen of WinGet ETW-gebeurtenissen schrijft die kunnen worden verzonden naar Microsoft op een standaardinstallatie van Windows.

Zie details met betrekking tot telemetrieen onze belangrijkste privacyverklaring.

uitschakelen

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

Als deze optie is ingesteld op true, voorkomt de telemetry.disable instelling dat een gebeurtenis door het programma wordt geschreven.

Netwerk settings

De networksettings invloed op hoe WinGet het netwerk gebruikt om pakketten en metagegevens op te halen.

downloader

De downloader instelling bepaalt welke code wordt gebruikt bij het downloaden van pakketten. De standaardwaarde is do, die kan worden beheerd door Groepsbeleid.

wininet maakt gebruik van de WinINet-API's , terwijl do de Delivery Optimization-service wordt gebruikt.

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

doProgressTimeoutInSeconds

Hiermee doProgressTimeoutInSeconds geeft u het aantal seconden op dat moet worden gewacht zonder voortgang voordat u terugval.

Interactiviteit

De Interactivity instelling bepaalt of interactieve prompts worden weergegeven door de Windows Pakketbeheer-client.

Experimentele functies inschakelen

Als u wilt ontdekken welke experimentele functies beschikbaar zijn, gaat u naar https://aka.ms/wingethttps://aka.ms/winget-settings waar u de experimentele functies kunt zien die voor u beschikbaar zijn.

De experimentalFeaturessettings hebben betrekking op de configuratie van deze "experimentele" functies. Afzonderlijke functies kunnen worden ingeschakeld onder dit knooppunt:

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

directMSI

Met deze functie kan Windows Pakketbeheer MSI-pakketten rechtstreeks installeren met de MSI-API's in plaats van via msiexec. Houd er rekening mee dat wanneer stille installatie wordt gebruikt, dit al van kracht is, omdat MSI-pakketten waarvoor verhoging van rechten is vereist, in dat scenario zonder de vereiste instellingen zullen mislukken.

"experimentalFeatures": {
    "directMSI": true
}

cv

Met deze functie kan ondersteuning worden geboden voor sommige opdrachten die na het opnieuw opstarten kunnen worden hervat.

"experimentalFeatures": {
    "resume": true
}

Lettertypen

Met deze functie kunt u ondersteuning bieden voor lettertypen via winget settings. Met de winget font list opdracht worden geïnstalleerde lettertypefamilies en het aantal geïnstalleerde lettertypegezichten weergegeven.

"experimentalFeatures": {
    "fonts": true
}

bronprioriteit

Met deze functie kunnen bronnen een prioriteitswaarde hebben toegewezen. Bronnen met een hogere prioriteit worden eerder weergegeven in de zoekresultaten en worden geselecteerd voor het installeren van nieuwe pakketten wanneer meerdere bronnen een overeenkomend pakket hebben.

De volgorde van zoekresultaten is afhankelijk van verschillende factoren en de bronprioriteit is momenteel het laagste veld (kwaliteit en veld vergelijken zijn belangrijker).

"experimentalFeatures": {
    "sourcePriority": true
}
  • Last updated on