upgrade Befehl (winget)

Der upgrade Befehl des WinGet-Tools aktualisiert die angegebene Anwendung. Optional können Sie den Listenbefehl verwenden, um die Anwendung zu identifizieren, die Sie verwenden möchten upgrade.

Der upgrade Befehl setzt voraus, dass Sie die genaue Zeichenfolge für upgrade angeben. Falls es Unklarheiten gibt, werden Sie dazu aufgefordert, den Befehl upgrade weiter auf eine bestimmte Anwendung einzugrenzen.

Aliase

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

• update

Verbrauch

winget upgrade [[-q] <query> ...] [<options>]

Argumente

Folgende Argumente sind verfügbar.

Streitpunkt	Beschreibung
-q,--query	Die Abfrage, die für die Suche nach einer App verwendet wird.

Hinweis

Das Abfrageargument ist positionsgenau. Platzhalterformatsyntax wird nicht unterstützt. Dies ist am häufigsten die Zeichenfolge, mit der Sie erwarten, das Paket finden, das Sie aktualisieren möchten.

Optionen

Mit den Optionen können Sie die upgrade Benutzeroberfläche an Ihre Anforderungen anpassen.

Option	Beschreibung
-m,--manifest	Hierauf muss der Pfad zur Manifestdatei (YAML) folgen. Sie können das Manifest verwenden, um die upgrade Umgebung mithilfe einer lokalen YAML-Datei zu starten.
--id	Beschränkt upgrade auf die ID der Anwendung.
--Name	Schränkt die Suche auf den Namen der Anwendung ein.
--moniker	Schränkt die Suche auf die für die Anwendung aufgelisteten Moniker ein.
-v, --version	Ermöglicht Ihnen, eine genaue Version für upgrade anzugeben. Wenn nicht angegeben, wird upgrade die neueste versionierte Anwendung verwendet.
-s,--source	Schränkt die Suche auf die Quelle mit dem angegebenen Namen ein. Hierauf muss der Name der Quelle folgen.
-e,--exact	Verwendet die exakte Zeichenfolge in der Abfrage und berücksichtigt die Groß-/Kleinschreibung. Das Standardverhalten einer Teilzeichenfolge wird nicht verwendet.
-i, --interactive	Führt den Installer im interaktiven Modus aus. In der Standardbenutzeroberfläche wird der Installationsfortschritt angezeigt.
-h, --silent	Führt den Installer im unbeaufsichtigten Modus aus. Unterdrückt die gesamte Benutzeroberfläche. In der Standardbenutzeroberfläche wird der Installationsfortschritt angezeigt.
--purge	Löscht alle Dateien und Verzeichnisse im Paketverzeichnis (portierbar)
-o, --log	Die Protokollierung wird an eine Protokolldatei weitergeleitet. Sie müssen einen Pfad zu einer Datei angeben, für die Sie über die Schreibberechtigungen verfügen.
--Gewohnheit	Argumente, die zusätzlich zu den Standardwerten an das Installationsprogramm übergeben werden sollen.
--override	Eine Zeichenfolge, die direkt an den Installer übergeben wird.
-l, --location	Speicherort bis upgrade (sofern unterstützt).
--scope	Wählt den installierten Paketbereichsfilter (Benutzer oder Computer) aus.
a, --Architektur	Wählen Sie die zu installierende Architektur aus.
--installer-type	Wählen Sie den Installationstyp in upgrade. Weitere Informationen finden Sie unter Unterstützte Installationstypen für den WinGet-Client.
--locale	Gibt an, welches Gebietsschema verwendet werden soll (BCP47-Format).
--ignore-security-hash	Ignoriert den Fehler der Hashüberprüfung des Installationsprogramms. Nicht empfohlen.
--allow-reboot	Ermöglicht ggf. einen Neustart.
--skip-dependencies	Überspringt die Verarbeitung von Paketabhängigkeiten und Windows-Features.
--ignore-local-archive-malware-scan (Ignoriert die lokale Archiv-Malware-Überprüfung)	Ignoriert die Schadsoftwareüberprüfung, die als Teil der Installation eines Archivtyppakets aus dem lokalen Manifest ausgeführt wurde.
--akzeptiere-Paketvereinbarungen	Wird verwendet, um den Lizenzvertrag zu akzeptieren und die Eingabeaufforderung zu vermeiden.
--accept-source-agreements	Wird verwendet, um den Quelllizenzvertrag zu akzeptieren und die Eingabeaufforderung zu vermeiden.
--Header	Optionaler HTTP-Quellheader von Windows-Paket-Manager.
--Authentifizierungsmodus	Angeben der Einstellung des Fensters „Authentifizierung“ (automatisch, vorzugsweise automatisch oder interaktiv).
--Authentifizierungs-Konto	Angeben des Kontos, das für die Authentifizierung verwendet werden soll.
-r, --recurse, --all	Aktualisiert alle installierten Pakete auf die neueste Version, falls verfügbar.
-u, --unbekannt, --include-unknown	Aktualisieren Sie Pakete, auch wenn deren aktuelle Version nicht bestimmt werden kann.
--pinned,--include-pinned	Aktualisiert Pakete auch dann, wenn sie über einen nicht blockierenden Pin verfügen.
--uninstall-previous	Deinstallieren Sie die vorherige Version des Pakets während upgrade. Das Verhalten wird vom jeweiligen Paket abhängen. Einige Installationsprogramme sind so konzipiert, dass sie neue Versionen nebeneinander installieren. Einige Installationsprogramme enthalten ein Manifest, das „uninstallPrevious“ angibt, sodass frühere Versionen deinstalliert werden, ohne dieses Befehlsflag verwenden zu müssen. In diesem Fall wird WinGet durch die Verwendung des winget upgrade --uninstall-previous-Befehls angewiesen, die vorherige Version zu deinstallieren, unabhängig davon, was im Paketmanifest steht. Wenn das Paketmanifest nicht „uninstallPrevious“ enthält und das Flag „--uninstall-previous“ nicht verwendet wird, wird das Standardverhalten für das Installationsprogramm angewendet.
--force	Führt den Befehl direkt aus und fährt mit nicht sicherheitsrelevanten Problemen fort.
-?,--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 Standardspeicherort für Protokolle.
--verbose,--verbose-logs	Wird verwendet, um die Protokollierungseinstellung zu überschreiben und ein ausführliches Protokoll zu erstellen.
--nowarn,--ignore-warnings (keine Warnungen anzeigen, Warnungen ignorieren)	Unterdrückt Warnungsausgaben.
--disable-interactivity	Deaktiviert 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.

Beispielabfragen

Das folgende Beispiel listet Anwendungen mit einem verfügbaren upgrade auf.

winget upgrade

Im folgenden Beispiel wird eine bestimmte Version einer Anwendung aktualisiert.

winget upgrade powertoys --version 0.15.2

Im folgenden Beispiel wird eine Anwendung anhand ihrer ID aktualisiert.

winget upgrade --id Microsoft.PowerToys

Das folgende Beispiel zeigt ein Upgrade aller Anwendungen.

winget upgrade --all

Im folgenden Beispiel werden upgrade mehrere Anwendungen verwendet.

winget upgrade Microsoft.Edit Microsoft.NuGet

Verwenden von upgrade

Um festzustellen, welche Apps ein update benötigen, verwenden Sie dazu einfach upgrade ohne Argumente, um alle verfügbaren Upgrades anzuzeigen.

upgrade --Alle

upgrade --all wird upgrade alle installierten Anwendungen, für die ein verfügbares update vorliegt. Wenn Sie wingetupgrade --all ausführen, sucht die Windows Paket-Manager nach allen Anwendungen mit verfügbaren Updates und versucht, die Updates zu installieren. Verwenden Sie upgrade zunächst ohne Argumente, um zu sehen, welche Apps aktualisiert werden.

Hinweis

Für einige Anwendungen werden keine Versionen bereitgestellt. Sie verwenden immer die Option „latest“. Da die Windows Paket-Manager nicht erkennen kann, ob eine neuere Version der App vorhanden ist, ist eine upgrade nur möglich, wenn die Option -u, --unknown, --include-unknown angegeben ist.

Hinweis

Einige Anwendungen wurden möglicherweise mit WinGet fixiert und werden nicht aktualisiert, wenn die Option --all angegeben ist, es sei denn, die Option --include-pinned ist angegeben. In diesem Fall werden nur Anwendungen aktualisiert, die nicht blockierende Pins verwenden.

upgrade --uninstall-previous

upgrade --uninstall-previous deinstalliert die vorherige Version vor der Installation der neueren Version des Pakets. Bei Verwendung von --uninstall-previous hängt das Verhalten vom einzelnen Paket ab. Einige Installationsprogramme sind so konzipiert, dass neue Versionen nebeneinander installiert werden, während andere Installationsprogramme ein Manifest enthalten, das als Standardverhalten uninstallPrevious angibt upgrade (sodass frühere Versionen deinstalliert werden, ohne die Befehlskennzeichnung verwenden zu müssen).

Wenn das Paketmanifest uninstallPrevious nicht als upgrade-Verhalten enthält und das --uninstall-previous-Flag nicht mit dem Befehl upgrade verwendet wird, gilt das Standardverhalten des Installationsprogramms.