comando di aggiornamento (winget)

Il comando upgrade dello strumento winget aggiorna l'applicazione specificata. Facoltativo, è possibile usare il comando list per identificare l'applicazione da aggiornare.

Per il comando upgrade è necessario specificare la stringa esatta da aggiornare. In caso di ambiguità, verrà richiesto di filtrare ulteriormente il comando upgrade in base a un'applicazione esatta.

Alias

Per questo comando sono disponibili gli alias seguenti:

  • update

Utilizzo

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

Immagine degli argomenti dei comandi di aggiornamento

Argomenti

Sono disponibili gli argomenti seguenti.

Argomento Descrizione
-q,--query Query usata per cercare un'app.

Nota

L'argomento della query è posizionale. La sintassi dello stile con caratteri jolly non è supportata. Si tratta quasi sempre della stringa di caratteri che si prevede aiuti a trovare il pacchetto che si sta aggiornando.

Opzioni

Le opzioni consentono di personalizzare l'esperienza di aggiornamento in base alle esigenze.

Opzione Descrizione
-m, --manifest Deve essere seguito dal percorso del file manifesto (YAML). Puoi usare il manifesto per eseguire l'esperienza di aggiornamento da un file YAML locale.
--id Limita l'aggiornamento all'ID dell'applicazione.
--name Limita la ricerca al nome dell'applicazione.
--moniker Limita la ricerca al moniker elencato per l'applicazione.
-v, --version Consente di specificare una versione esatta da aggiornare. Se non è specificata, verrà aggiornata l'applicazione con la versione più elevata.
-s, --source Limita la ricerca al nome specificato per l'origine. Deve essere seguito dal nome dell'origine.
e, --exact Usa la stringa esatta nella query, inclusa la verifica della distinzione tra maiuscole e minuscole. Non userà il comportamento predefinito di una sottostringa.
-i, -interactive Esegue il programma di installazione in modalità interattiva. L'esperienza predefinita mostra lo stato del programma di installazione.
-h, -silent Esegue il programma di installazione in modalità invisibile all'utente, senza visualizzare alcuna interfaccia utente. L'esperienza predefinita mostra lo stato del programma di installazione.
--purge Elimina tutti i file e le directory nella directory del pacchetto (portabile)
-o, --log Indirizza la registrazione a un file di log. È necessario specificare il percorso di un file per cui si dispone dei diritti di scrittura.
--custom Argomenti da passare al programma di installazione oltre alle impostazioni predefinite.
-override Stringa che verrà passata direttamente al programma di installazione.
-l, --location Percorso in cui eseguire l'aggiornamento (se supportato).
--scope Selezionare il filtro dell'ambito del pacchetto installato (utente o computer).
a, --architecture Selezionare l'architettura da installare.
--installer-type Selezionare il tipo di programma di installazione da aggiornare. Vedere Tipi di programma di installazione supportati per il client WinGet.
--locale Specifica le impostazioni locali da usare (formato BCP47).
--ignore-security-hash Ignorare l'errore di controllo hash del programma di installazione. Opzione non consigliata.
--allow-reboot Consente un riavvio, se applicabile.
--skip-dependencies Ignora le dipendenze dei pacchetti di elaborazione e le funzionalità di Windows.
--ignore-local-archive-malware-scan Ignorare l'analisi malware eseguita durante l'installazione di un pacchetto di tipo di archivio dal manifesto locale.
--accept-package-agreements Usato per accettare il contratto di licenza ed evitare la richiesta.
--accept-source-agreements Usato per accettare il contratto di licenza di origine ed evitare la richiesta.
--header Intestazione HTTP di origine REST di Windows-Package-Manager facoltativa.
--authentication-mode Specificare le preferenze della finestra di autenticazione (invisibile all'utente, silentPreferred o interattivo).
--authentication-account Specificare l'account da usare per l'autenticazione.
-r, --recurse, --all Aggiornare tutti i pacchetti installati alla versione più recente, se disponibile.
-u, --unknown, --include-unknown Aggiornare i pacchetti anche se non è possibile determinare la versione corrente.
--pinned,--include-pinned Aggiornare i pacchetti anche se hanno un pin senza blocco.
--uninstall-previous Disinstallare la versione precedente del pacchetto durante l'aggiornamento. Il comportamento dipende dal singolo pacchetto. Alcuni programmi di installazione sono progettati per installare nuove versioni affiancate. Alcuni programmi di installazione includono un manifesto che specifica "uninstallPrevious" in modo che le versioni precedenti vengano disinstallate senza dover usare questo flag di comando. In questo caso, l'uso del comando winget upgrade --uninstall-previous indicherà a WinGet di disinstallare la versione precedente indipendentemente da ciò che si trova nel manifesto del pacchetto. Se il manifesto del pacchetto non include "uninstallPrevious" e il flag --uninstall-previous non viene usato, verrà applicato il comportamento predefinito per il programma di installazione.
--force Eseguire direttamente il comando e continuare con problemi non correlati alla sicurezza.
-?,--help Mostra la Guida sul comando selezionato.
--wait Chiede all'utente di premere un tasto qualsiasi prima di uscire.
--logs,--open-logs Aprire il percorso dei log predefinito.
--verbose, --verbose-logs Usato per eseguire l'override dell'impostazione di registrazione e creare un log dettagliato.
--nowarn,--ignore-warnings Elimina gli output degli avvisi.
--disable-interactivity Disabilita le richieste interattive.
--proxy Impostare un proxy da usare per questa esecuzione.
--no-proxy Disabilitare l'uso del proxy per questa esecuzione.

Query di esempio

Nell'esempio seguente viene aggiornata una versione specifica di un'applicazione.

winget upgrade powertoys --version 0.15.2

Nell'esempio seguente viene aggiornata un'applicazione dal relativo ID.

winget upgrade --id Microsoft.PowerToys

L'esempio seguente mostra l'aggiornamento di tutte le applicazioni

winget upgrade --all

Uso di upgrade

Per identificare le app che necessitano di un aggiornamento, è sufficiente usare upgrade senza argomenti per visualizzare tutti gli aggiornamenti disponibili.

Nell'esempio seguente verrà visualizzato winget upgrade che mostra all'utente quali app hanno un aggiornamento disponibile. Dagli aggiornamenti disponibili, l'utente identifica che un aggiornamento è disponibile per JanDeDobbeleer.OhMyPosh e usa upgrade per aggiornare l'applicazione.

Animazione che illustra il comando di aggiornamento

Uso di list e upgrade

Per cercare un aggiornamento disponibile per un'app specifica, usare il comando list. Dopo aver rilevato che un aggiornamento è disponibile per l'app specifica, usare upgrade per installare l'ultima versione.

L'esempio seguente mostra il comando list usato per identificare che un aggiornamento è disponibile per Microsoft.WindowsTerminalPreview. L'utente usa quindi upgrade per aggiornare l'applicazione. Animazione che illustra il comando list usato insieme al comando di aggiornamento

upgrade --all

upgrade --all identificherà tutte le applicazioni con aggiornamenti disponibili. Quando si esegue winget upgrade --all, Gestione pacchetti di Windows cercherà tutte le applicazioni con aggiornamenti disponibili e tenterà di installare gli aggiornamenti.

Nota

Alcune applicazioni non forniscono una versione. Sono sempre aggiornate. Poiché Gestione pacchetti di Windows non è in grado di identificare se è presente una versione più recente dell'app, non sarà possibile eseguire un aggiornamento.

upgrade --uninstall-previous

upgrade --uninstall-previous disinstalla la versione precedente prima di installare la versione più recente del pacchetto. Quando si usa --uninstall-previous, il comportamento dipenderà dal singolo pacchetto. Alcuni programmi di installazione sono progettati per installare le nuove versioni side-by-side, mentre altri programmi di installazione includono un manifesto che specifica uninstallPrevious come comportamento di aggiornamento predefinito (quindi le versioni precedenti vengono disinstallate senza dover usare il flag di comando).

Se il manifesto del pacchetto non include uninstallPrevious come comportamento di aggiornamento e il --uninstall-previous flag non viene usato con il comando di aggiornamento, verrà applicato il comportamento predefinito per il programma di installazione.