upgrade opdracht (winget)

Met de upgrade opdracht van het WinGet-hulpprogramma wordt de opgegeven toepassing bijgewerkt. U kunt eventueel de lijstopdracht gebruiken om de gewenste toepassing upgradete identificeren.

De opdracht upgrade vereist dat u de exacte tekenreeks opgeeft voor upgrade. Als er dubbelzinnigheid is, wordt u gevraagd de upgrade opdracht verder te filteren op een exacte toepassing.

Aliassen

De volgende aliassen zijn beschikbaar voor deze opdracht:

  • update

Gebruik

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

Afbeelding van argumenten van de opdracht upgrade Schermopname van het invoeren van de opdracht wingetupgrade in een opdrachtregel in Windows Terminal.

Argumenten

De volgende argumenten zijn beschikbaar.

Argumentatie Beschrijving
-q,--query De query die wordt gebruikt om naar een app te zoeken.

Opmerking

Het queryargument is positioneel. De wildcard-syntaxis wordt niet ondersteund. Dit is meestal de tekenreeks die u verwacht te helpen bij het vinden van het pakket dat u wilt upgraden.

Opties

Met de opties kunt u de upgrade ervaring aanpassen aan uw behoeften.

Optie Beschrijving
-m, --manifest Moet worden gevolgd door het pad naar het manifestbestand (YAML). U kunt het manifest gebruiken om de upgrade ervaring uit te voeren vanuit een lokaal YAML-bestand.
--id Hiermee beperkt u de upgrade tot de ID van de toepassing.
--name Hiermee beperkt u de zoekopdracht tot de naam van de toepassing.
--moniker Hiermee beperkt u de zoekopdracht tot de moniker die voor de toepassing wordt vermeld.
-v, --version Hiermee kunt u een exacte versie opgeven voor upgrade. Als dit niet is opgegeven, wordt upgrade latest gebruikt voor de toepassing met het hoogste versienummer.
-s, --source Hiermee wordt de zoekopdracht beperkt tot de opgegeven bronnaam. Moet worden gevolgd door de bronnaam.
-e, --exact Gebruikt de exacte tekenreeks in de query, inclusief het controleren op hoofdlettergevoeligheid. Het standaardgedrag van een subtekenreeks wordt niet gebruikt.
-i, --interactive Voert het installatieprogramma uit in de interactieve modus. De standaardervaring toont de voortgang van het installatieprogramma.
-h, --silent Hiermee wordt het installatieprogramma uitgevoerd in de stille modus. Hiermee onderdrukt u alle gebruikersinterface. De standaardervaring toont de voortgang van het installatieprogramma.
--purge Verwijdert alle bestanden en mappen in de pakketmap (draagbaar)
-o, --log Hiermee wordt de logging doorgestuurd naar een logbestand. U moet een pad opgeven naar een bestand waarvoor u de schrijfrechten hebt.
--custom Argumenten die moeten worden doorgegeven aan het installatieprogramma, naast de standaardwaarden.
--override Een tekenreeks die rechtstreeks aan het installatieprogramma wordt doorgegeven.
-l, --location Locatie naar upgrade (indien ondersteund).
--scope Selecteer het geïnstalleerde pakketbereikfilter (gebruiker of machine).
a, --architecture Selecteer de architectuur die u wilt installeren.
--installer-type Selecteer het type installatieprogramma dat u wilt upgradegebruiken. Zie ondersteunde installatietypen voor WinGet-client.
--locale Specificeert welke landinstelling te gebruiken (BCP47-indeling).
--ignore-security-hash Negeer de hashcontrolefout van het installatieprogramma. Niet aanbevolen.
--allow-reboot Hiermee kunt u indien van toepassing opnieuw opstarten.
--skip-dependencies Slaat de afhankelijkheden van verwerkingspakketten en Windows-functies over.
--ignore-local-archive-malware-scan Negeer de malwarescan die wordt uitgevoerd als onderdeel van het installeren van een archieftypepakket vanuit het lokale manifest.
--accept-package-agreements Wordt gebruikt om de gebruiksrechtovereenkomst te accepteren en de prompt te vermijden.
--accept-source-agreements Wordt gebruikt om de bronlicentieovereenkomst te accepteren en de prompt te vermijden.
--header Optionele Windows-Package-Manager REST-bron als HTTP-header.
--authentication-mode Geef de voorkeursvoorkeur voor verificatievensters op (stil, silentPreferred of interactief).
--authentication-account Geef het account op dat moet worden gebruikt voor verificatie.
-r, --recurse, --all Upgrade alle geïnstalleerde pakketten naar de nieuwste versie, indien beschikbaar.
-u, --unknown, --include-unknown Upgradepakketten, zelfs als hun huidige versie niet kan worden bepaald.
--pinned,--include-pinned Pakketten updaten, zelfs als ze een niet-blokkerende pin hebben.
--uninstall-previous Verwijder de vorige versie van het pakket tijdens upgrade. Gedrag is afhankelijk van het afzonderlijke pakket. Sommige installatieprogramma's zijn ontworpen om nieuwe versies naast elkaar te installeren. Sommige installatieprogramma's bevatten een manifest dat 'uninstallPrevious' aangeeft, zodat eerdere versies worden verwijderd zonder deze opdrachtvlag te hoeven gebruiken. In dit geval geeft WinGet met behulp van de winget upgrade --uninstall-previous opdracht opdracht om de vorige versie te verwijderen, ongeacht wat zich in het pakketmanifest bevindt. Als het pakketmanifest geen 'uninstallPrevious' bevat en de --uninstall-previous vlag niet wordt gebruikt, is het standaardgedrag voor het installatieprogramma van toepassing.
--force Voer de opdracht direct uit en ga door met niet-beveiligingsgerelateerde problemen.
-?,--help Geeft hulp bij het geselecteerde commando.
--wait Vraagt de gebruiker om, voordat het programma wordt afgesloten, op een willekeurige toets te drukken.
--logs,--open-logs Open de standaardlocatie van de logboeken.
--verbose, --verbose-logs Wordt gebruikt om de loginstellingen te overschrijven en een gedetailleerd logboek te maken.
--nowarn,--ignore-warnings Onderdrukt waarschuwingsuitvoer.
--disable-interactivity Schakel interactieve prompts uit.
--proxy Stel een proxy in die moet worden gebruikt voor deze uitvoering.
--no-proxy Schakel het gebruik van proxy uit voor deze uitvoering.

