Basisopdrachten voor WSL

De onderstaande WSL-opdrachten worden vermeld in een indeling die wordt ondersteund door PowerShell of Windows-opdrachtprompt. Als u deze opdrachten wilt uitvoeren vanaf een opdrachtregel voor Bash-/Linux-distributie, moet u wsl vervangen door wsl.exe. Voer wsl --helpuit voor een volledige lijst met opdrachten. Als u dit nog niet hebt gedaan, raden we u aan om bij te werken naar de versie van WSL die is geïnstalleerd vanuit de Microsoft Store om WSL-updates te ontvangen zodra deze beschikbaar zijn. (Meer informatie over het installeren van WSL via Microsoft Store.).

Installeren

wsl --install

Installeer WSL en de standaard Ubuntu-distributie van Linux. Meer informatie. U kunt deze opdracht ook gebruiken om extra Linux-distributies te installeren door wsl --install <Distribution Name>uit te voeren. Voer wsl --list --onlineuit voor een geldige lijst met distributienamen.

Opties zijn onder andere:

• --distribution: geef de Linux-distributie op die moet worden geïnstalleerd. U kunt beschikbare distributies vinden door wsl --list --onlineuit te voeren.
• --no-launch: Installeer de Linux-distributie, maar start deze niet automatisch.
• --web-download: Installeren vanuit een onlinebron in plaats van de Microsoft Store te gebruiken.
• --location: Geef op in welke map u de WSL-distributie wilt installeren.

Wanneer WSL niet is geïnstalleerd, zijn onder andere:

• --inbox: installeert WSL met behulp van het Windows-onderdeel in plaats van de Microsoft Store. (WSL-updates worden ontvangen via Windows-updates, in plaats van als beschikbaar te worden uitgerold via de Microsoft Store).
• --enable-wsl1: hiermee schakelt u WSL 1 in tijdens de installatie van de Microsoft Store-versie van WSL door ook het optionele onderdeel Windows-subsysteem voor Linux in te schakelen.
• --no-distribution: Installeer geen distributie bij de installatie van WSL.

Notitie

Als u WSL uitvoert op Windows 10 of een oudere versie, moet u mogelijk de -d vlag toevoegen met de opdracht --install om een distributie op te geven: wsl --install -d <distribution name>.

Beschikbare Linux-distributies weergeven

wsl --list --online

Bekijk een lijst met de Linux-distributies die beschikbaar zijn via de online winkel. Deze opdracht kan ook worden ingevoerd als: wsl -l -o.

Geïnstalleerde Linux-distributies vermelden

wsl --list --verbose

Bekijk een lijst met de Linux-distributies die op uw Windows-computer zijn geïnstalleerd, inclusief de status (of de distributie wordt uitgevoerd of gestopt) en de versie van WSL waarop de distributie wordt uitgevoerd (WSL 1 of WSL 2). WSL 1 en WSL 2 vergelijken. Deze opdracht kan ook worden ingevoerd als: wsl -l -v. Aanvullende opties die kunnen worden gebruikt met de lijstopdracht zijn onder andere: --all om alle distributies weer te geven, --running alleen distributies weer te geven die momenteel worden uitgevoerd of --quiet om alleen distributienamen weer te geven.

WSL-versie instellen op 1 of 2

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

Als u de versie van WSL (1 of 2) wilt aanwijzen waarop een Linux-distributie wordt uitgevoerd, vervangt u <distribution name> door de naam van de distributie en vervangt u <versionNumber> door 1 of 2. WSL 1 en WSL 2 vergelijken. WSL 2 is alleen beschikbaar in Windows 11 of Windows 10, versie 1903, build 18362 of hoger.

Waarschuwing

Schakelen tussen WSL 1 en WSL 2 kan tijdrovend zijn en leiden tot fouten vanwege de verschillen tussen de twee architecturen. Voor distributies met grote projecten raden we u aan een back-up te maken van bestanden voordat u een conversie uitvoert.

Standaardversie van WSL instellen

wsl --set-default-version <Version>

Als u een standaardversie van WSL 1 of WSL 2 wilt instellen, vervangt u <Version> door het getal 1 of 2. Bijvoorbeeld wsl --set-default-version 2. Het getal vertegenwoordigt de versie van WSL die standaard wordt gebruikt voor nieuwe Linux-distributie-installaties. WSL 1 en WSL 2 vergelijken. WSL 2 is alleen beschikbaar in Windows 11 of Windows 10, versie 1903, build 18362 of hoger.

