Istruzioni di installazione per WSL 2Installation Instructions for WSL 2

Per installare e iniziare a usare WSL 2, segui questa procedura:To install and start using WSL 2 complete the following steps:

WSL 2 è disponibile solo in Windows 10 Build 18917 o versione successivaWSL 2 is only available in Windows 10 builds 18917 or higher

  • Assicurarsi che WSL sia installato (le istruzioni sono disponibili qui) e che sia in esecuzione Windows 10 Build 18917 o versione successivaEnsure that you have WSL installed (you can find instructions to do so here) and that you are running Windows 10 build 18917 or higher
    • Per assicurarsi di usare build 18917 o versione successiva, partecipare al programma Windows Insider e selezionare l'anello "Fast".To make sure you are using build 18917 or higher please join the Windows Insider Program and select the 'Fast' ring.
    • È possibile controllare la versione di Windows aprendo il prompt dei comandi ed eseguendo il comando ver.You can check your Windows version by opening Command Prompt and running the ver command.
  • Abilita il componente facoltativo 'Virtual Machine Platform'Enable the 'Virtual Machine Platform' optional component
  • Imposta una distribuzione con supporto di WSL 2 tramite la riga di comandoSet a distro to be backed by WSL 2 using the command line
  • Verifica le versioni di WSL usate dalle distribuzioniVerify what versions of WSL your distros are using

Abilitare il componente facoltativo "piattaforma macchina virtuale" e verificare che WSL sia abilitato.Enable the 'Virtual Machine Platform' optional component and make sure WSL is enabled

Per abilitare il componente "piattaforma macchina virtuale", aprire PowerShell come amministratore ed eseguire il comando seguente.To enable the 'Virtual Machine Platform' component open PowerShell as an administrator and run the command below. Se si installa WSL per la prima volta, selezionare ' No ' quando viene richiesto un riavvio, perché sarà necessario riavviare il computer comunque dopo l'installazione del componente facoltativo ' sottosistema Windows per Linux '.If you are installing WSL for the first time then select 'No' when prompted for a restart, as you will need to restart your machine anyway after installing the 'Windows Subsystem for Linux' optional component.

Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

Sarà anche necessario assicurarsi che il sottosistema Windows per il componente facoltativo Linux sia abilitato.You will also need to make sure that the Windows Subsystem for Linux optional component is enabled. È possibile eseguire questa operazione eseguendo il comando seguente da una finestra di PowerShell con privilegi di amministratore:You can do this by running the following command from a PowerShell window with administrator privileges:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

Riavviare il computer per completare l'installazione di entrambi i componenti.Please restart your machine to finish installing both components.

Imposta una distribuzione con supporto di WSL 2 tramite la riga di comandoSet a distro to be backed by WSL 2 using the command line

Se non è installata una distro Linux, fare riferimento alla pagina installa in Windows 10 docs per istruzioni su come installarne una.If you do not have a Linux distro installed, please refer to the Install on Windows 10 docs page for instructions on installing one.

In PowerShell esegui:In PowerShell run:

wsl --set-version <Distro> 2

e assicurati di sostituire <Distro> con il nome effettivo della distribuzione.and make sure to replace <Distro> with the actual name of your distro. (Puoi trovarlo con il comando wsl -l.)(You can find these with the command: wsl -l). Puoi tornare a WSL 1 in qualsiasi momento eseguendo lo stesso comando precedente, ma sostituendo '2' con '1'.You can change back to WSL 1 at anytime by running the same command as above but replacing the '2' with a '1'.

Inoltre, se vuoi impostare WSL 2 come architettura predefinita, puoi farlo con questo comando:Additionally, if you want to make WSL 2 your default architecture you can do so with this command:

wsl --set-default-version 2

In questo modo tutte le nuove distribuzioni installate verranno inizializzate come distribuzione WSL 2.This will make any new distro that you install be initialized as a WSL 2 distro.

Completa l'operazione verificando le versioni di WSL usate dalla distribuzioneFinish with verifying what versions of WSL your distro are using

Per verificare quali versioni di WSL ogni distro usa usare il comando seguente (disponibile solo in Windows Build 18917 o versione successiva):To verify what versions of WSL each distro is using use the following command (only available in Windows Build 18917 or higher):

wsl --list --verbose o wsl -l -vwsl --list --verbose or wsl -l -v

La distribuzione scelta in precedenza dovrebbe ora visualizzare '2' nella colonna 'version'.The distro that you've chosen above should now display a '2' under the 'version' column. A questo punto puoi iniziare a usare la distribuzione di WSL 2.Now that you're finished feel free to start using your WSL 2 distro!

Risoluzione dei problemi:Troubleshooting:

Di seguito sono riportati gli errori correlati e le correzioni suggerite per l'installazione di WSL 2.Below are related errors and suggested fixes when installing WSL 2. Fai riferimento alla pagina relativa alla risoluzione dei problemi di WSL per altre informazioni sugli errori generali di WSL e le relative soluzioni.Please refer to the WSL troubleshooting page for other general WSL errors and their solutions.

  • Installazione non riuscita con errore 0x80070003 o errore 0x80370102Installation failed with error 0x80070003 or error 0x80370102

    • Assicurati che la virtualizzazione sia abilitata all'interno del BIOS del computer.Please make sure that virtualization is enabled inside of your computer's BIOS. Le istruzioni su come eseguire questa verifica variano da computer a computer ed è molto probabile che siano disponibili tra le opzioni correlate alla CPU.The instructions on how to do this will vary from computer to computer, and will most likely be under CPU related options.
  • Errore durante il tentativo di aggiornamento: Invalid command line option: wsl --set-version Ubuntu 2Error when trying to upgrade: Invalid command line option: wsl --set-version Ubuntu 2

    • Verifica che il sottosistema Windows per Linux sia abilitato e assicurati di usare la build 18917 di Windows o una versione successiva.Please make sure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 18917 or higher. Per abilitare WSL, esegui questo comando in un prompt di PowerShell con privilegi di amministratore: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.To enable WSL run this command in a Powershell prompt with admin privileges: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux. Puoi trovare le istruzioni complete per l'installazione di WSL qui.You can find the full WSL install instructions here.
  • Non è stato possibile completare l'operazione richiesta a causa di una limitazione del sistema del disco virtuale. I file dei dischi rigidi virtuali devono essere decompressi e non crittografati e non devono essere di tipo sparse.The requested operation could not be completed due to a virtual disk system limitation. Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.