Guida all'installazione di Sottosistema Windows per Linux per Windows 10Windows Subsystem for Linux Installation Guide for Windows 10

Installare il sottosistema Windows per LinuxInstall Windows Subsystem for Linux

Durante il processo di installazione è possibile scegliere tra due diverse versioni del sottosistema Windows per Linux.Windows Subsystem for Linux has two different versions to choose between during the installation process. WSL 2 offre prestazioni complessive migliori ed è quindi consigliabile.WSL 2 has better overall performance and we recommend using it. Se il sistema non supporta WSL 2 o se sussiste una situazione specifica che richiede l'archiviazione su più file system, potrebbe essere necessario usare WSL 1.If your system does not support WSL 2, or you have a specific situation that requires cross-system file storage, then you may want to stick with WSL 1. Per altre informazioni, vedi Confronto tra WSL 2 e WSL 1.Read more about Comparing WSL 2 and WSL 1.

Passaggio 1 - Abilitare il sottosistema Windows per LinuxStep 1 - Enable the Windows Subsystem for Linux

Prima di installare qualsiasi distribuzione di Linux in Windows, devi abilitare la funzionalità facoltativa "Sottosistema Windows per Linux".You must first enable the "Windows Subsystem for Linux" optional feature before installing any Linux distributions on Windows.

Apri PowerShell come amministratore ed esegui:Open PowerShell as Administrator and run:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

È consigliabile procedere al passaggio 2, relativo all'aggiornamento a WSL 2, ma se si vuole invece installare solo WSL 1, è ora possibile riavviare il computer e passare al Passaggio 6 - Installare la distribuzione Linux preferita.We recommend now moving on to step #2, updating to WSL 2, but if you wish to only install WSL 1, you can now restart your machine and move on to Step 6 - Install your Linux distribution of choice. Per eseguire l'aggiornamento a WSL 2, attendere il riavvio del computer e procedere al passaggio successivo.To update to WSL 2, wait to restart your machine and move on to the next step.

Passaggio 2 - Eseguire l'aggiornamento a WSL 2Step 2 - Update to WSL 2

Per eseguire l'aggiornamento a WSL 2, è necessario che sia in esecuzione Windows 10.To update to WSL 2, you must be running Windows 10.

RequisitiRequirements

  • Per i sistemi x64: Versione 1903 o successiva con Build 18362 o versione successiva.For x64 systems: Version 1903 or higher, with Build 18362 or higher.
  • Per i sistemi ARM64: Versione 2004 o successiva con Build 19041 o versione successiva.For ARM64 systems: Version 2004 or higher, with Build 19041 or higher.
  • Build inferiori alla versione 18362 non supportano WSL 2.Builds lower than 18362 do not support WSL 2. Per aggiornare la versione di Windows in uso, accedi all'Assistente aggiornamento di Windows.Use the Windows Update Assistant to update your version of Windows.

Per controllare la versione e il numero della build, premi il tasto Windows + R, digita winver e seleziona OK.To check your version and build number, select Windows logo key + R, type winver, select OK. In alternativa, immetti il comando ver nel prompt dei comandi di Windows.(Or enter the ver command in Windows Command Prompt). Aggiorna alla versione più recente di Windows nel menu Impostazioni.Update to the latest Windows version in the Settings menu.

Nota

Se è in esecuzione Windows 10 versione 1903 o 1909, apri "Impostazioni" dal menu Windows, passa a "Aggiornamento e sicurezza" e seleziona "Verifica disponibilità aggiornamenti".If you are running Windows 10 version 1903 or 1909, open "Settings" from your Windows menu, navigate to "Update & Security" and select "Check for Updates". Il numero della build deve essere 18362.1049 + o 18363.1049+, con la build secondaria superiore a .1049.Your Build number must be 18362.1049+ or 18363.1049+, with the minor build # over .1049. Altre informazioni: Il supporto per WSL 2 è disponibile in Windows 10 versioni 1903 e 1909.Read more: WSL 2 Support is coming to Windows 10 Versions 1903 and 1909. Fai riferimento alle istruzioni per la risoluzione dei problemi.See the troubleshooting instructions.

Passaggio 3: - Abilitare le funzionalità delle macchine virtualiStep 3 - Enable Virtual Machine feature

Prima di installare WSL 2, devi abilitare la funzionalità facoltativa Virtual Machine Platform.Before installing WSL 2, you must enable the Virtual Machine Platform optional feature.

Apri PowerShell come amministratore ed esegui:Open PowerShell as Administrator and run:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Per completare l'installazione di WSL e aggiornare a WSL 2, riavvia il computer.Restart your machine to complete the WSL install and update to WSL 2.