Standaarddistributie voor Linux instellen

wsl --set-default <Distribution Name>

Als u de standaard Linux-distributie wilt instellen die WSL-opdrachten gebruiken om uit te voeren, vervangt u <Distribution Name> door de naam van de gewenste Linux-distributie.

WSL starten in de basismap van de gebruiker

wsl ~

De ~ kan worden gebruikt met wsl om te beginnen in de thuismap van de gebruiker. Als u vanuit een WSL-opdrachtprompt van elke map naar huis wilt springen, kunt u de volgende opdracht gebruiken: cd ~.

Een specifieke Linux-distributie uitvoeren vanuit PowerShell of CMD

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

Als u een specifieke Linux-distributie wilt uitvoeren met een specifieke gebruiker, vervangt u <Distribution Name> door de naam van de Linux-distributie van uw voorkeur (bijvoorbeeld. Debian) en <User Name> met de naam van een bestaande gebruiker (bijvoorbeeld root). Als de gebruiker niet bestaat in de WSL-distributie, krijgt u een foutmelding. Gebruik de opdracht whoamiom de huidige gebruikersnaam af te drukken.

WSL bijwerken

wsl --update

Werk uw WSL-versie bij naar de nieuwste versie. Opties zijn onder andere:

• --web-download: download de meest recente update vanuit GitHub in plaats van de Microsoft Store.

WSL-status controleren

wsl --status

Zie algemene informatie over uw WSL-configuratie, zoals standaarddistributietype, standaarddistributie en kernelversie.

WSL-versie controleren

wsl --version

Controleer de versie-informatie over WSL en de bijbehorende onderdelen.

Help-commando

wsl --help

Bekijk een lijst met opties en opdrachten die beschikbaar zijn voor WSL.

Als een specifieke gebruiker uitvoeren

wsl --user <Username>

Als u WSL wilt uitvoeren als een opgegeven gebruiker, vervangt u <Username> door de naam van een gebruiker die bestaat in de WSL-distributie.

De standaardgebruiker voor een distributie wijzigen

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

Wijzig de standaardgebruiker voor uw distributie-inlog. De gebruiker moet al bestaan in de distributie om de standaardgebruiker te worden.

Bijvoorbeeld: ubuntu config --default-user johndoe zou de standaardgebruiker voor de Ubuntu-distributie wijzigen in de gebruiker 'johndoe'.

Notitie

Als u problemen ondervindt bij het vaststellen van de naam van uw distributie, gebruikt u de opdracht wsl -l.

Waarschuwing

Deze opdracht werkt niet voor geïmporteerde distributies, omdat deze distributies geen uitvoerbaar startprogramma hebben. U kunt in plaats daarvan de standaardgebruiker voor geïmporteerde distributies wijzigen met behulp van het /etc/wsl.conf-bestand. Zie de opties voor automatisch koppelen in het -document geavanceerde instellingen configureren.

Afsluiten

wsl --shutdown

Hiermee beëindigt u onmiddellijk alle actieve distributies en de virtuele machine met het lichtgewicht WSL 2-hulpprogramma. Deze opdracht kan nodig zijn in instanties waarvoor u de omgeving van de virtuele WSL 2-machine opnieuw moet starten, zoals het wijzigen van geheugengebruikslimieten of het aanbrengen van een wijziging in uw .wslconfig-bestand.

Beëindigen

wsl --terminate <Distribution Name>

Als u de opgegeven distributie wilt beëindigen of wilt stoppen met uitvoeren, vervangt u <Distribution Name> door de naam van de doeldistributie.

IP-adres identificeren

• wsl hostname -I: retourneert het IP-adres van uw Linux-distributie die is geïnstalleerd via WSL 2 (het WSL 2 VM-adres)
• ip route show | grep -i default | awk '{ print $3}': retourneert het IP-adres van de Windows-machine, zoals te zien is vanuit WSL 2 (de WSL 2-VM)

Zie Toegang tot netwerktoepassingen met WSL: IP-adres identificerenvoor een gedetailleerdere uitleg.

Een distributie exporteren

wsl --export <Distribution Name> <FileName>

Hiermee exporteert u een momentopname van de opgegeven distributie als een nieuw distributiebestand. Standaard ingesteld op tar-indeling. De bestandsnaam kan worden - voor standaardinvoer. Opties zijn onder andere:

• --vhd: specificeert dat de exportdistributie een .vhdx-bestand moet zijn in plaats van een tar-bestand (dit wordt alleen ondersteund met WSL 2)

Een distributie importeren

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

Hiermee importeert u het opgegeven tar-bestand als een nieuwe distributie. De bestandsnaam kan worden - voor standaardinvoer. Opties zijn onder andere:

• --vhd: Geeft aan dat de importdistributie een .vhdx-bestand moet zijn in plaats van een tar-bestand (dit wordt alleen ondersteund door WSL 2)
• --version <1/2>: Hiermee geeft u op of de distributie moet worden geïmporteerd als een WSL 1- of WSL 2-distributie

Een distributie ter plaatse importeren

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

Hiermee importeert u het opgegeven VHDX-bestand als een nieuwe distributie. De virtuele harde schijf moet worden geformatteerd in het ext4-bestandssysteemtype.

Registratie van een Linux-distributie ongedaan maken of verwijderen

De registratie van een WSL-distributie ongedaan maken en verwijderen:

wsl --unregister <DistributionName>

Door <DistributionName> te vervangen door de naam van uw beoogde Linux-distributie, wordt die distributie uit WSL afgemeld, zodat deze opnieuw kan worden geïnstalleerd of opgeschoond. Waarschuwing: Zodra de registratie ongedaan is, gaan alle gegevens, instellingen en software die aan die distributie is gekoppeld, definitief verloren. Als u opnieuw installeert vanuit de store, wordt een schone kopie van de distributie geïnstalleerd. wsl --unregister Ubuntu bijvoorbeeld Ubuntu verwijderen uit de distributies die beschikbaar zijn in WSL. Als u wsl --list uitvoert, ziet u dat deze niet meer wordt vermeld.

U kunt de Linux-distributie-app ook op uw Windows-computer verwijderen, net als elke andere store-toepassing. Als u de distributie opnieuw wilt installeren, zoekt u de distributie in de Microsoft Store en selecteert u 'Starten'.

Een schijf of apparaat koppelen

wsl --mount <DiskPath>

Koppel en monteer een fysieke schijf in alle WSL2-distributies door <DiskPath> te vervangen door het directory/bestandspad waar de schijf zich bevindt. Zie Een Linux-schijf koppelen in WSL 2. Opties zijn onder andere:

• --vhd: geeft aan dat <Disk> verwijst naar een virtuele harde schijf.
• --name: koppel de schijf met een aangepaste naam voor het koppelpunt
• --bare: Koppel de schijf aan WSL2, maar mount deze niet.
• --type <Filesystem>: bestandssysteemtype dat moet worden gebruikt bij het koppelen van een schijf, indien niet opgegeven standaardwaarden voor ext4. Deze opdracht kan ook worden ingevoerd als: wsl --mount -t <Filesystem>. U kunt het bestandstype detecteren met behulp van de opdracht: blkid <BlockDevice>, bijvoorbeeld: blkid <dev/sdb1>.
• --partition <Partition Number>: indexnummer van de partitie die moet worden gekoppeld, indien niet opgegeven standaardwaarden voor de hele schijf.
• --options <MountOptions>: er zijn enkele bestandssysteemspecifieke opties die kunnen worden opgenomen bij het koppelen van een schijf. Bijvoorbeeld, ext4 koppelopties zoals: wsl --mount -o "data-ordered" of wsl --mount -o "data=writeback. Op dit moment worden echter alleen bestandssysteemspecifieke opties ondersteund. Algemene opties, zoals ro, rwof noatime, worden niet ondersteund.

Notitie

Als u een 32-bits proces uitvoert om toegang te krijgen tot wsl.exe (een 64-bits hulpprogramma), moet u de opdracht mogelijk op de volgende manier uitvoeren: C:\Windows\Sysnative\wsl.exe --command.

Schijven ontkoppelen

wsl --unmount <DiskPath>

Ontkoppel een schijf die is opgegeven bij het schijfpad. Als er geen schijfpad wordt gegeven, zal deze opdracht alle gekoppelde schijven ontkoppelen.

Verouderde WSL-opdrachten

wslconfig.exe [Argument] [Options]

bash [Options]

lxrun /[Argument]

Deze opdrachten waren de oorspronkelijke wsl-syntaxis voor het configureren van Linux-distributies die zijn geïnstalleerd met WSL, maar zijn vervangen door de wsl of wsl.exe opdrachtsyntaxis.