Freigeben über


configure-Befehl (WinGet)

Bei Verwendung des configure-Befehls des WinGet-Tools wird eine WinGet-Konfigurationsdatei verwendet, um Ihren Windows-Computer in einem gewünschten Entwicklungsumgebungszustand einzurichten.

Warnung

Führen Sie keine WinGet-Konfigurationsdatei aus, ohne zuerst den Inhalt der Datei zu überprüfen und die Glaubwürdigkeit der zugehörigen Ressourcen zu überprüfen. Siehe Überprüfen der Vertrauenswürdigkeit einer WinGet-Konfigurationsdatei.

Voraussetzungen

  • Windows 10, Version 1809 (Build 17763) oder höher, oder Windows 11.
  • WinGet Version v1.6.2631 oder höher.

Decknamen

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

  • Konfiguration
  • DSC

Verwendung

winget configure -f <C:/Users/<username>/winget-configs/config-file-name.dsc.winget>

Nachdem Sie die WinGet-Konfigurationsdatei identifiziert haben, die Sie verwenden möchten, die Sicherheit und Vertrauenswürdigkeit dieser Datei bestätigt und die Datei auf Ihren lokalen Computer heruntergeladen haben, können Sie den winget configure Befehl verwenden, um die Einrichtung Ihrer Konfiguration zu initiieren.

Screenshot mit winget configure command options.

Argumente und Optionen

Die folgenden Argumente sind verfügbar:

Streitpunkt BESCHREIBUNG
-f,--file Der Pfad zur Winget-Konfigurationsdatei.
--module-path Gibt den Speicherort auf dem lokalen Computer an, an dem Module gespeichert werden sollen. Standard %LOCALAPPDATA%\Microsoft\WinGet\Configuration\Modules.
--Prozessorpfad Gibt den Pfad zum Konfigurationsprozessor an.
-h,--history Wählen Sie Elemente aus dem Verlauf aus.
--accept-configuration-agreements Akzeptiert die Konfigurationswarnung und verhindert eine interaktive Eingabeaufforderung.
--suppress-initial-details Unterdrücken Sie wenn möglich die Anzeige der anfänglichen Konfigurationsdetails.
--enable Aktivieren Sie Konfigurationskomponenten. Erfordert Speicherzugriff.
--disable Konfigurationskomponenten deaktivieren. Erfordert Speicherzugriff.
-?--Hilfe 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 Standardspeicherort für Protokolle.
--verbose,--verbose-logs Aktiviert die ausführliche Protokollierung für WinGet.
--nowarn,--ignore-warnings Unterdrückt Warnungsausgaben.
--disable-interactivity Deaktivieren Sie interaktive Eingabeaufforderungen.
--proxy Festlegen eines Proxys, der für diese Ausführung verwendet werden soll.
--no-proxy Deaktivieren der Verwendung des Proxys für diese Ausführung.

Konfigurieren von Unterbefehlen

Der winget configure Befehl enthält eine Reihe von Unterbefehlen, einschließlich:

  • winget configure show: Zeigt die Details einer Konfigurationsdatei an. Verwendung: winget configure show -f <file>. Ausführen des Befehls: winget configuration show configuration.dsc.yaml zeigt die Details der Konfiguration im aktuellen Arbeitsverzeichnis an.
  • winget configure list: Zeigt die allgemeinen Details für Konfigurationen an, die auf das System angewendet wurden. Diese Daten können dann mit anderen configure Befehlen verwendet werden, um weitere Details zu erhalten. Syntax: winget configure list [<options>]
  • winget configure test: Überprüft das System anhand des gewünschten Zustands und zeigt an, ob der aktuelle Systemzustand dem gewünschten Zustand entspricht, der in der zugeordneten Konfigurationsdatei definiert ist. Verwendung: winget configure test -f <file>.
  • winget configure validate: Überprüft eine Konfigurationsdatei. Verwendung: winget configure validate [-f] <file> [<options>].
  • winget configure export: Exportiert Konfigurationsressourcen in eine Konfigurationsdatei. Bei Verwendung mit --allwerden alle Paketkonfigurationen exportiert. Bei Verwendung mit --package-id, exportiert eine WinGetPackage-Ressource des angegebenen Paketbezeichners. Bei Verwendung mit --module und --resourceexportiert die Einstellungen der angegebenen Ressource. Wenn die Ausgabekonfigurationsdatei bereits vorhanden ist, werden die exportierten Konfigurationsressourcen angefügt. Syntax: winget configure export -o <output file> [<options>]