Passaggio 4 - Scaricare il pacchetto di aggiornamento del kernel LinuxStep 4 - Download the Linux kernel update package

  1. Scarica il pacchetto più recente:Download the latest package:

    Nota

    Se usi un computer ARM64, scarica invece il pacchetto ARM64.If you're using an ARM64 machine, please download the ARM64 package instead. Se non sai con esattezza il tipo di computer in uso, apri il prompt dei comandi o PowerShell e digita: systeminfo | find "System Type".If you're not sure what kind of machine you have, open Command Prompt or PowerShell and enter: systeminfo | find "System Type".

  2. Esegui il pacchetto di aggiornamento scaricato nel passaggio precedente.Run the update package downloaded in the previous step. Fai doppio clic per eseguire: ti verrà richiesto di impostare privilegi elevati. Seleziona Sì per approvare questa installazione.(Double-click to run - you will be prompted for elevated permissions, select ‘yes’ to approve this installation.)

Al termine dell'installazione, procedi al passaggio successivo, ovvero l'impostazione di WSL 2 come versione predefinita quando si installano nuove distribuzioni di Linux.Once the installation is complete, move on to the next step - setting WSL 2 as your default version when installing new Linux distributions. Ignora questo passaggio se vuoi che le nuove installazioni di Linux siano impostate su WSL 1.(Skip this step if you want your new Linux installs to be set to WSL 1).

Nota

Per altre informazioni, leggi l'articolo sulle modifiche apportate all'aggiornamento del kernel Linux WSL2, disponibile nel blog della riga di comando di Windows.For more information, read the article changes to updating the WSL2 Linux kernel, available on the Windows Command Line Blog.

Passaggio 5 - Impostare WSL 2 come versione predefinitaStep 5 - Set WSL 2 as your default version

Aprire PowerShell ed eseguire questo comando per impostare WSL 2 come versione predefinita durante l'installazione di una nuova distribuzione Linux:Open PowerShell and run this command to set WSL 2 as the default version when installing a new Linux distribution:

wsl --set-default-version 2

Nota

Il completamento dell'aggiornamento da WSL 1 a WSL 2 potrebbe richiedere diversi minuti a seconda delle dimensioni della distribuzione di destinazione.The update from WSL 1 to WSL 2 may take several minutes to complete depending on the size of your targeted distribution. Se si sta eseguendo un'installazione precedente (legacy) di WSL 1 da Windows 10 Aggiornamento dell'anniversario o Creators Update, è possibile che si verifichi un errore di aggiornamento.If you are running an older (legacy) installation of WSL 1 from Windows 10 Anniversary Update or Creators Update, you may encounter an update error. Per disinstallare e rimuovere le distribuzioni legacy, segui queste istruzioni.Follow these instructions to uninstall and remove any legacy distributions.

Se wsl --set-default-version viene restituito come comando non valido, immettere wsl --help.If wsl --set-default-version results as an invalid command, enter wsl --help. Se --set-default-version non è elencato, significa che non è supportato dal sistema operativo ed è necessario eseguire l'aggiornamento alla versione 1903, build 18362 o successive.If the --set-default-version is not listed, it means that your OS doesn't support it and you need to update to version 1903, Build 18362 or higher.

Se dopo l'esecuzione del comando viene visualizzato questo messaggio: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel.If you see this message after running the command: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel. Devi ancora installare il pacchetto di aggiornamento del kernel Linux di MSI.You still need to install the MSI Linux kernel update package.

Passaggio 6 - Installare la distribuzione di Linux preferitaStep 6 - Install your Linux distribution of choice

  1. Apri Microsoft Store e scegli le distribuzioni di Linux preferite.Open the Microsoft Store and select your favorite Linux distribution.

    Visualizzazione delle distribuzioni di Linux in Microsoft Store

    I collegamenti seguenti aprono la pagina di Microsoft Store per ogni distribuzione:The following links will open the Microsoft store page for each distribution:

  2. Nella pagina della distribuzione fai clic su "Ottieni".From the distribution's page, select "Get".

    Distribuzioni di Linux in Microsoft Store

Passaggio 7 - Configurare una nuova distribuzioneStep 7 - Set up a new distribution

Al primo avvio di una distribuzione di Linux appena installata, si aprirà una finestra della console e ti verrà richiesto di attendere qualche minuto per la decompressione e l'archiviazione dei file nel PC.The first time you launch a newly installed Linux distribution, a console window will open and you'll be asked to wait for a minute or two for files to de-compress and be stored on your PC. Tutti gli avvii successivi dovrebbero richiedere meno di un secondo.All future launches should take less than a second.

