Freigeben über

Befehl „settings“ (winget)

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

Mit dem Einstellungsbefehl wird der standardmäßige JSON-Editor gestartet. 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 Exportiert Einstellungen.
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 die 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 Sie den winget-Einstellungsbefehl

Starten Sie das standard JSON-Bearbeitungstool: winget settings

Wenn Sie die Einstellungen zum ersten Mal starten, sind keine Einstellungen festgelegt. Oben in der JSON-Datei stellen wir einen WinGet CLI-Einstellungslink bereit, über den Sie die neuesten experimentellen Features und Einstellungen entdecken können.

Der folgende Codeausschnitt zeigt ein Beispiel dafür, wie ihre Einstellungsdatei 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 Einstellungsdatei definiert. Auf diese Weise können Sie TAB verwenden, um Einstellungen und Syntax zu ermitteln, wenn Ihr JSON-Editor JSON-Schemas unterstützt.

Aktualisieren von Einstellungen

Die folgenden Einstellungen sind für die Version 1.28 des Windows-Paket-Managers verfügbar.

Quelleinstellungen

Die source-Einstellungen umfassen 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.

Visuelle Einstellungen

Die visual-Einstellungen umfassen 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.

logging-Einstellungen

Die logging Einstellungen steuern die Detailebene 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 file Einstellungen steuern die automatische Bereinigung von Protokolldateien im Standardprotokollverzeichnis. 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 „preferences“ und „requirements“

Einige der Einstellungen kommen unter preferences und requirements doppelt vor.

  • 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 übereinstimmende Parameter ist --installer-type, der die Einstellungen ü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-Einstellungen

Die installBehavior Einstellungen steuern das Standardverhalten der Installation und Aktualisierung von Paketen (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 downloadBehavior Einstellungen steuern das Standardverzeichnis, in das Installationsprogramme 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"
    },

Telemetrieeinstellungen

Die telemetry Einstellungen steuern, ob WinGet ETW-Ereignisse schreibt, die möglicherweise bei einer Standardinstallation von Windows an Microsoft gesendet werden.

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.

Netzwerkeinstellungen

Die network Einstellungen 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 ermitteln, welche experimentellen Features verfügbar sind, gehen Sie zu https://aka.ms/winget-settings, wo Sie die für Sie verfügbaren experimentellen Features sehen können.

Die experimentalFeatures Einstellungen umfassen die Konfiguration dieser "experimentellen" Features. 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