Comandi di base per WSL

I comandi WSL seguenti sono elencati in un formato supportato da PowerShell o Windows prompt dei comandi. Per eseguire questi comandi da una riga di comando di distribuzione Bash/Linux, è necessario sostituire wsl con wsl.exe.

Installazione

wsl --install

Installare WSL e la distribuzione Ubuntu di Linux. Altre informazioni

Installare una distribuzione Linux specifica

wsl --install --distribution <Distribution Name>

Designare una distribuzione di Linux per l'installazione oltre al valore predefinito (Ubuntu) sostituendo <Distribution Name> con il nome della distribuzione. Questo comando può essere immesso anche come: wsl -d <Distribution Name>.

Elencare le distribuzioni Linux disponibili

wsl --list --online

Vedere un elenco delle distribuzioni Linux disponibili tramite l'archivio online. Questo comando può essere immesso anche 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 tra WSL 1 e WSL 2. Questo comando può essere immesso anche come: wsl -l -v. Le opzioni aggiuntive che possono essere usate con il comando elenco includono: --all per elencare tutte le distribuzioni, --running elencare solo le distribuzioni attualmente in esecuzione o --quiet 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 esecuzione in una distribuzione Linux, sostituire <distribution name> con il nome della distribuzione e sostituire <versionNumber> con 1 o 2. Confronto tra WSL 1 e WSL 2.

Impostare la versione WSL predefinita

wsl --set-default-version <Version>

Per impostare una versione predefinita di WSL 1 o WSL 2, sostituendo <Version> con il numero 1 o 2 per rappresentare quale versione di WSL si desidera che l'installazione sia predefinita per le nuove installazioni di distribuzione Linux. Ad esempio: wsl --set-default-version 2. Confronto tra WSL 1 e WSL 2.

Impostare la distribuzione Linux predefinita

wsl --set-default <Distribution Name>

Per impostare la distribuzione Linux predefinita che i comandi WSL useranno per l'esecuzione, sostituire <Distribution Name> con il nome della distribuzione Linux preferita.

Modificare la directory nella home

wsl ~

Può ~ essere usato con wsl per iniziare nella home directory dell'utente. Per passare da qualsiasi directory a home dall'interno di un prompt dei comandi WSL, è possibile usare il comando : cd ~.

Eseguire una distribuzione Linux specifica da PowerShell o DA 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 radice). 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 manualmente la versione del kernel Linux WSL. È anche possibile usare il comando: wsl --update rollback per eseguire il rollback in una versione precedente del kernel WSL Linux.

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.

Comando della Guida

wsl --help

Vedere un elenco di opzioni e comandi disponibili con WSL.

Eseguire come utente specifico

wsl -u <Username>`, `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 il log di distribuzione. L'utente deve già esistere all'interno della distribuzione per diventare l'utente predefinito.

Ad esempio, ubuntu config --default-user johndoe modificare 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.

Avviso

Questo comando non funzionerà per le distribuzioni importate, perché queste distribuzioni non dispongono di un launcher eseguibile. È invece possibile modificare l'utente predefinito per le distribuzioni importate usando il /etc/wsl.conf file. Vedere le opzioni di smontaggio automatico nella documentazione Configurazione avanzata Impostazioni.

Arresta

wsl --shutdown

Termina immediatamente tutte le distribuzioni in esecuzione e la macchina virtuale dell'utilità leggera WSL 2. Questo comando può essere necessario nelle istanze che richiedono di riavviare l'ambiente macchina virtuale WSL 2, ad esempio la modifica dei limiti di utilizzo della memoria o l'esecuzione di una modifica al file con estensione wslconfig.

Terminate

wsl --terminate <Distribution Name>

Per terminare la distribuzione specificata o arrestarla dall'esecuzione, sostituire <Distribution Name> con il nome della distribuzione di destinazione.

Esportare una distribuzione in un file TAR

wsl --export <Distribution Name> <FileName>

Esporta la distribuzione in un file tar. Il nome file può essere - per l'output standard.

Importare una nuova distribuzione

wsl --import <Distribution Name> <InstallLocation> <FileName>

Importa il file tar specificato come nuova distribuzione. Il nome file può essere - per l'intput standard. L'opzione --version può essere usata anche con questo comando per designare se la distribuzione importata verrà eseguita in WSL 1 o WSL 2.

Annullare la registrazione o disinstallare una distribuzione Linux

Anche se le distribuzioni linux possono essere installate tramite il Microsoft Store, non possono essere disinstallate tramite l'archivio.

Per annullare la registrazione e disinstallare una distribuzione WSL:

wsl --unregister <DistributionName>

La sostituzione <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 verranno persi definitivamente. Con la reinstallazione da Microsoft Store viene installata una copia pulita della distribuzione. Ad esempio, wsl --unregister Ubuntu rimuovere Ubuntu dalle distribuzioni disponibili in WSL. L'esecuzione wsl --list rivelerà che non è più elencata.

È anche possibile disinstallare l'app di distribuzione Linux nel computer Windows proprio come qualsiasi altra applicazione dello store. Per reinstallare, trovare la distribuzione nella 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. Vedere Montare un disco Linux in WSL 2. Le opzioni includono:

  • wsl --mount --bare: collegare il disco a WSL2, ma non montarlo.
  • wsl --mount --type <Filesystem>: tipo di file system da usare durante il montaggio di un disco, se non specificato per impostazione predefinita fino a ext4. Questo comando può essere immesso anche come: wsl --mount -t <Filesystem>. È possibile rilevare il tipo di file system usando il comando : blkid <BlockDevice>, ad esempio : blkid <dev/sdb1>.
  • wsl --mount --partition <Partition Number>: numero di indice della partizione da montare, se non specificato per impostazione predefinita per l'intero disco.
  • wsl --mount --options <MountOptions>: sono disponibili alcune opzioni specifiche del file system che possono essere incluse durante il montaggio di un disco. Ad esempio, le opzioni di montaggio ext4 , ad esempio: wsl --mount -o "data-ordered" o wsl --mount -o "data=writeback. Tuttavia, solo le opzioni specifiche del file system sono supportate in questo momento. Le opzioni generiche, ad esempio ro, rwo noatime, non sono supportate.
  • wsl --unmount <DiskPath>: smontare e scollegare il disco da tutte le distribuzioni di WSL 2. Se non <DiskPath> è incluso, questo comando smonterà e scollega tutti i dischi montati.

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.

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 wsl sintassi dei comandi o wsl.exe .