Devi poi creare un account utente e una password per la tua nuova distribuzione di Linux.You will then need to create a user account and password for your new Linux distribution.

Decompressione di Ubuntu nella console di Windows

CONGRATULAZIONI! Hai correttamente installato e configurato una distribuzione Linux completamente integrata con il sistema operativo Windows.CONGRATULATIONS! You've successfully installed and set up a Linux distribution that is completely integrated with your Windows operating system!

Installare Terminale Windows (facoltativo)Install Windows Terminal (optional)

Terminale Windows consente di usare più schede (passa rapidamente tra più righe di comando di Linux, prompt dei comandi di Windows, PowerShell, interfaccia della riga di comando di Azure e così via), creare binding personalizzati dei tasti (combinazioni di tasti per aprire o chiudere le schede, copia+incolla e così via), usare la funzionalità di ricerca e configurare temi personalizzati (schemi di colori, stili e dimensioni dei caratteri, immagine di sfondo/sfocatura/trasparenza).Windows Terminal enables multiple tabs (quickly switch between multiple Linux command lines, Windows Command Prompt, PowerShell, Azure CLI, etc), create custom key bindings (shortcut keys for opening or closing tabs, copy+paste, etc.), use the search feature, and custom themes (color schemes, font styles and sizes, background image/blur/transparency). Altre informazioni.Learn more.

Installare Terminale Windows.Install Windows Terminal.

Terminale Windows

Impostare la versione di distribuzione su WSL 1 o WSL 2Set your distribution version to WSL 1 or WSL 2

È possibile controllare la versione di WSL assegnata a ognuna delle distribuzioni di Linux installate aprendo la riga di comando di PowerShell e immettendo il comando wsl -l -v (disponibile solo nella build 18362 di Windows o successive).You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 18362 or higher): wsl -l -v

wsl --list --verbose

Per impostare una distribuzione di cui eseguire il backup da una delle due versioni di WSL, esegui:To set a distribution to be backed by either version of WSL please run:

wsl --set-version <distribution name> <versionNumber>

Assicurati di sostituire <distribution name> con il nome effettivo della distribuzione e <versionNumber> con il numero "1" o "2".Make sure to replace <distribution name> with the actual name of your distribution and <versionNumber> with the number '1' or '2'. 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, verrà impostata la versione di qualsiasi nuova distribuzione installata su WSL 2.This will set the version of any new distribution installed to WSL 2.

Risoluzione dei problemi relativi all'installazioneTroubleshooting installation

Di seguito sono riportati gli errori segnalati e le correzioni suggerite.Below are related errors and suggested fixes. Fai riferimento alla pagina relativa alla risoluzione dei problemi di Sottosistema Windows per Linux per altre informazioni sugli errori comuni e le relative soluzioni.Refer to the WSL troubleshooting page for other common errors and their solutions.

  • Installazione non riuscita. Codice di errore: 0x80070003Installation failed with error 0x80070003

    • Sottosistema Windows per Linux viene eseguito solo nell'unità di sistema (in genere l'unità C:).The Windows Subsystem for Linux only runs on your system drive (usually this is your C: drive). Assicurati che le distribuzioni siano archiviate nell'unità di sistema:Make sure that distributions are stored on your system drive:
    • Aprire Impostazioni -> **Sistema --> Archiviazione -> Altre impostazioni di memoria: Modifica il percorso di salvataggio dei nuovi contenuti Immagine delle impostazioni di sistema per l'installazione delle app nell'unità C:Open Settings -> **System --> Storage -> More Storage Settings: Change where new content is saved Picture of system settings to install apps on C: drive
  • Operazione di WslRegisterDistribution non riuscita con errore 0x8007019eWslRegisterDistribution failed with error 0x8007019e

    • Il componente facoltativo Sottosistema Windows per Linux non è abilitato:The Windows Subsystem for Linux optional component is not enabled:
    • Apri il Pannello di controllo -> Programmi e funzionalità -> Attivazione o disattivazione delle funzionalità Windows -> Seleziona Sottosistema Windows per Linux oppure usa il cmdlet di PowerShell indicato all'inizio dell'articolo.Open Control Panel -> Programs and Features -> Turn Windows Feature on or off -> Check Windows Subsystem for Linux or using the PowerShell cmdlet mentioned at the beginning of this article.
  • 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

    • Verificare che il sottosistema Windows per Linux sia abilitato e usare la build 18362 di Windows o versioni successive.Enure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 18362 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.
  • Non è possibile completare l'operazione richiesta a causa di una limitazione del sistema del disco virtuale. I file dei dischi rigidi virtuali devono essere non compressi e non crittografati. Inoltre, non devono essere 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.

    • Deselezionare "Comprimi contenuto" (oltre a "Crittografa contenuto" se questa opzione è selezionata) aprendo la cartella del profilo per la distribuzione Linux.Deselect “Compress contents” (as well as “Encrypt contents” if that’s checked) by opening the profile folder for your Linux distribution. Deve trovarsi in una cartella del file system di Windows, ad esempio: USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited...It should be located in a folder on your Windows file system, something like: USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited...
    • In questo profilo di distribuzione Linux dovrebbe essere presente una cartella LocalState.In this Linux distro profile, there should be a LocalState folder. Fare clic con il pulsante destro del mouse su questa cartella per visualizzare un menu di opzioni.Right-click this folder to display a menu of options. Selezionare Proprietà > Avanzate e quindi assicurarsi che le caselle di controllo "Comprimi contenuto per risparmiare spazio su disco" e "Crittografa contenuto per la protezione dei dati" siano deselezionate.Select Properties > Advanced and then ensure that the “Compress contents to save disk space” and “Encrypt contents to secure data” checkboxes are unselected (not checked). Se si visualizza la richiesta di applicare questa opzione solo alla cartella corrente o a tutte le sottocartelle e i file, selezionare "Solo questa cartella" perché è necessario deselezionare solo il flag per la compressione.If you are asked whether to apply this to just to the current folder or to all subfolders and files, select “just this folder” because you are only clearing the compress flag. Al termine di questa operazione, il comando wsl --set-version dovrebbe funzionare.After this, the wsl --set-version command should work.

