WSL の基本的なコマンド
- [アーティクル]
-
-
下の WSL コマンドは、PowerShell または Windows コマンド プロンプトによってサポートされる形式で示されています。 Bash または Linux ディストリビューションのコマンド ラインからこれらのコマンドを実行する場合は、wsl
を wsl.exe
に置き換える必要があります。 コマンドの全一覧を表示するには、wsl --help
を実行します。 WSL の更新プログラムが利用可能になったらすぐに受け取るため、まだ行っていない場合は、Microsoft Store からインストールされる WSL のバージョンに更新することをお勧めします。 (Microsoft Store からの WSL のインストールの詳細を確認してください)。
wsl --install
WSL と Linux の既定の Ubuntu ディストリビューションをインストールします。 詳細については、こちらを参照してください。 このコマンドを使用して、wsl --install <Distribution Name>
を実行して追加の Linux ディストリビューションをインストールすることもできます。 ディストリビューション名の有効な一覧については、wsl --list --online
を実行します。
次のオプションがあります。
--distribution
: インストールする Linux ディストリビューションを指定します。 wsl --list --online
を実行すると、使用可能なディストリビューションを見つけることができます。
--no-launch
: Linux ディストリビューションをインストールしますが、自動的には起動しません。
--web-download
: Microsoft Store を使用するのではなく、オンライン ソースからインストールします。
WSL がインストールされていない場合は、次のオプションがあります。
--inbox
: Microsoft Store を使用する代わりに、Windows コンポーネントを使用して WSL をインストールします。 "(WSL 更新プログラムは、ストア経由で利用可能としてプッシュされるのではなく、Windows 更新プログラムを介して受信されます)。"
--enable-wsl1
: WSL 用の Microsoft Store バージョンのインストール中に、"Linux 用 Windows サブシステム" オプション コンポーネントも有効にすることで、WSL 1 を有効にします。
--no-distribution
: WSL のインストール時にディストリビューションをインストールしません。
注意
Windows 10 またはそれ以前のバージョンで WSL を実行している場合は、-d
フラグを --install
コマンドに含めて、ディストリビューション wsl --install -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
: 現在実行中のディストリビューションのみを一覧表示します。--quiet
: ディストリビューション名のみを表示します。
wsl --set-version <distribution name> <versionNumber>
ある Linux ディストリビューションを実行する WSL のバージョン (1 または 2) を指定するには、<distribution name>
をそのディストリビューションの名前に置き換え、<versionNumber>
を 1 または 2 に置き換えてください。 WSL 1 と WSL 2 の比較。 WSL 2 は、Windows 11または Windows 10 (バージョン 1903、ビルド 18362 以降) でのみ使用できます。
警告
WSL 1 と WSL 2 の切り替えは時間がかかり、2 つのアーキテクチャの違いにより失敗する可能性があります。 大きなプロジェクトを含むディストリビューションの場合は、変換を試みる前にファイルをバックアップすることをお勧めします。
wsl --set-default-version <Version>
WSL 1 または WSL 2 の既定のバージョンを設定するには、<Version>
を数値 1 または 2 に置き換えます。 たとえば、wsl --set-default-version 2
のようにします。 この数値は、新しい Linux ディストリビューションをインストールするときに既定値となる WSL のバージョンを表します。 WSL 1 と WSL 2 の比較。 WSL 2 は、Windows 11または Windows 10 (バージョン 1903、ビルド 18362 以降) でのみ使用できます。
既定の Linux ディストリビューションを設定する
wsl --set-default <Distribution Name>
WSL コマンドの実行に使用される既定の Linux ディストリビューションを設定するには、<Distribution Name>
を優先する Linux ディストリビューションの名前に置き換えてください。
wsl ~
~
を wsl と一緒に使用して、ユーザーのホーム ディレクトリから開始できます。 WSL コマンド プロンプト内で任意のディレクトリからホームに戻る場合は、cd ~
コマンドを使用できます。
PowerShell または CMD から特定の Linux ディストリビューションを実行する
wsl --distribution <Distribution Name> --user <User Name>
特定のユーザーで特定の Linux ディストリビューションを実行するには、<Distribution Name>
を優先する Linux ディストリビューションの名前 (例: Debian) に置き換え、<User Name>
を既存のユーザーの名前 (例: root) に置き換えてください。 WSL ディストリビューションにそのユーザーが存在しない場合は、エラーが発生します。 現在のユーザー名を出力するには、whoami
コマンドを使用します。
wsl --update
WSL バージョンを最新バージョンに更新します。 次のオプションがあります。
--web-download
: Microsoft Store ではなく、GitHub から最新の更新プログラムをダウンロードします。
wsl --status
既定のディストリビューションの種類、既定のディストリビューション、カーネル バージョンなど、WSL 構成に関する一般的な情報を確認します。
wsl --version
WSL とそのコンポーネントに関するバージョン情報を確認します。
wsl --help
WSL で使用できるオプションとコマンドの一覧を確認します。
wsl --user <Username>
特定のユーザーとして WSL を実行するには、<Username>
を、WSL ディストリビューションに存在するユーザーの名前に置き換えます。
<DistributionName> config --default-user <Username>
ディストリビューションのログインに対する既定のユーザーを変更します。 既定のユーザーになるには、ユーザーが既にディストリビューション内に存在している必要があります。
たとえば、「ubuntu config --default-user johndoe
」と入力すると、Ubuntu ディストリビューションの既定のユーザーが、"johndoe" ユーザーに変更されます。
注意
ディストリビューションの名前がわからない場合は、wsl -l
コマンドを使用してください。
警告
これらのディストリビューションには実行可能ランチャーがないため、インポートされたディストリビューションではこのコマンドは機能しません。 代わりに、/etc/wsl.conf
を使用して、インポートされたディストリビューションの既定のユーザーを変更できます。 詳細設定の構成に関するドキュメントの「自動マウント オプション」を参照してください。
wsl --shutdown
実行中のすべてのディストリビューションと WSL 2 の軽量ユーティリティ仮想マシンを直ちに終了します。 このコマンドは、メモリの使用制限を変更する場合や .wslconfig ファイルを変更する場合など、WSL 2 仮想マシン環境の再起動が求められる場合に必要となることがあります。
wsl --terminate <Distribution Name>
指定したディストリビューションを終了するか、実行を停止するには、<Distribution Name>
を対象のディストリビューションの名前に置き換えます。
wsl hostname -I
: WSL 2 経由でインストールされた Linux ディストリビューションの IP アドレスを返します (WSL 2 VM アドレス)
ip route show | grep -i default | awk '{ print $3}'
: WSL 2 視点での、Windows マシンの IP アドレスを返します (WSL 2 VM)
詳細な説明については、「WSL を使用したネットワーク アプリケーションへのアクセス: IP アドレスを特定する」を参照してください。
wsl --export <Distribution Name> <FileName>
新しいディストリビューション ファイルとして指定したディストリビューションのスナップショットをエクスポートします。 既定値は tar 形式です。 標準入力の場合、ファイル名は -
でもかまいません。 次のオプションがあります。
--vhd
: ディストリビューションのエクスポートを、tar ファイルではなく .vhdx ファイルで行うように指定します (これは WSL 2 の使用時にのみサポートされます)
wsl --import <Distribution Name> <InstallLocation> <FileName>
指定した tar ファイルを新しいディストリビューションとしてインポートします。 標準入力の場合、ファイル名は -
でもかまいません。 次のオプションがあります。
--vhd
: ディストリビューションのインポートを、tar ファイルではなく .vhdx ファイルで行うように指定します (これは WSL 2 の使用時にのみサポートされます)
--version <1/2>
: ディストリビューションを WSL 1 と WSL 2 ディストリビューションのどちらとしてインポートするかを指定します
ディストリビューションをインプレースでインポートする
wsl --import-in-place <Distribution Name> <FileName>
指定した .vhdx ファイルを新しいディストリビューションとしてインポートします。 仮想ハード ディスクは、ext4 ファイルシステムの種類でフォーマットする必要があります。
Linux ディストリビューションの登録解除またはアンインストール
Linux ディストリビューションは Microsoft Store を介してインストールできますが、ストアを介してアンインストールすることはできません。
WSL ディストリビューションの登録を解除してアンインストールするには:
wsl --unregister <DistributionName>
<DistributionName>
を対象の Linux ディストリビューションの名前に置き換えると、WSL からそのディストリビューションの登録が解除され、再インストールまたはクリーンアップできます。 注意: 登録が解除されると、そのディストリビューションに関連付けられているすべてのデータ、設定、およびソフトウェアが完全に失われます。 ストアから再インストールすると、ディストリビューションのクリーン コピーがインストールされます。 たとえば、wsl --unregister Ubuntu
の場合、WSL で使用可能なディストリビューションから Ubuntu が削除されます。 wsl --list
を実行すると、一覧に表示されなくなっていることがわかります。
また、他のストア アプリケーションと同様に、Windowsコンピューターで Linux ディストリビューション アプリをアンインストールすることもできます。 再インストールするには、Microsoft Store でディストリビューションを見つけて、[起動] を選びます。
wsl --mount <DiskPath>
<DiskPath>
をディスクが配置されているディレクトリまたはファイル パスに置き換え、すべての WSL2 ディストリビューションに物理ディスクを接続してマウントします。 WSL 2 での Linux ディスクのマウントに関する記事を参照してください。 次のオプションがあります。
--vhd
: <Disk>
は仮想ハード ディスクを参照することを指定します。
--name
: マウントポイントのカスタム名を使用してディスクをマウントします
--bare
: WSL2 にディスクを接続しますが、マウントはしません。
--type <Filesystem>
: ディスクのマウント時に使用するファイル システムの種類。指定しない場合、既定値は ext4 になります。 このコマンドは、「wsl --mount -t <Filesystem>
」と入力することもできます。ファイル システムの種類は blkid <BlockDevice>
コマンドを使用して検出できます (例: blkid <dev/sdb1>
)。
--partition <Partition Number>
: マウントするパーティションのインデックス番号。指定しない場合、既定値はディスク全体になります。
--options <MountOptions>
: ディスクをマウントする際に、ファイル システム固有のオプションをいくつか含めることができます。 たとえば、wsl --mount -o "data-ordered"
や wsl --mount -o "data=writeback
などの ext4 マウント オプションです。 ただし、現時点では、ファイル システム固有のオプションだけがサポートされています。 ro
、rw
、noatime
などの汎用オプションはサポートされていません。
注意
wsl.exe (64 ビット ツール) にアクセスするために 32 ビット プロセスを実行している場合は、次の方法でコマンドを実行することが必要になる場合があります: C:\Windows\Sysnative\wsl.exe --command
。
wsl --unmount <DiskPath>
ディスク パスで指定されたディスクのマウントを解除します。ディスク パスが指定されていない場合、このコマンドはマウントされているすべてのディスクのマウントを解除してデタッチします。
wslconfig.exe [Argument] [Options]
bash [Options]
lxrun /[Argument]
これらのコマンドは、WSL でインストールされた Linux ディストリビューションを構成するための元々の wsl 構文でしたが、wsl
または wsl.exe
コマンド構文に置き換えられました。