Condividi tramite


Usare lo strumento WinGet per installare e gestire le applicazioni

WinGet è uno strumento da riga di comando che consente agli utenti di individuare, installare, aggiornare, rimuovere e configurare applicazioni nei computer Windows 10, Windows 11 e Windows Server 2025. Questo strumento è l'interfaccia client per il servizio Gestione pacchetti Windows.

Installa WinGet

WinGet il Gestione pacchetti Windows è disponibile in Windows 11, versioni moderne di Windows 10 e Windows Server 2025 come parte del programma di installazione app. Il programma di installazione app è un componente di sistema fornito e aggiornato da Microsoft Store nelle versioni di Windows Desktop e tramite aggiornamenti in Windows Server 2025.

Nota

Lo strumento della riga di comando WinGet è supportato solo in Windows 10 1709 (build 16299) o versioni successive. WinGet non sarà disponibile finché non si è connessi a Windows come utente per la prima volta, attivando Microsoft Store per registrare il Gestione pacchetti Windows come parte di un processo asincrono. Se, di recente, è stato effettuato il primo accesso come utente e Winget non è ancora disponibile, è possibile aprire PowerShell e inserire il seguente comando per richiedere la registrazione di Winget: Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.

Installare la versione di anteprima di WinGet [solo per sviluppatori]

WinGet è incluso nel Programma di installazione app Windows. Per provare le funzionalità più recenti di Gestione pacchetti Windows, è possibile installare una build di anteprima in uno dei seguenti modi:

  • Scaricare la versione di anteprima di WinGet più recente. Leggere le note sulla versione dell'anteprima di WinGet per informazioni su tutte le nuove funzionalità. L'installazione di questo pacchetto fornisce una versione di anteprima del client WinGet, ma non abilita gli aggiornamenti automatici delle nuove versioni di anteprima dal Microsoft Store.

  • Usare un account Microsoft (MSA), aziendale, dell'istituto di istruzione o di Azure Active Directory (AAD) per iscriversi al Canale sviluppatori di Windows Insider. Il Canale sviluppatori di Windows Insider include aggiornamenti automatici delle nuove versioni di anteprima dal Microsoft Store.

  • Usare un account Microsoft (MSA) per iscriversi al Programma Insider di Gestione pacchetti Windows. Una volta aggiunto l'account Microsoft (MSA) (alcuni giorni dopo aver ricevuto la notifica tramite posta elettronica), si riceveranno gli aggiornamenti automatici delle nuove versioni in anteprima dal Microsoft Store.

Installare WinGet nella Sandbox di Windows

Sandbox di Windows fornisce un ambiente desktop leggero per l'esecuzione sicura di applicazioni in isolamento. Il software installato nell'ambiente Sandbox di Windows rimane "contenuto della sandbox" ed eseguito separatamente dal computer host. Sandbox di Windows non include WinGet, né l'app di Microsoft Store, quindi, è necessario scaricare l'ultimo pacchetto WinGet dalla pagina delle versioni di WinGet in GitHub.

Per installare la versione stabile di Winget in Sandbox di Windows, seguire questa procedura da un prompt dei comandi di Windows PowerShell:

$progressPreference = 'silentlyContinue'
Write-Host "Installing WinGet PowerShell module from PSGallery..."
Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Write-Host "Using Repair-WinGetPackageManager cmdlet to bootstrap WinGet..."
Repair-WinGetPackageManager
Write-Host "Done."

Per installare il modulo PowerShell nell'ambito del computer, è possibile usare il -Scope AllUsers parametro con il Install-Module cmdlet . Se si vuole una versione di anteprima di WinGet, è possibile aggiungere -IncludePrerelease il parametro con il cmdlet Repair-WinGetPackageManager. Per visualizzare i parametri disponibili per il cmdlet Repair-WinGetPackageManager, è possibile eseguire Get-Help Repair-WinGetPackageManager -Full.

Per altre informazioni su Sandbox di Windows, tra cui come installare una sandbox e cosa aspettarsi dall'uso, vedere la documentazione sulla Sandbox di Windows.

Considerazioni per l'amministratore

Il comportamento del programma di installazione può variare a seconda che si esegua WinGet con privilegi di amministratore.

  • Quando WinGet viene eseguito senza privilegi di amministratore, l'installazione di alcune applicazioni potrebbe richiedere l'elevazione dei privilegi. Durante l'esecuzione del programma di installazione, Windows richiederà l'elevazione dei privilegi. Se scegli di non elevare i privilegi, l'installazione dell'applicazione non verrà completata.

  • Quando esegui WinGet da un prompt dei comandi come amministratore, non vengono visualizzate le richieste di elevazione dei privilegi delle applicazioni. Quando utilizzi il prompt dei comandi come amministratore, presta sempre attenzione e installa soltanto le applicazioni attendibili.

Usare WinGet

Dopo aver installato il Programma di installazione app, è possibile eseguire WinGet digitando "WinGet" da un prompt dei comandi.

