settings Befehl (winget)

Mit dem Befehl settings von WinGet können Sie ihre Windows Paket-Manager Clientumgebung anpassen. Sie können Die Standardwerte ändern und experimentelle Features ausprobieren, die in Ihrem Client verfügbar sind.

Der settings Befehl startet ihren standardmäßigen JSON-Editor. Windows startet standardmäßig Editor als Option. Wir empfehlen die Verwendung eines Tools wie Visual Studio Code.

Hinweis

Sie können Visual Studio Code ganz einfach installieren, indem Sie winget install Microsoft.VisualStudioCode eingeben.

Decknamen

Die folgenden Aliase sind für diesen Befehl verfügbar:

  • config

Unterbefehle

Die folgenden Unterbefehle sind verfügbar.

Unterbefehl BESCHREIBUNG
export Exporte settings.
set Legt den Wert einer Administratoreinstellung fest.
reset Setzt eine Administratoreinstellung auf den Standardwert zurück.

Optionen

Die folgenden Optionen sind verfügbar:

Streitpunkt BESCHREIBUNG
--ermöglichen Aktiviert die angegebene Administratoreinstellung.
--abschalten Deaktiviert die angegebene Administratoreinstellung.
-?,--help Zeigt Hilfe zum ausgewählten Befehl an.
--Warte Fordert den Benutzer auf, vor dem Beenden eine beliebige Taste zu drücken.
--logs,--open-logs Öffnet den Standardprotokollspeicherort.
--verbose,--verbose-logs Aktiviert ausführliche Protokollierung für winget.
--nowarn,--ignore-warnings (keine Warnungen anzeigen, Warnungen ignorieren) Unterdrückt Warnungsausgaben.
--disable-interactivity Deaktiviert interaktive Eingabeaufforderungen.
--Proxy Legt einen Proxy fest, der für diese Ausführung verwendet werden soll.
--no-proxy Deaktiviert die Verwendung des Proxys für diese Ausführung.

Verwenden des wingetsettings Befehls

Starten Sie das standard JSON-Bearbeitungstool: winget settings

Wenn Sie settings zum ersten Mal starten, ist kein settings angegeben. Oben in der JSON-Datei finden Sie einen Link zu WinGet CLI Settings, über den Sie die neuesten experimentellen Funktionen und settings finden können.

Der folgende Codeausschnitt zeigt ein Beispiel dafür, wie Ihre settings Datei mit aktivierten visuellen Ausgabeänderungen und experimentellen Features aussehen könnte.

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

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

Wir haben auch ein Schema für die settings Datei definiert. Auf diese Weise können Sie mithilfe der TAB-Taste settings und Syntax erkennen, wenn Ihr JSON-Editor JSON-Schemas unterstützt.

Wird aktualisiert settings

Die folgenden settings sind für Release 1.28 von Windows Paket-Manager verfügbar.

Quelle settings

Die sourcesettings betreffen die Konfiguration der WinGet-Quelle.

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

automatischesAktualisierungsintervallInMinuten

Eine positive ganze Zahl stellt das Aktualisierungsintervall in Minuten dar. Die Überprüfung auf Updates erfolgt nur, wenn eine Quelle verwendet wird. Ein Wert von „Null“ deaktiviert die Suche nach Updates für eine Quelle. Alle anderen Werte sind ungültig.

  • Deaktivieren: 0
  • Standard: 15

So aktualisieren Sie die Quelle manuell mit winget source update.

visuell settings

Dies visualsettings umfasst visuelle Elemente, die von WinGet angezeigt werden

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

progressBar

Die Farbe der Statusanzeige, die WinGet anzeigt, wenn sie nicht durch Argumente angegeben wird.

  • Akzent (Standard)
  • Regenbogen
  • retro
  • sixel
  • deaktiviert

angezeigte Pfade anonymisieren

Ersetzt einige bekannte Ordnerpfade durch ihre jeweiligen Umgebungsvariablen.

Enable Sixels

Ermöglicht die Ausgabe von Sixelbildern in bestimmten Kontexten.

