Condividi tramite


comando di installazione (winget)

Il comando di installazione di WinGet installa l'applicazione specificata. Usa il comando search per identificare l'applicazione da installare. Usare il comando show per visualizzare i dettagli sull'applicazione e il programma di installazione selezionato da WinGet per il sistema.

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

Utilizzo

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

Screenshot che elenca le opzioni della Guida del comando winget import.

Alias

Per questo comando sono disponibili gli alias seguenti:

  • add (aggiungi)

Argomenti

Sono disponibili gli argomenti seguenti.

Argomento Descrizione
-q,--query La query utilizzata per cercare un'applicazione.

Nota

L'argomento della query è posizionale. Per impostazione predefinita, winget esegue una corrispondenza di sottostringa senza distinzione tra maiuscole e minuscole rispetto al nome, all'ID e al moniker del pacchetto. La sintassi con caratteri jolly non è supportata. Usare -e, --exact per richiedere una corrispondenza esatta (con distinzione tra maiuscole e minuscole). Usare --id, --name o --moniker per limitare il campo cercato.

Opzioni

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

Opzione Descrizione
-m, --manifesto Deve essere seguito dal percorso del file manifest (YAML). Puoi usare il manifesto per eseguire l'esperienza di installazione da un file YAML locale.
--Id Limita l'installazione all'ID dell'applicazione.
--nome Limita la ricerca al nome dell'applicazione.
--soprannome Limita la ricerca al moniker elencato per l'applicazione.
-v, --version Consente di specificare una versione esatta da installare. Se l'opzione "latest" non è specificata, verrà installata l'applicazione con la versione più recente.
-s, --source Limita la ricerca al nome specificato per l'origine. Deve essere seguito dal nome dell'origine.
--ambito Consente di specificare se la destinazione del programma di installazione deve essere per ambito utente o ambito macchina. Vedere Problemi noti relativi all'ambito di installazione del pacchetto.
-a, --architettura Selezionare l'architettura da installare.
--installer-type Selezionare il tipo di programma di installazione da installare. Vedere Tipi di programma di installazione supportati per il client WinGet.
-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, sopprime tutte le interfacce utente. L'esperienza predefinita mostra lo stato del programma di installazione.
--locale Specifica le impostazioni locali da usare (formato BCP47).
-o, --log Indirizza la registrazione a un file di registro. È necessario specificare il percorso di un file per cui si dispone dei diritti di scrittura.
--personalizzato 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'installazione (se supportato).
--ignore-security-hash Ignorare l'errore di controllo hash del programma di installazione. Opzione non consigliata.
--allow-reboot Permette di eseguire un riavvio, se applicabile.
--skip-dependencies (ignorare le dipendenze) Ignora le dipendenze dei pacchetti di elaborazione e le funzionalità di Windows.
--ignora-controllo-malware-su-archivio-locale Ignorare l'analisi malware eseguita come parte del processo di installazione di un pacchetto di tipo archivio dal manifest locale.
--dependency-source Trovare le dipendenze del pacchetto usando l'origine specificata.
--accetta-contratti-di-pacchetto Accetta tutti i contratti di licenza o gli EULA presentati dal programma di installazione del pacchetto, eliminando il prompt interattivo. Questo vale solo per le condizioni di licenza del pacchetto: non influisce sui componenti facoltativi o sul software in bundle offerto dal programma di installazione. Per un'installazione completamente non interattiva, combinare con --silent (-h).
--no-upgrade Ignora l'aggiornamento se esiste già una versione installata.
--intestazione 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.
--accept-source-accordi Accetta il contratto di licenza per l'origine WinGet (repository), disabilitando il prompt interattivo. Questo è separato da qualsiasi licenza del pacchetto – copre i termini di utilizzo del codice sorgente stesso, come il repository della comunità winget.
-r, --rename Il valore con cui rinominare il file eseguibile (portabile).
--uninstall-previous Disinstallare la versione precedente del pacchetto durante l'aggiornamento.
--forza Eseguire direttamente il comando e continuare con problemi non correlati alla sicurezza.
-?, --aiuto Ottiene informazioni aggiuntive su questo comando.
--aspettare Chiede all'utente di premere un tasto qualsiasi prima di uscire.
--logs,--open-logs (comandi per visualizzare i log) 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 Sopprime gli output degli avvisi.
--disabilita-interattività 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 installata una versione specifica di un'applicazione.

winget install powertoys --version 0.91.1

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

winget install --id Microsoft.PowerToys

Nell'esempio seguente viene installata un'applicazione in base alla versione e all'ID.

winget install --id Microsoft.PowerToys --version 0.91.1

Installare più pacchetti

È possibile installare più pacchetti in un singolo comando elencando gli ID separati da spazi.

winget install Microsoft.VisualStudioCode Microsoft.PowerShell Git.Git

WinGet installa ogni pacchetto in sequenza. Ciò è utile per configurare rapidamente un nuovo computer o condividere un set di strumenti con un collega.

Suggerimento

Per set di pacchetti di dimensioni maggiori, è consigliabile usare l'esportazione winget e l'importazione winget per salvare e ripristinare un elenco completo di pacchetti o configurare winget per installare i pacchetti insieme ad altre configurazioni del computer in un singolo file.

Disambiguare i risultati

Se la query fornita a WinGet non genera una singola applicazione, WinGet visualizzerà i risultati della ricerca. In questo modo sarà possibile ottenere i dati aggiuntivi necessari per affinare la ricerca per la corretta installazione.

Il modo migliore per limitare la selezione a un file consiste nell'usare l'ID dell'applicazione in combinazione con l'opzione di query exact. Ad esempio:

winget install --id Git.Git -e

Se sono configurate più origini, è possibile avere voci duplicate. È necessario specificare un'origine per un'ulteriore disambiguazione.

winget install --id Git.Git -e --source winget

L'origine msstore usa identificatori univoci come "Id" per i pacchetti. Questi non richiedono l'opzione di query precisa. Ad esempio:

winget install XP9KHM4BK9FZ7Q -s msstore

Installazione locale

L'opzione manifest consente di installare un'applicazione passando un file YAML direttamente al client. Se il manifesto è un manifesto multi-file, è necessario usare la directory contenente i file. L'opzione manifest prevede la sintassi seguente.

Sintassi: winget install --manifest \<path>

Opzione Descrizione
-m, --manifesto Il percorso dei manifesti dell'applicazione da installare.

L'installazione di pacchetti da file manifesto locali può comportare rischi. Come ulteriore misura di precauzione, questa funzionalità deve essere abilitata da un amministratore. Per abilitare questa funzionalità, eseguire winget settings --enable LocalManifestFiles. Per disabilitare questa funzionalità, eseguire winget settings --disable LocalManifestFiles.

File di registro

I file di log per WinGet, a meno che non vengano reindirizzati, si troveranno nella cartella seguente: \%LOCALAPPDATA%\\Packages\\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\\LocalState\\DiagOutputDir\\*.log

Contratti di licenza

Alcune applicazioni, quando installate, richiederanno all'utente di accettare la licenza o altri contratti prima dell'installazione. In questo caso, Gestione pacchetti di Windows chiederà all'utente di accettare i contratti. Se l'utente non li accetta, l'applicazione non verrà installata.

screenshot della richiesta del contratto utente in winget.

Dalla riga di comando è possibile accettare automaticamente i contratti passando l'opzione seguente --accept-package-agreements sulla riga di comando. Ciò può essere utile durante lo scripting del Gestore pacchetti di Windows.