Dela via

Grundläggande kommandon för WSL

WSL-kommandona nedan visas i ett format som stöds av PowerShell eller Windows-kommandotolken. Om du vill köra dessa kommandon från en Bash-/Linux-distributionskommandorad måste du ersätta wsl med wsl.exe. Kör wsl --helpför en fullständig lista med kommandon. Om du inte har gjort det ännu rekommenderar vi uppdatering till den version av WSL som är installerad från Microsoft Store för att kunna ta emot WSL-uppdateringar så snart de är tillgängliga. (Läs mer om hur du installerar WSL via Microsoft Store.).

Installera

wsl --install

Installera WSL och Ubuntu-standarddistributionen av Linux. Läs mer. Du kan också använda det här kommandot för att installera ytterligare Linux-distributioner genom att köra wsl --install <Distribution Name>. Kör wsl --list --onlineför en giltig lista med distributionsnamn.

Alternativen är:

  • --distribution: Ange den Linux-distribution som ska installeras. Du hittar tillgängliga distributioner genom att köra wsl --list --online.
  • --no-launch: Installera Linux-distributionen men starta den inte automatiskt.
  • --web-download: Installera från en onlinekälla i stället för att använda Microsoft Store.

När WSL inte är installerat finns följande alternativ:

  • --inbox: Installerar WSL med hjälp av Windows-komponenten i stället för att använda Microsoft Store. (WSL-uppdateringar tas emot via Windows-uppdateringar i stället för att skickas ut som tillgängliga via butiken).
  • --enable-wsl1: Aktiverar WSL 1 under installationen av Microsoft Store-versionen av WSL genom att även aktivera den valfria komponenten "Windows-undersystem för Linux".
  • --no-distribution: Installera inte en distribution när du installerar WSL.

Not

Om du kör WSL på Windows 10 eller en äldre version kan du behöva inkludera flaggan -d med kommandot --install för att ange en distribution: wsl --install -d <distribution name>.

Visa en lista över tillgängliga Linux-distributioner

wsl --list --online

Se en lista över de Linux-distributioner som är tillgängliga via onlinebutiken. Det här kommandot kan också anges som: wsl -l -o.

Lista installerade Linux-distributioner

wsl --list --verbose

Se en lista över De Linux-distributioner som är installerade på din Windows-dator, inklusive tillståndet (oavsett om distributionen körs eller stoppas) och versionen av WSL som kör distributionen (WSL 1 eller WSL 2). Jämförelse mellan WSL 1 och WSL 2. Det här kommandot kan också anges som: wsl -l -v. Ytterligare alternativ som kan användas med listkommandot är: --all för att visa alla distributioner, --running att endast visa distributioner som körs eller --quiet för att endast visa distributionsnamn.

Ange WSL-version till 1 eller 2

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

Om du vill ange vilken version av WSL (1 eller 2) som en Linux-distribution körs på ersätter du <distribution name> med namnet på distributionen och ersätter <versionNumber> med 1 eller 2. Jämförelse mellan WSL 1 och WSL 2. WSL 2 är endast tillgängligt i Windows 11 eller Windows 10, Version 1903, Build 18362 eller senare.

Varning

Att växla mellan WSL 1 och WSL 2 kan vara tidskrävande och leda till fel på grund av skillnaderna mellan de två arkitekturerna. För distributioner med stora projekt rekommenderar vi att du säkerhetskopierar filer innan du försöker konvertera.

Ange standardversion av WSL

wsl --set-default-version <Version>

Om du vill ange en standardversion av WSL 1 eller WSL 2 ersätter du <Version> med antingen talet 1 eller 2. Till exempel wsl --set-default-version 2. Siffran representerar den version av WSL som ska användas som standard för nya installationer av Linux-distributioner. Jämförelse mellan WSL 1 och WSL 2. WSL 2 är endast tillgängligt i Windows 11 eller Windows 10, Version 1903, Build 18362 eller senare.

Ställ in standarddistributionen för Linux

wsl --set-default <Distribution Name>

Om du vill ange den Linux-standarddistribution som WSL-kommandon ska använda för att köra ersätter du <Distribution Name> med namnet på din föredragna Linux-distribution.

Starta WSL i användarens hem

wsl ~

~ kan användas med wsl för att starta i användarens hemmapp. Om du vill hoppa från valfri katalog tillbaka till hemmet från en WSL-kommandotolk kan du använda kommandot: cd ~.

Köra en specifik Linux-distribution från PowerShell eller CMD

wsl --distribution <Distribution Name> --user <User Name>

Om du vill köra en specifik Linux-distribution med en specifik användare ersätter du <Distribution Name> med namnet på din föredragna Linux-distribution (dvs. Debian) och <User Name> med namnet på en befintlig användare (dvs. rot). Om användaren inte finns i WSL-distributionen får du ett fel. Om du vill skriva ut det aktuella användarnamnet använder du kommandot whoami.

Uppdatera WSL

wsl --update

Uppdatera WSL-versionen till den senaste versionen. Alternativen är:

  • --web-download: Ladda ned den senaste uppdateringen från GitHub i stället för Microsoft Store.

Kontrollera WSL-status

wsl --status

Se allmän information om din WSL-konfiguration, till exempel standarddistributionstyp, standarddistribution och kernelversion.

Kontrollera WSL-versionen

wsl --version

Kontrollera versionsinformationen om WSL och dess komponenter.

Hjälpkommando

wsl --help

Se en lista över alternativ och kommandon som är tillgängliga med WSL.

Kör som en specifik användare

wsl --user <Username>

Om du vill köra WSL som en angiven användare ersätter du <Username> med namnet på en användare som finns i WSL-distributionen.

Ändra standardanvändaren för en distribution

<DistributionName> config --default-user <Username>

