Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
I comandi WSL seguenti sono elencati in un formato supportato da PowerShell o dal prompt dei comandi di Windows. Per eseguire questi comandi da una riga di comando di distribuzione Bash/Linux, è necessario sostituire wsl
con wsl.exe
. Per un elenco completo dei comandi, eseguire wsl --help
. Se non lo hai ancora fatto, ti consigliamo di aggiornare alla versione di WSL installata da Microsoft Store per ricevere gli aggiornamenti di WSL appena diventano disponibili. (Altre informazioni sull'installazione di WSL tramite Microsoft Store.).
Installare
wsl --install
Installare WSL e la distribuzione ubuntu predefinita di Linux.
Altre informazioni. È anche possibile usare questo comando per installare distribuzioni Linux aggiuntive eseguendo wsl --install <Distribution Name>
. Per un elenco valido di nomi di distribuzione, eseguire wsl --list --online
.
Le opzioni includono:
-
--distribution
: specificare la distribuzione linux da installare. È possibile trovare le distribuzioni disponibili eseguendowsl --list --online
. -
--no-launch
: installare la distribuzione linux ma non avviarla automaticamente. -
--web-download
: installare da un'origine online anziché usare Microsoft Store.
Quando WSL non è installato, le opzioni includono:
-
--inbox
: installa WSL usando il componente Windows invece di usare Microsoft Store. (gli aggiornamenti WSL verranno ricevuti tramite gli aggiornamenti di Windows, anziché essere inseriti come disponibili tramite lo Store). -
--enable-wsl1
: abilita WSL 1 durante l'installazione della versione di Microsoft Store di WSL abilitando anche il componente facoltativo "Sottosistema Windows per Linux". -
--no-distribution
: non installare una distribuzione durante l'installazione di WSL.
Nota
Se si esegue WSL in Windows 10 o versione precedente, potrebbe essere necessario includere il flag -d
con il comando --install
per specificare una distribuzione: wsl --install -d <distribution name>
.
Elencare le distribuzioni di Linux disponibili
wsl --list --online
Vedere un elenco delle distribuzioni di Linux disponibili tramite lo Store online. Questo comando può anche essere immesso come: wsl -l -o
.
Elencare le distribuzioni linux installate
wsl --list --verbose
Vedere un elenco delle distribuzioni linux installate nel computer Windows, incluso lo stato (se la distribuzione è in esecuzione o arrestata) e la versione di WSL che esegue la distribuzione (WSL 1 o WSL 2).
Confronto di WSL 1 e WSL 2. Questo comando può anche essere immesso come: wsl -l -v
. Le opzioni aggiuntive che possono essere usate con il comando list includono: --all
per elencare tutte le distribuzioni, --running
per elencare solo le distribuzioni attualmente in esecuzione o --quiet
per visualizzare solo i nomi di distribuzione.
Impostare la versione WSL su 1 o 2
wsl --set-version <distribution name> <versionNumber>
Per designare la versione di WSL (1 o 2) in cui è in esecuzione una distribuzione Linux, sostituire <distribution name>
con il nome della distribuzione e sostituire <versionNumber>
con 1 o 2.
Confronto di WSL 1 e WSL 2. WSL 2 è disponibile solo in Windows 11 o Windows 10, versione 1903, Build 18362 o successiva.
Avvertimento
Il passaggio tra WSL 1 e WSL 2 può richiedere molto tempo e causare errori a causa delle differenze tra le due architetture. Per le distribuzioni con progetti di grandi dimensioni, è consigliabile eseguire il backup dei file prima di tentare una conversione.
Impostare la versione predefinita di WSL
wsl --set-default-version <Version>
Per impostare una versione predefinita di WSL 1 o WSL 2, sostituire <Version>
con il numero 1 o 2. Ad esempio, wsl --set-default-version 2
. Il numero rappresenta la versione di WSL per impostazione predefinita per le nuove installazioni di distribuzione Linux.
Confronto di WSL 1 e WSL 2. WSL 2 è disponibile solo in Windows 11 o Windows 10, versione 1903, Build 18362 o successiva.
Impostare la distribuzione predefinita di Linux
wsl --set-default <Distribution Name>
Per impostare la distribuzione Linux predefinita usata dai comandi WSL per l'esecuzione, sostituire <Distribution Name>
con il nome della distribuzione Linux preferita.
Avviare WSL nella home page dell'utente
wsl ~
Il ~
può essere usato con wsl per iniziare nella home directory dell'utente. Per passare da qualsiasi directory alla directory principale dall'interno di un prompt dei comandi WSL, è possibile usare il comando cd ~
.
Eseguire una distribuzione Linux specifica da PowerShell o CMD
wsl --distribution <Distribution Name> --user <User Name>
Per eseguire una distribuzione Linux specifica con un utente specifico, sostituire <Distribution Name>
con il nome della distribuzione Linux preferita (ad esempio. Debian) e <User Name>
con il nome di un utente esistente (ad esempio root). Se l'utente non esiste nella distribuzione WSL, verrà visualizzato un errore. Per stampare il nome utente corrente, usare il comando whoami
.
Aggiornare WSL
wsl --update
Aggiornare la versione di WSL alla versione più recente. Le opzioni includono:
-
--web-download
: scaricare l'aggiornamento più recente da GitHub anziché da Microsoft Store.
Controllare lo stato di WSL
wsl --status
Vedere informazioni generali sulla configurazione WSL, ad esempio il tipo di distribuzione predefinito, la distribuzione predefinita e la versione del kernel.
Controllare la versione di WSL
wsl --version
Controllare le informazioni sulla versione relative a WSL e ai relativi componenti.
Comando di aiuto
wsl --help
Vedere un elenco di opzioni e comandi disponibili con WSL.
Esegui come utente specifico
wsl --user <Username>
Per eseguire WSL come utente specificato, sostituire <Username>
con il nome di un utente presente nella distribuzione WSL.
Modificare l'utente predefinito per una distribuzione
<DistributionName> config --default-user <Username>
Modificare l'utente predefinito per l'accesso alla distribuzione. L'utente deve già esistere all'interno della distribuzione per diventare l'utente predefinito.
Ad esempio: ubuntu config --default-user johndoe
cambierebbe l'utente predefinito per la distribuzione ubuntu all'utente "johndoe".
Nota
Se si verificano problemi durante la ricerca del nome della distribuzione, usare il comando wsl -l
.
Avvertimento
Questo comando non funzionerà per le distribuzioni importate, perché queste distribuzioni non hanno un'utilità di avvio eseguibile. È invece possibile modificare l'utente predefinito per le distribuzioni importate usando il file /etc/wsl.conf
. Vedere le opzioni di smontaggio automatico nella documentazione Configurazione impostazioni avanzate.
Chiusura
wsl --shutdown
Termina immediatamente tutte le distribuzioni in esecuzione e la macchina virtuale leggera ausiliaria di WSL 2. Questo comando potrebbe essere necessario nelle istanze che richiedono di riavviare l'ambiente di macchina virtuale WSL 2, ad esempio modifica dei limiti di utilizzo della memoria o apportare una modifica al file .wslconfig.
Terminare
wsl --terminate <Distribution Name>
Per terminare la distribuzione specificata o arrestarla dall'esecuzione, sostituire <Distribution Name>
con il nome della distribuzione di destinazione.
Identificare l'indirizzo IP
-
wsl hostname -I
: restituisce l'indirizzo IP della distribuzione Linux installata tramite WSL 2 (l'indirizzo della macchina virtuale WSL 2) -
ip route show | grep -i default | awk '{ print $3}'
: restituisce l'indirizzo IP del computer Windows, come illustrato da WSL 2 (macchina virtuale WSL 2)
Per una spiegazione più dettagliata, vedere Accesso alle applicazioni di rete con WSL: Identificare l'indirizzo IP.
Esportare una distribuzione
wsl --export <Distribution Name> <FileName>
Esporta uno snapshot della distribuzione specificata come nuovo file di distribuzione. L'impostazione predefinita è tar format. Il nome file può essere -
per l'input standard. Le opzioni includono:
-
--vhd
: specifica che la distribuzione di esportazione deve essere un file con estensione vhdx anziché un file tar (supportato solo con WSL 2)
Importare una distribuzione
wsl --import <Distribution Name> <InstallLocation> <FileName>
Importa il file tar specificato come nuova distribuzione. Il nome file può essere -
per l'input standard. Le opzioni includono:
-
--vhd
: specifica che la distribuzione di importazione deve essere un file con estensione vhdx anziché un file tar (supportato solo con WSL 2) -
--version <1/2>
: specifica se importare la distribuzione come distribuzione WSL 1 o WSL 2
Importare una distribuzione sul posto
wsl --import-in-place <Distribution Name> <FileName>
Importa il file con estensione vhdx specificato come nuova distribuzione. Il disco rigido virtuale deve essere formattato nel tipo di file system ext4.
Annullare la registrazione o disinstallare una distribuzione Linux
Anche se le distribuzioni di Linux possono essere installate tramite Microsoft Store, non possono essere disinstallate tramite lo Store.
Per annullare la registrazione e disinstallare una distribuzione WSL:
wsl --unregister <DistributionName>
La sostituzione di <DistributionName>
con il nome della distribuzione Linux di destinazione annulla la registrazione della distribuzione da WSL in modo che possa essere reinstallata o pulita.
attenzione: Una volta annullata la registrazione, tutti i dati, le impostazioni e il software associati a tale distribuzione andranno persi definitivamente. La reinstallazione dallo store installerà una copia pulita della distribuzione. Ad esempio, wsl --unregister Ubuntu
rimuoveRebbe Ubuntu dalle distribuzioni disponibili in WSL. L'esecuzione di wsl --list
rivelerà che non è più elencato.
È anche possibile disinstallare l'app di distribuzione Linux nel computer Windows come qualsiasi altra applicazione store. Per reinstallare, trovare la distribuzione in Microsoft Store e selezionare "Avvia".
Montare un disco o un dispositivo
wsl --mount <DiskPath>
Collegare e montare un disco fisico in tutte le distribuzioni WSL2 sostituendo <DiskPath>
con il percorso directory\file in cui si trova il disco. Consulta per montare un disco Linux in WSL 2. Le opzioni includono:
-
--vhd
: specifica che<Disk>
fa riferimento a un disco rigido virtuale. -
--name
: montare il disco usando un nome personalizzato per il punto di montaggio -
--bare
: collegare il disco a WSL2, ma non montarlo. -
--type <Filesystem>
: Tipo di file system da usare durante il montaggio di un disco; se non specificato, per impostazione predefinita viene utilizzato ext4. Questo comando può anche essere immesso come:wsl --mount -t <Filesystem>
. È possibile rilevare il tipo di file system usando il comando :blkid <BlockDevice>
, ad esempio:blkid <dev/sdb1>
. -
--partition <Partition Number>
: numero di indice della partizione da montare, se non specificato, per impostazione predefinita monta l'intero disco. -
--options <MountOptions>
: sono disponibili alcune opzioni specifiche del file system che possono essere incluse durante il montaggio di un disco. Ad esempio, opzioni di montaggio ext4 come:wsl --mount -o "data-ordered"
owsl --mount -o "data=writeback
. Tuttavia, al momento sono supportate solo le opzioni specifiche del file system. Le opzioni generiche, ad esempioro
,rw
onoatime
, non sono supportate.
Nota
Se si esegue un processo a 32 bit per accedere a wsl.exe (uno strumento a 64 bit), potrebbe essere necessario eseguire il comando nel modo seguente: C:\Windows\Sysnative\wsl.exe --command
.
Smontare i dischi
wsl --unmount <DiskPath>
Smontare un disco specificato nel percorso del disco, se non viene specificato alcun percorso del disco, questo comando smonterà e scollegarà TUTTI i dischi montati.
Comandi WSL deprecati
wslconfig.exe [Argument] [Options]
bash [Options]
lxrun /[Argument]
Questi comandi erano la sintassi wsl originale per la configurazione delle distribuzioni Linux installate con WSL, ma sono state sostituite con la sintassi del comando wsl
o wsl.exe
.
Windows Subsystem for Linux