Protokollierung settings

Die loggingsettings steuern den Detaillierungsgrad in Protokolldateien. --verbose-logs überschreibt diese Einstellung und erstellt immer ein ausführliches Protokoll.

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

level

Die folgenden Protokolliergrade sind verfügbar. Bei nicht festgelegtem oder ungültigem Wert ist der Standardwert info.

  • Ausführlich
  • info
  • Warnung
  • Fehler
  • kritisch

Kanäle

Die channels Einstellung schränkt die Protokollierungsausgabe auf bestimmte Protokollkanäle ein. Sonderwerte default (der Standardsatz von Kanälen) und all (alle Kanäle) werden ebenfalls akzeptiert. Ungültige Werte werden ignoriert.

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

Datei

Die filesettings steuern die automatische Bereinigung von Protokolldateien im Standard-Logverzeichnis. Die Bereinigung wird am Anfang jedes WinGet-Prozesses ausgeführt und gilt nur für den Standardprotokollspeicherort.

Setting BESCHREIBUNG Vorgabe
ageLimitInDays Maximales Alter in Tagen von Dateien im Protokollverzeichnis; Ältere Dateien werden gelöscht. 0 Auf "Deaktivieren" festlegen. 7
totalSizeLimitInMB Maximale Gesamtgröße in Megabyte aller Dateien im Protokollverzeichnis; die ältesten Dateien werden zuerst gelöscht. 0 Auf "Deaktivieren" festlegen. 128
countLimit Maximale Anzahl von Dateien im Protokollverzeichnis; die ältesten Dateien werden zuerst gelöscht. 0 Auf "Deaktivieren" festlegen. 0 (deaktiviert)
individualSizeLimitInMB Maximale Größe in Megabyte einer einzelnen Protokolldatei. Wenn eine Datei diesen Grenzwert überschreitet, werden Protokolle umgeschlagen. 0 Auf "Deaktivieren" festlegen. 16 
"logging": {
    "level": "verbose",
    "file": {
        "ageLimitInDays": 7,
        "totalSizeLimitInMB": 128,
        "countLimit": 0,
        "individualSizeLimitInMB": 16
    }
}

Einstellungen und Anforderungen settings

Einige der settings sind unter preferences und requirements doppelt vorhanden.

  • Die preferences Einstellung steuert, wie die verschiedenen verfügbaren Optionen sortiert werden, wenn Sie die Option auswählen, die bearbeitet werden soll. Der Standardumfang der Paketinstallationen ist z. B. für den aktuellen Benutzer bestimmt, aber wenn dies keine Option ist, wird ein Installationsprogramm auf Computerebene ausgewählt.
  • Die requirements Einstellung filtert die Optionen, was möglicherweise zu einer leeren Liste und einem Fehler bei der Installation führt. Im vorherigen Beispiel würde eine Benutzerbereichsanforderung keine anwendbaren Installationsprogramme und einen Fehler ergeben.

Alle auf der Befehlszeile übergebenen Argumente setzen effektiv die entsprechende requirement-Einstellung für die Dauer dieses Befehls außer Kraft.

scope

Das scope Verhalten steuert die Wahl zwischen der Installation eines Pakets für den aktuellen Benutzer oder für den gesamten Computer. Der übereinstimmende Parameter ist --scope, und verwendet dieselben Werte (user oder machine). Weitere Informationen finden Sie unter Bekannte Probleme.

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

locale

Das locale-Verhalten steuert die Auswahl des Installationsprogramms basierend auf dem Gebietsschema des Installationsprogramms. Der entsprechende Parameter ist --locale und verwendet das Sprachtag „bcp47“.

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

architectures

Das architectures Verhalten steuert, welche Architekturen bei der Installation eines Pakets ausgewählt werden. Der übereinstimmende Parameter lautet --architecture. Es können nur Architekturen ausgewählt werden, die mit Ihrem System kompatibel sind.

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

Installertypen

