Befehl „settings“ (winget)

Mit dem Befehl settings des winget-Tools können Sie die Erfahrung Ihres Windows-Paket-Manager-Clients anpassen. Sie können Standardwerte ändern und experimentelle Features ausprobieren, die in Ihrem Client aktiviert sind.

Mit dem Befehl settings wird Ihr Standard-Text-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.

Aliase

Die folgenden Aliase stehen für diesen Befehl zur Verfügung:

• config

Verwenden des winget-Befehls „settings“

Starten Sie Ihr Standardbearbeitungstool für JSON: winget settings

Wenn Sie die Einstellungen zum ersten Mal starten, sind keine Einstellungen angegeben. Am Anfang der JSON-Datei stellen wir einen Link bereit, über den Sie die neuesten experimentellen Features und Einstellungen entdecken können.

Der nachstehende Codeausschnitt ist ein Beispiel dafür, wie Ihre Einstellungsdatei aussehen sollte, wenn Sie einige dieser experimentellen Features und Einstellungen aktivieren oder ändern möchten.

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

    // For documentation on these settings, see: https://aka.ms/winget-settings
    "experimentalFeatures": {
	  "dependencies": true,
	  "directMSI": false,
	  "zipInstall": false,
    },
    "visual": {
        "progressBar": "rainbow"
    },
    "source": {
        "autoUpdateIntervalInMinutes": 5
    },
}

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

Hinweis

Experimentelle Features sind nur in Vorabversionen verfügbar. Anweisungen zum Abrufen einer Vorabversion finden Sie im GitHub-Repository.

Aktualisieren von Einstellungen

Die folgenden Einstellungen sind für das Release 1.0 des Windows-Paket-Managers verfügbar.

source-Einstellungen

Die source-Einstellungen umfassen die Konfiguration der WinGet-Quelle.

"source": {
    "autoUpdateIntervalInMinutes": 3
},

autoUpdateIntervalInMinutes

Eine positive ganze Zahl, die das Updateintervall in Minuten darstellt. Die Suche nach 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
• Standardwert: 5

Um die Quelle manuell zu aktualisieren, verwenden Sie winget source update.

visual-Einstellungen

Die visual-Einstellungen umfassen visuelle Elemente, die von WinGet angezeigt werden.

"visual": {
    "progressBar": "accent"
},

progressBar

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

• accent (Standard)
• retro
• rainbow

installBehavior-Einstellungen

The installBehavior-Einstellungen wirken sich auf das Standardverhalten beim Installieren oder Upgraden von Paketen aus (wo zutreffend).

disableInstallNotes

Das Verhalten von disableInstallNotes wirkt sich darauf aus, ob nach einer erfolgreichen Installation Installationshinweise angezeigt werden. Bei nicht festgelegtem oder ungültigem Wert ist der Standardwert false.

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

portablePackageUserRoot-Einstellung

Die Einstellung portablePackageUserRoot wirkt sich auf das Standardstammverzeichnis aus, in dem Pakete im Bereich User installiert werden. Diese Einstellung gilt nur für Pakete mit dem Installationstyp portable. Bei nicht festgelegtem oder ungültigem Wert ist der Standardwert %LOCALAPPDATA%/Microsoft/WinGet/Packages/.

Hinweis: Dieser Einstellungswert muss ein absoluter Pfad sein.

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

portablePackageMachineRoot-Einstellung

Die Einstellung portablePackageMachineRoot wirkt sich auf das Standardstammverzeichnis aus, in dem Pakete im Bereich Machine installiert werden. Diese Einstellung gilt nur für Pakete mit dem Installationstyp portable. Bei nicht festgelegtem oder ungültigem Wert ist der Standardwert %PROGRAMFILES%/WinGet/Packages/.

Hinweis: Dieser Einstellungswert muss ein absoluter Pfad sein.

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

Einstellungen „preferences“ und „requirements“

Einige der Einstellungen kommen unter preferences und requirements doppelt vor.

• Die preferences-Einstellung wirkt sich darauf aus, wie die verschiedenen verfügbaren Optionen sortiert werden, wenn Sie die auswählen, auf die sie sich auswirken sollen. Der Standardgeltungsbereich von Paketinstallationen ist beispielsweise für den aktuellen Benutzer. Wenn dies aber keine Option ist, wird ein Installationsprogramm auf Computerebene ausgewählt.
• Die requirements-Einstellung filtert die Optionen, was möglicherweise zu einer leeren Liste und dem Fehlschlagen der Installation führen kann. Im vorherigen Beispiel würde eine Benutzer-Geltungsbereichsanforderung zu keinen anwendbaren Installationsprogrammen und somit einem Fehler führen.

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 wirkt sich auf die Wahl zwischen der Installation eines Pakets für den aktuellen Benutzer oder für den gesamten Computer aus. Der entsprechende 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 wirkt sich auf die Auswahl des Installationsprogramms basierend auf dem Gebietsschema des Installationsprogramms aus. Der entsprechende Parameter ist --locale und verwendet das Sprachtag „bcp47“.

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

architectures

Das Verhalten von architectures wirkt sich darauf aus, welche Architekturen beim Installieren eines Pakets ausgewählt werden. Der zugehörige Parameter ist --architecture. Beachten Sie, dass nur mit Ihrem System kompatible Architekturen ausgewählt werden können.

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

installerTypes

Das installerTypes Verhalten wirkt sich darauf aus, welche Installationstypen bei der Installation eines Pakets ausgewählt werden. Der zugehörige Parameter ist --installer-type.

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

uninstallBehavior

Die uninstallBehavior-Einstellungen wirken sich auf das Standardverhalten beim Deinstallieren von Paketen aus (wo zutreffend).

purgePortablePackage

Das purgePortablePackage-Verhalten wirkt sich auf das Standardverhalten beim Deinstallieren von portierbaren Paketen aus. 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 Installationstyp portable. Bei nicht festgelegtem oder ungültigem Wert ist der Standardwert false.

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

downloadBehavior

Die downloadBehavior Einstellungen wirken sich auf das Standardverhalten des Herunterladens von Paketen aus.

defaultDownloadDirectory

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

Hinweis: Dieser Einstellungswert muss ein absoluter Pfad sein.

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

telemetry-Einstellungen

Die telemetry-Einstellungen 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 die Einstellung telemetry.disable auf „true“ festgelegt ist, verhindert sie jedes Schreiben von Ereignissen durch das Programm.

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 default, wobei es sich um eine der Optionen handeln kann, die auf unserer Bestimmung basieren.

wininet verwendet die wininetAPIs, während do die do verwendet.

"network": {
    "downloader": "do"
}

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
• warning
• error
• Kritisch

Aktivieren experimenteller Features

Um zu erkunden, welche experimentellen Features verfügbar sind, wechseln Sie zu https://aka.ms/winget-settings, wo Sie die für Sie verfügbaren experimentellen Features sehen können.