Voorbeeldvragen

Het volgende voorbeeld bevat toepassingen met een beschikbare upgrade.

winget upgrade

In het volgende voorbeeld wordt een specifieke versie van een toepassing bijgewerkt.

winget upgrade powertoys --version 0.15.2

In het volgende voorbeeld wordt een toepassing bijgewerkt op basis van de id.

winget upgrade --id Microsoft.PowerToys

In het volgende voorbeeld ziet u hoe u alle toepassingen bijwerkt.

winget upgrade --all

In het volgende voorbeeld worden upgrade meerdere toepassingen gebruikt.

winget upgrade Microsoft.Edit Microsoft.NuGet

Het gebruiken van upgrade

Om vast te stellen welke apps een update nodig hebben, gebruikt u eenvoudigweg upgrade zonder argumenten om alle beschikbare upgrades weer te geven.

upgrade --all

upgrade --all zal upgrade alle geïnstalleerde applicaties waarvoor een beschikbare update is. Wanneer u uitvoertwinget upgrade --all, zoekt de Windows Pakketbeheer naar alle toepassingen met updates die beschikbaar zijn en probeert de updates te installeren. Gebruik upgrade eerst zonder argumenten om een voorbeeld te bekijken van welke apps worden bijgewerkt.

Opmerking

Sommige toepassingen bieden geen versie. Ze zijn altijd nieuwste. Omdat de Windows Pakketbeheer niet kan identificeren of er een nieuwere versie van de app is, is een upgrade optie niet mogelijk tenzij de optie -u, --unknownis --include-unknown opgegeven

Opmerking

Sommige toepassingen zijn mogelijk met behulp van WinGet vastgezet en worden niet geüpgraded als de optie --all is opgegeven, tenzij de optie --include-pinned is opgegeven. In dit geval worden alleen toepassingen die niet blokkerende pinnen bijgewerkt.

upgrade --uninstall-previous

upgrade --uninstall-previous verwijdert u de vorige versie voordat u de nieuwere versie van het pakket installeert. Bij gebruik --uninstall-previousis het gedrag afhankelijk van het afzonderlijke pakket. Sommige installatieprogramma's zijn ontworpen om nieuwe versies naast elkaar te installeren, terwijl andere installatieprogramma's een manifest bevatten dat het standaardgedrag uninstallPrevious aangeeft upgrade (dus eerdere versies worden verwijderd zonder de opdrachtvlag te hoeven gebruiken).

Als het pakketmanifest uninstallPrevious niet als het gedrag upgrade bevat en de vlag --uninstall-previous niet wordt gebruikt met het commando upgrade, dan wordt het standaardgedrag van het installatieprogramma toegepast.