Das installerTypes Verhalten wirkt sich darauf aus, welche Installer-Typen bei der Installation eines Pakets ausgewählt werden. Sie kann auch bestimmen, welcher Typ standardmäßig installiert werden soll, wenn ein Manifest mehrere Typen aufweist: Die Liste ist in der Prioritätsreihenfolge, wobei der erste aufgelistete Typ gegenüber den anderen bevorzugt wird usw. Dies ist praktisch für Benutzer, die beispielsweise tragbare Pakete oder MSIX/AppX-Installationen bevorzugen. Der passende Parameter ist --installer-type, der settings überschreibt.

Zulässige Werte ab Version 1.12.470 umfassen: appx, burn, exe, font, inno, msi, msix, msstore, nullsoft, portable, wix, zip

Standardmäßig und bei allen anderen Eigenschaften, die gleich sind, verwendet WinGet standardmäßig den Installationstyp, der zuerst im YaML-Installationsprogramm des Manifests aufgeführt ist, wenn das Paket noch nicht installiert wurde. Wenn sie bereits installiert ist, ist derselbe Installationstyp erforderlich, um ein ordnungsgemäßes Upgrade sicherzustellen.

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

installBehavior settings

Das installBehaviorsettings Steuerelement steuert das Standardverhalten der Installations- und Aktualisierungspakete (sofern zutreffend).

disableInstallNotes

Die disableInstallNotes Einstellung bestimmt, ob Installationsnotizen nach einer erfolgreichen Installation angezeigt werden. Bei nicht festgelegtem oder ungültigem Wert ist der Standardwert false.

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

portablePackageUserRoot-Einstellung

Die portablePackageUserRoot Einstellung definiert das Standardstammverzeichnis zum Installieren von Paketen unter dem User Bereich. Dies gilt nur für Pakete mit dem portable Installationstyp. Bei nicht festgelegtem oder ungültigem Wert ist der Standardwert %LOCALAPPDATA%/Microsoft/WinGet/Packages/.

Dieser Einstellungswert muss ein absoluter Pfad sein.

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

portablePackageMachineRoot-Einstellung

Die portablePackageMachineRoot Einstellung definiert das Standardstammverzeichnis zum Installieren von Paketen unter dem Machine Bereich. Dies gilt nur für Pakete mit dem portable Installationstyp. Bei nicht festgelegtem oder ungültigem Wert ist der Standardwert %PROGRAMFILES%/WinGet/Packages/.

Dieser Einstellungswert muss ein absoluter Pfad sein.

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

defaultInstallRoot

Die defaultInstallRoot Einstellung gibt den Standardinstallationsspeicherort für Pakete an, die einen expliziten Installationspfad erfordern, wenn der Installationsspeicherort nicht angegeben ist.

maxResumes

Die maxResumes Einstellung spezifiziert die maximale Anzahl von Wiederaufnahmeversuchen, die für eine einzelne Wiederaufnahme-ID zulässig sind. Dadurch werden fortlaufende Neustarts verhindert, wenn eine Installation, die einen Neustart erfordert, nicht ordnungsgemäß erkannt wird.

Archivextraktionsmethode

Die archiveExtractionMethod Einstellung steuert, wie das Installationsprogramm Archive extrahiert. Unterstützte Werte sind shellApi und tar.

  • shellApi verwendet die Windows Shell-API zum Extrahieren von Archiven.

  • tar verwendet den Tar-Befehl zum Extrahieren von Archiven.

Deinstallationsverhalten

Die uninstallBehavior Einstellung steuert, ob der Standardmäßige Deinstallationsprozess alle Dateien und Verzeichnisse entfernt, die für dieses Paket relevant sind. Gilt nur für das tragbare installerType.

BereinigeTragbaresPaket

Die purgePortablePackage Einstellung steuert das Standardverhalten für die Deinstallation eines tragbaren Pakets. Wird true festgelegt, werden beim Deinstallieren alle Dateien und Verzeichnisse entfernt, die für das Paket portable relevant sind. Diese Einstellung gilt nur für Pakete mit dem portable Installationstyp. Bei nicht festgelegtem oder ungültigem Wert ist der Standardwert false.

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