Ändra standardanvändaren för distributionens inloggning. Användaren måste redan finnas i fördelningen för att bli standardanvändare.

Till exempel: ubuntu config --default-user johndoe skulle ändra standardanvändaren för Ubuntu-fördelningen till "johndoe"-användaren.

Not

Om du har problem med att ta reda på namnet på distributionen använder du kommandot wsl -l.

Varning

Det här kommandot fungerar inte för importerade distributioner eftersom dessa distributioner inte har någon körbar start. Du kan i stället ändra standardanvändaren för importerade distributioner med hjälp av filen /etc/wsl.conf. Se alternativen för automatisk avmontering i dokumentet Konfiguration av avancerade inställningar.

Avstängning

wsl --shutdown

Avslutar omedelbart alla körande distributioner och WSL 2-lättviktsverktygs virtuella maskin. Det här kommandot kan vara nödvändigt i instanser som kräver att du startar om WSL 2-miljön för virtuella datorer, till exempel ändra minnesanvändningsgränser eller göra en ändring i filen .wslconfig.

Avsluta

wsl --terminate <Distribution Name>

Om du vill avsluta den angivna distributionen eller stoppa den från att köras ersätter du <Distribution Name> med namnet på den riktade fördelningen.

Identifiera IP-adressen

  • wsl hostname -I: Returnerar IP-adressen för din Linux-distribution installerad via WSL 2 (WSL 2 VM-adressen)
  • ip route show | grep -i default | awk '{ print $3}': Returnerar IP-adressen för Windows-datorn enligt WSL 2 (den virtuella WSL 2-datorn)

En mer detaljerad förklaring finns i Åtkomst till nätverksprogram med WSL: Identifiera IP-adress.

Exportera en distribution

wsl --export <Distribution Name> <FileName>

Exporterar en ögonblicksbild av den angivna distributionen som en ny distributionsfil. Standardvärdet är tar-format. Filnamnet kan vara - för standardindata. Alternativen är:

  • --vhd: Anger att exportdistributionen ska vara en .vhdx-fil i stället för en tar-fil (detta stöds endast med WSL 2)

Importera en distribution

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

Importerar den angivna tar-filen som en ny distribution. Filnamnet kan vara - för standardindata. Alternativen är:

  • --vhd: Anger att importdistributionen ska vara en .vhdx-fil i stället för en tar-fil (detta stöds endast med WSL 2)
  • --version <1/2>: Anger om distributionen ska importeras som en WSL 1- eller WSL 2-distribution

Importera en distribution på plats

wsl --import-in-place <Distribution Name> <FileName>

Importerar den angivna .vhdx-filen som en ny distribution. Den virtuella hårddisken måste formateras i filsystemtypen ext4.

Avregistrera eller avinstallera en Linux-distribution

Linux-distributioner kan installeras via Microsoft Store, men de kan inte avinstalleras via butiken.

Avregistrera och avinstallera en WSL-distribution:

wsl --unregister <DistributionName>

Om du ersätter <DistributionName> med namnet på din avsedda Linux-distribution avregistreras distributionen från WSL så att den kan installeras om eller rensas. Varning: När alla data, inställningar och programvara som är associerade med distributionen har avregistrerats kommer de att gå förlorade permanent. Genom att installera om från butiken installeras en ren kopia av distributionen. Till exempel skulle wsl --unregister Ubuntu ta bort Ubuntu från de distributioner som är tillgängliga i WSL. När du kör wsl --list visar det att den inte längre finns med på listan.

Du kan också avinstallera Linux-distributionsappen på din Windows-dator precis som andra store-program. Om du vill installera om letar du upp distributionen i Microsoft Store och väljer "Starta".

Montera en disk eller enhet

wsl --mount <DiskPath>

Koppla och montera en fysisk disk i alla WSL2-distributioner genom att ersätta <DiskPath> med sökvägen katalog\fil där disken finns. Se även Montera en Linux-disk i WSL 2. Alternativen är:

  • --vhd: Anger att <Disk> refererar till en virtuell hårddisk.
  • --name: Montera disken med ett anpassat namn för monteringspunkten
  • --bare: Anslut disken till WSL2, men montera den inte.
  • --type <Filesystem>: Filsystemtyp som ska användas när du monterar en disk, om den inte anges, är standardvärdet ext4. Det här kommandot kan också anges som: wsl --mount -t <Filesystem>. Du kan identifiera filsystemtypen med hjälp av kommandot: blkid <BlockDevice>, till exempel: blkid <dev/sdb1>.
  • --partition <Partition Number>: Indexnumret för partitionen som ska monteras, om inget anges antas vara hela disken.
  • --options <MountOptions>: Det finns vissa filsystemspecifika alternativ som kan ingå när du monterar en disk. Till exempel kan ext4 monteringsalternativ som: wsl --mount -o "data-ordered" eller wsl --mount -o "data=writeback. För närvarande stöds dock endast filsystemspecifika alternativ. Allmänna alternativ, till exempel ro, rweller noatime, stöds inte.

Not

Om du kör en 32-bitarsprocess för att få åtkomst till wsl.exe (ett 64-bitarsverktyg) kan du behöva köra kommandot på följande sätt: C:\Windows\Sysnative\wsl.exe --command.

Demontera diskar

wsl --unmount <DiskPath>

Om en disksökväg anges, demontera den specifika disken. Om ingen disksökväg anges, demonteras och kopplas alla monterade diskar bort.

Inaktuella WSL-kommandon

wslconfig.exe [Argument] [Options]

bash [Options]

lxrun /[Argument]

Dessa kommandon var den ursprungliga wsl-syntaxen för att konfigurera Linux-distributioner installerade med WSL, men har ersatts med kommandosyntaxen wsl eller wsl.exe.