Screenshot delle impostazioni delle proprietà della distribuzione WSL

Nota

In questo caso, la cartella LocalState per la distribuzione di Ubuntu 18.04 si trovava in C:\Utenti<my-user-name>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgscIn my case, the LocalState folder for my Ubuntu 18.04 distribution was located at C:\Users<my-user-name>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc

Per informazioni aggiornate, vedere il thread 4103 sulla documentazione di WSL in GitHub, dove viene tenuta traccia di questo problema.Check WSL Docs GitHub thread #4103 where this issue is being tracked for updated information.

  • Termine 'wsl' non riconosciuto come nome di cmdlet, funzione, programma eseguibile o file script.The term 'wsl' is not recognized as the name of a cmdlet, function, script file, or operable program.

  • Errore: Questo aggiornamento si applica solo ai computer con il sottosistema Windows per Linux.Error: This update only applies to machines with the Windows Subsystem for Linux.

    • Per installare il pacchetto MSI di aggiornamento del kernel Linux, è necessario aver prima abilitato WSL.To install the Linux kernel update MSI package, WSL is required and should be enabled first. Se l'operazione ha esito negativo, verrà visualizzato il messaggio This update only applies to machines with the Windows Subsystem for Linux.If it fails, it you will see the message: This update only applies to machines with the Windows Subsystem for Linux.
    • Questo messaggio può essere visualizzato per tre motivi:There are three possible reason you see this message:
    1. È in uso una versione precedente di Windows che non supporta WSL 2.You are still in old version of Windows which doesn't support WSL 2. Fai riferimento al Passaggio 2 per i requisiti di versione e i collegamenti ai file di aggiornamento.See step #2 for version requirements and links to update.

    2. WSL non è abilitato.WSL is not enabled. Torna al Passaggio 1 e assicurati che nel computer in uso sia abilitata la funzionalità WSL facoltativa.You will need to return to step #1 and ensure that the optional WSL feature is enabled on your machine.

    3. Dopo aver abilitato WSL, è necessario riavviare il computer affinché la modifica venga applicata. Riavvia il computer e riprova.After you enabled WSL, a reboot is required for it to take effect, reboot your machine and try again.

  • Errore: WSL 2 richiede un aggiornamento al relativo componente kernel. Per altre informazioni, visita https://aka.ms/wsl2kernel .Error: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel .

    • Questo errore si verifica se il pacchetto del kernel Linux non è incluso nella cartella%SystemRoot%\system32\lxss\tools.If the Linux kernel package is missing in the %SystemRoot%\system32\lxss\tools folder, you will encounter this error. Per risolverlo, installa il pacchetto MSI di aggiornamento del kernel Linux, come illustrato nel Passaggio 4 di queste istruzioni di installazione.Resolve it by installing the Linux kernel update MSI package in step #4 of these installation instructions. È possibile che sia necessario disinstallare MSI da Installazione applicazioni e installarlo di nuovo.You may need to uninstall the MSI from 'Add or Remove Programs', and install it again.