Delen via

opdracht instellingen (winget)

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

Met de opdracht Instellingen 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:

  • configuratie

Subopdrachten

De volgende subopdrachten zijn beschikbaar.

Sub-Command Beschrijving
exporteren Hiermee exporteert u instellingen.
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 voor winget in.
--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.

Gebruik de opdracht `winget settings`

Start uw standaardhulpprogramma voor JSON-bewerking: winget settings

Wanneer u de instellingen voor het eerst start, worden er geen instellingen opgegeven. Boven aan het JSON-bestand bieden we een Koppeling naar WinGet CLI-instellingen , waar u de nieuwste experimentele functies en instellingen kunt ontdekken.

In het onderstaande codefragment ziet u een voorbeeld van hoe uw instellingenbestand 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 gedefinieerd voor het instellingenbestand. Hiermee kunt u tab gebruiken om instellingen en syntaxis te detecteren als uw JSON-editor JSON-schema's ondersteunt.

Instellingen bijwerken

De volgende instellingen zijn beschikbaar voor de versie 1.11 van Windows Package Manager.

broninstellingen

De source instellingen omvatten configuratie voor de WinGet-bron.

"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.

visuele instellingen

De visual instellingen omvatten 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.

enableSizels

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

instellingen voor logboekregistratie

De logging instellingen bepalen het detailniveau in logboekbestanden. --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

instellingen voor voorkeuren en vereisten

Sommige instellingen worden 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 bepaalt welke typen installatieprogramma's worden geselecteerd bij het installeren van een pakket. De overeenkomende parameter is --installer-type.

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

installatiegedrag instellingen

De installBehavior instellingen bepalen het standaardgedrag van het installeren en upgraden van (indien van toepassing) 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 downloadBehavior instellingen bepalen de standaardmap waarnaar installatieprogramma's 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-instellingen

De telemetry instellingen bepalen of WinGet ETW-gebeurtenissen schrijft die naar Microsoft kunnen worden verzonden 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.

Netwerkinstellingen

De network instellingen beïnvloeden 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 Package Manager-client.

Experimentele functies inschakelen

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

  • Last updated on