WSL のコマンド リファレンス

以下の基本的な WSL コマンドは、PowerShell または Windows コマンド プロンプトによってサポートされる形式で示されています。 Bash または Linux ディストリビューションのコマンド ラインからこれらのコマンドを実行する場合は、wslwsl.exe に置き換える必要があります。

基本的なコマンド

以下の基本的なコマンドは、WSL のインストール後にサポートされます。

[インストール]

wsl --install

WSL と Linux の Ubuntu ディストリビューションをインストールします。 詳細については、こちらを参照してください

特定の Linux ディストリビューションをインストールする

wsl --install --distribution <Distribution Name>

既定値 (Ubuntu) 以外にインストールする Linux のディストリビューションを、<Distribution Name> をそのディストリビューションの名前に置き換えることで指定します。 このコマンドは、「wsl -d <Distribution Name>」と入力することもできます。

使用可能な Linux ディストリビューションを一覧表示する

wsl --list --online

オンライン ストアから利用できる Linux ディストリビューションの一覧を確認します。 このコマンドは、「wsl -l -o」と入力することもできます。

インストールされている Linux ディストリビューションを一覧表示する

wsl --list --verbose

Windows コンピューターにインストールされている Linux ディストリビューションの一覧を確認します。これには、状態 (ディストリビューションは実行中か停止中か) と、ディストリビューションを実行している WSL のバージョン (WSL 1 または WSL 2) が含まれます。 WSL 1 と WSL 2 の比較。 このコマンドは、「wsl -l -v」と入力することもできます。 list コマンドで使用できるその他のオプションには、次のようなものがあります。--all: すべてのディストリビューションを一覧表示します。--running: 現在実行中のディストリビューションのみを一覧表示します。--quite: ディストリビューション名のみを表示します。

WSL バージョンを 1 または 2 に設定する

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

ある Linux ディストリビューションを実行する WSL のバージョン (1 または 2) を指定するには、<distribution name> をそのディストリビューションの名前に置き換え、<versionNumber> を 1 または 2 に置き換えてください。 WSL 1 と WSL 2 の比較

既定の WSL バージョンを設定する

wsl --set-default-version <Version>

既定のバージョンを WSL 1 または WSL 2 に設定するには、<Version> を数字 1 または 2 に置き換え、新しい Linux ディストリビューションのインストールに対してどのバージョンの WSL をインストールの既定値にするかを表します。 たとえば、「 wsl --set-default-version 2 」のように入力します。 WSL 1 と WSL 2 の比較

既定の Linux ディストリビューションを設定する

wsl --set-default <Distribution Name>

WSL コマンドの実行に使用される既定の Linux ディストリビューションを設定するには、<Distribution Name> を優先する Linux ディストリビューションの名前に置き換えてください。

PowerShell または CMD から特定の Linux ディストリビューションを実行する

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

特定のユーザーで特定の Linux ディストリビューションを実行するには、<Distribution Name> を優先する Linux ディストリビューションの名前 (例: Debian) に置き換え、<User Name> を既存のユーザーの名前 (例: root) に置き換えてください。 WSL ディストリビューションにそのユーザーが存在しない場合は、エラーが発生します。 現在のユーザー名を出力するには、whoami コマンドを使用します。

WSL を更新する

wsl --update

WSL Linux カーネルのバージョンを手動で更新します。 コマンド wsl --update rollback を使用して、以前のバージョンの WSL Linux カーネルにロールバックすることもできます。

WSL の状態を確認する

wsl --status

既定のディストリビューションの種類、既定のディストリビューション、カーネル バージョンなど、WSL 構成に関する一般的な情報を確認します。

ヘルプ コマンド

wsl --help

WSL で使用できるオプションとコマンドの一覧を確認します。

ホーム ディレクトリ

wsl ~

~ を wsl と一緒に使用して、ユーザーのホーム ディレクトリから開始できます。 WSL コマンド プロンプト内で任意のディレクトリからホームに戻る場合は、cd ~ コマンドを使用できます。

シャットダウン

wsl --shutdown

実行中のすべてのディストリビューションと WSL 2 の軽量ユーティリティ仮想マシンを直ちに終了します。 このコマンドは、メモリの使用制限を変更する場合や .wslconfig ファイルを変更する場合など、WSL 2 仮想マシン環境の再起動が求められる場合に必要となることがあります。

Terminate

wsl --terminate <Distribution Name>

指定したディストリビューションを終了するか、実行を停止するには、<Distribution Name> を対象のディストリビューションの名前に置き換えます。

ディストリビューションを TAR ファイルにエクスポートする

wsl --export <Distribution Name> <FileName>

ディストリビューションを tar ファイルにエクスポートします。 標準出力の場合、ファイル名は - でもかまいません。

新しいディストリビューションをインポートする

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

指定した tar ファイルを新しいディストリビューションとしてインポートします。 標準入力の場合、ファイル名は - でもかまいません。 --version オプションをこのコマンドと共に使用して、インポートされたディストリビューションを WSL 1 で実行するか WSL 2 で実行するかを指定することもできます。

Linux ディストリビューションの登録解除またはアンインストール

wsl --unregister <Distribution Name>

<Distribution Name> を対象のディストリビューションの名前に置き換えて、特定のディストリビューションを登録解除またはアンインストールします。 これにより、WSL からそのディストリビューションが削除され、関連付けられているすべてのデータが削除されます。 また、他のストア アプリケーションと同様に、Windowsコンピューターで Linux ディストリビューション アプリをアンインストールすることもできます。

ディスクまたはデバイスをマウントする

wsl --mount <DiskPath>

<DiskPath> をディスクが配置されているディレクトリまたはファイル パスに置き換え、すべての WSL2 ディストリビューションに物理ディスクを接続してマウントします。 WSL 2 での Linux ディスクのマウントに関する記事を参照してください。 次のオプションがあります。

  • wsl --mount --bare: WSL2 にディスクを接続しますが、マウントはしません。
  • wsl --mount --type <Filesystem>: ディスクのマウント時に使用するファイル システムの種類。指定しない場合、既定値は ext4 になります。 このコマンドは、「wsl --mount -t <Filesystem>」と入力することもできます。ファイル システムの種類は blkid <BlockDevice> コマンドを使用して検出できます (例: blkid <dev/sdb1>)。
  • wsl --mount --partition <Partition Number>: マウントするパーティションのインデックス番号。指定しない場合、既定値はディスク全体になります。
  • wsl --mount --options <MountOptions>: ディスクをマウントする際に、ファイル システム固有のオプションをいくつか含めることができます。 たとえば、wsl --mount -o "data=writeback などの ext4 マウント オプションです。 ただし、現時点では、ファイル システム固有のオプションだけがサポートされています。 rorwnoatime などの汎用オプションはサポートされていません。
  • wsl --unmount <DiskPath>: すべての WSL 2 ディストリビューションからディスクをマウント解除してデタッチします。 <DiskPath> を含めない場合は、このコマンドを実行すると、マウントされているすべてのディスクをマウント解除してデタッチします。

Note

wsl.exe (64 ビット ツール) にアクセスするために 32 ビット プロセスを実行している場合は、次の方法でコマンドを実行することが必要になる場合があります: C:\Windows\Sysnative\wsl.exe --command

非推奨の WSL コマンド

wslconfig.exe [Argument] [Options]
bash [Options]
lxrun /[Argument]

これらのコマンドは、WSL でインストールされた Linux ディストリビューションを構成するための元々の wsl 構文でしたが、wsl または wsl.exe コマンド構文に置き換えられました。