KonfiguriereVerhalten

Die ConfigureBehavior Einstellung gibt das Standardstammverzeichnis an, in dem PowerShell-Module beim Anwenden einer Konfiguration installiert werden.

Download-Verhalten

Die downloadBehaviorsettings steuern das Standardverzeichnis, in das Installer heruntergeladen werden.

Standard-Downloadverzeichnis

Die defaultDownloadDirectory Einstellung steuert das Standardverzeichnis, in das Pakete heruntergeladen werden. Bei nicht festgelegtem oder ungültigem Wert ist der Standardwert %USERPROFILE%/Downloads.

Dieser Einstellungswert muss ein absoluter Pfad sein.

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

Telemetrie settings

Die telemetrysettings steuern, ob WinGet ETW-Ereignisse schreibt, die bei einer Standardinstallation von Windows an Microsoft gesendet werden können.

Weitere Informationen finden Sie unter Details zu Telemetriedaten und in unseren primären Datenschutzbestimmungen.

disable

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

Wenn dieser Wert auf "true" festgelegt ist, verhindert die telemetry.disable Einstellung, dass jedes Ereignis vom Programm geschrieben wird.

Netzwerk settings

Die networksettings beeinflussen, wie WinGet das Netzwerk zum Abrufen von Paketen und Metadaten verwendet.

downloader

Die downloader Einstellung steuert, welcher Code beim Herunterladen von Paketen verwendet wird. Der Standardwert ist do, der möglicherweise von einer Gruppenrichtlinie verwaltet wird.

wininet verwendet die WinINet-APIs , während do der Übermittlungsoptimierungsdienst verwendet wird.

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

doProgressTimeoutInSeconds

Der doProgressTimeoutInSeconds gibt die Anzahl der Sekunden an, die ohne Fortschritt abgewartet werden sollen, bevor auf das Fallback zurückgegriffen wird.

Interaktivität

Die Interactivity Einstellung steuert, ob interaktive Eingabeaufforderungen vom Windows-Paket-Manager-Client angezeigt werden.

Aktivieren experimenteller Funktionen

Um zu entdecken, welche experimentellen Features verfügbar sind, wechseln Sie zu https://aka.ms/wingethttps://aka.ms/winget-settings wo Sie die experimentellen Features sehen können, die Ihnen zur Verfügung stehen.

Die experimentalFeaturessettings umfassen die Konfiguration dieser „experimentellen“ Funktionen. Einzelne Features können unter diesem Knoten aktiviert werden:

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

directMSI

Mit diesem Feature kann der Windows-Paket-Manager MSI-Pakete anstelle von msiexec direkt mit den MSI-APIs installieren. Beachten Sie, dass bei Verwendung der stillen Installation dies bereits wirksam ist, da MSI-Pakete, die eine Erweiterung von Berechtigungen erfordern, in diesem Szenario fehlschlagen.

"experimentalFeatures": {
    "directMSI": true
}

Lebenslauf

Dieses Feature erlaubt es, die Ausführung einiger Befehle nach einem Neustart fortzusetzen.

"experimentalFeatures": {
    "resume": true
}

Schriftarten

Dieses Feature ermöglicht die Unterstützung für Schriftarten über winget settings. Der winget font list Befehl listet installierte Schriftartfamilien und die Anzahl der installierten Schriftarten-Gesichter auf.

"experimentalFeatures": {
    "fonts": true
}

Quellenpriorität

Mit diesem Feature können Quellen einen Prioritätswert zugewiesen werden. Quellen mit höherer Priorität werden weiter oben in suchergebnissen angezeigt und werden für die Installation neuer Pakete ausgewählt, wenn mehrere Quellen über ein übereinstimmendes Paket verfügen.

Beachten Sie, dass die Sortierung von Suchergebnissen von mehreren Faktoren abhängt, und die Quellpriorität ist das niedrigste Feld derzeit (Übereinstimmungsqualität und Feld sind wichtiger).

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