Uno degli scenari di utilizzo più comuni consiste nella ricerca e nell'installazione di uno strumento preferito.

  1. Per cercare uno strumento, digita winget search <appname>.

  2. Dopo aver verificato che lo strumento desiderato è disponibile, puoi installarlo digitando winget install <appname>. WinGet avvierà il programma di installazione e installerà l'applicazione nel PC. riga di comando di winget

  3. Oltre a eseguire l'installazione e la ricerca, WinGet offre una serie di altri comandi che consentono di visualizzare i dettagli sulle applicazioni, modificare il codice sorgente e convalidare i pacchetti. Per un elenco completo dei comandi, digita: winget --help. guida di winget

Alcuni utenti hanno segnalato problemi relativi alla mancata presenza del client nel PERCORSO.

Comandi

La versione di anteprima corrente di WinGet supporta i comandi seguenti.

Comando Descrizione
info Mostra i metadati relativi al sistema (numeri di versione, architettura, posizione del log e così via). Utile per la risoluzione dei problemi.
install Installa l'applicazione specificata.
show Visualizza i dettagli per l'applicazione specificata.
source Aggiunge, rimuove e aggiorna i repository di Gestione pacchetti Windows accessibili tramite lo strumento WinGet.
search Cerca un'applicazione.
list Mostra i pacchetti installati.
upgrade Aggiorna il pacchetto specificato.
uninstall Disinstalla il pacchetto specificato.
hash Genera l'hash SHA256 per il programma di installazione.
validate Convalida un file manifesto da inviare al repository di Gestione pacchetti Windows.
impostazioni Apre le impostazioni.
features Mostra lo stato delle funzionalità sperimentali.
export Esporta un elenco dei pacchetti installati.
import Installa tutti i pacchetti in un file.
pin Gestisce le aggiunte del pacchetto.
configure Configura il sistema nello stato desiderato.
download Scarica il programma di installazione dell'applicazione specificata.

Opzioni

Lo strumento WinGet supporta le seguenti opzioni.

Opzione Descrizione
-v, --version Restituisce la versione corrente di WinGet.
--info Fornisce tutte le informazioni dettagliate su WinGet, compresi i collegamenti alla licenza, all'informativa sulla privacy e ai criteri di gruppo configurati.
-?, --help Mostra informazioni aggiuntive per WinGet.

Formati di programma di installazione supportati

Lo strumento WinGet supporta i tipi di programmi di installazione seguenti:

  • EXE (con flag Silent e SilentWithProgress)
  • ZIP
  • INNO
  • NULLSOFT
  • MSI
  • WIX
  • APPX
  • MSIX
  • BURN
  • PORTABLE

Creazione di script per WinGet

È possibile usare la seguente sintassi per installare più applicazioni in un singolo comando.

USAGE: winget install <query1> <query2> ...

Esempio

winget install Microsoft.WindowsTerminal Microsoft.PowerToys Microsoft.VisualStudioCode

Nota

Quando è controllato da script, WinGet avvia le applicazioni nell'ordine specificato. Quando un programma di installazione restituisce un esito positivo o negativo, WinGet avvia il programma di installazione successivo. Se un programma di installazione avvia un altro processo, è possibile che il controllo venga restituito a WinGet in anticipo. Di conseguenza, WinGet passerà al programma di installazione successivo prima che venga completato quello precedente.

Debug e risoluzione dei problemi

WinGet fornisce la registrazione per diagnosticare i problemi. Per la risoluzione dei problemi e i dettagli sulla registrazione, vedere Debug e risoluzione dei problemi.

Strumenti mancanti

Se il repository della community non include lo strumento o l'applicazione, è possibile inviare un pacchetto al nostro repository. Una volta aggiunto, il tuo strumento preferito sarà disponibile per te e per tutti gli utenti.

Personalizzare le impostazioni di WinGet

È possibile configurare l'esperienza della riga di comando di WinGet modificando il file settings.json. Per ulteriori informazioni, vedere https://aka.ms/winget-settings. Si noti che le impostazioni sono ancora in stato sperimentale e non sono state ancora finalizzate per la versione di anteprima dello strumento.

Dettagli relativi al codice open source

WinGet è uno strumento software open source disponibile su GitHub nel repository https://github.com/microsoft/winget-cli/. Il codice sorgente per la compilazione del client si trova nella cartella src.

Il codice sorgente per WinGet è contenuto in una soluzione Visual Studio 2019 C++. Per compilare correttamente la soluzione, installa la versione più recente di Visual Studio con il carico di lavoro C++.

Invitiamo a contribuire allo sviluppo del codice sorgente di WinGet su GitHub. A tal fine dovrai prima accettare e firmare il Contratto di licenza con il cliente (CLA) Microsoft.

Risoluzione dei problemi

Il repository WinGet-cli contiene un elenco di problemi ed errori comuni, insieme alle raccomandazioni su come risolverli: