Befehl „upgrade“ (winget)
Mit dem Befehl upgrade des winget-Tools wird die angegebene Anwendung aktualisiert. Optional können Sie den Befehl list verwenden, um die Anwendung zu identifizieren, die Sie aktualisieren möchten.
Der Befehl upgrade erfordert, dass Sie die exakte Zeichenfolge für das Upgrade angeben. Wenn Mehrdeutigkeiten vorliegen, werden Sie aufgefordert, den Befehl upgrade auf eine exakte Anwendung zu filtern.
Aliase
Die folgenden Aliase stehen für diesen Befehl zur Verfügung:
- aktualisieren
Verbrauch
winget upgrade [[-q] <query> ...] [<options>]
Argumente
Folgende Argumente sind verfügbar.
| Argument | 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 Benutzeroberfläche für Upgrades an Ihre jeweiligen Anforderungen anpassen.
| Option | Beschreibung |
|---|---|
| -m, --manifest | Hierauf muss der Pfad zur Manifestdatei (YAML) folgen. Sie können das Manifest verwenden, um die Benutzeroberfläche für Upgrades aus einer lokalen YAML-Datei auszuführen. |
| --id | Schränkt das Upgrade auf die ID der Anwendung ein. |
| --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 | Hiermit können Sie genau angeben, welche Version aktualisiert werden soll. Sofern nicht angegeben, wird mit „latest“ die Anwendung mit der höchsten Version aktualisiert. |
| -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. |
| --custom | 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 | Gewünschte Speicherort für das Upgrade (sofern unterstützt). |
| --scope | Wählt den installierten Paketbereichsfilter (Benutzer oder Computer) aus. |
| a, --architecture | Wählen Sie die zu installierende Architektur aus. |
| --installer-type | Wählen Sie zum Upgrade den Installationstyp aus. 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 Schadsoftwareüberprüfung, die als Teil der Installation eines Archivtyppakets aus dem lokalen Manifest ausgeführt wurde. |
| --accept-package-agreements | 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. |
| --authentication-mode | Angeben der Einstellung des Fensters „Authentifizierung“ (automatisch, vorzugsweise automatisch oder interaktiv). |
| --authentication-account | 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, --unknown, --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 | Deinstalliert die vorherige Version des Pakets während des Upgrades. 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. |
| --wait | 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 | 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
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 das Upgrade aller Apps.
winget upgrade --all
Verwenden von upgrade
Um zu ermitteln, welche Apps ein Update benötigen, verwenden Sie einfach upgrade ohne Argumente, um alle verfügbaren Upgrades anzuzeigen.
Im folgenden Beispiel wird dem Benutzer mithilfe von winget upgrade angezeigt, für welche Apps ein Update verfügbar ist. In den verfügbaren Updates sieht der Benutzer, dass ein Update für JanDeDobbeleer.OhMyPosh verfügbar ist, und verwendet upgrade zum Aktualisieren der Anwendung.
Verwenden von list und upgrade
Um nach einem verfügbaren Update für eine bestimmte App zu suchen, verwenden Sie den Befehl list. Nachdem Sie festgestellt haben, dass ein Update für eine bestimmte App verfügbar ist, verwenden Sie upgrade, um das neueste Update zu installieren.
Im folgenden Beispiel wird der Befehl list verwendet, um festzustellen, dass ein Update für Microsoft.WindowsTerminalPreview verfügbar ist. Der Benutzer verwendet dann upgrade, um die Anwendung zu aktualisieren.
upgrade --all
upgrade --all identifiziert alle Anwendungen, für die Upgrades verfügbar sind. Wenn Sie winget upgrade --all ausführen, sucht der Windows-Paket-Manager nach allen Anwendungen, für die Updates verfügbar sind, und versucht, die Updates zu installieren.
Hinweis
Für einige Anwendungen werden keine Versionen bereitgestellt. Sie verwenden immer die Option „latest“. Da der Windows-Paket-Manager nicht erkennen kann, ob eine neuere Version der App vorhanden ist, ist kein Upgrade möglich.
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 Standardupgradeverhalten angibt uninstallPrevious (sodass frühere Versionen deinstalliert werden, ohne die Befehlskennzeichnung verwenden zu müssen).
Wenn das Paketmanifest nicht uninstallPrevious als Upgradeverhalten enthält und das Flag --uninstall-previous nicht mit dem Upgradebefehl verwendet wird, wird das Standardverhalten für das Installationsprogramm angewendet.
Windows developer