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

enableSizels

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

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 steuert, welche Installationstypen beim Installieren eines Pakets ausgewählt werden. Der übereinstimmende Parameter lautet --installer-type.

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