主要コマンド
wsl コマンド(wsl.exe)で管理します。多くの引数に短縮形があります。以下は Windows 側(PowerShell / cmd)での実行です。
| コマンド / 引数 | 説明 |
|---|---|
| wsl --list --verbose (-l -v) | 導入済みディストリと状態・WSLバージョンを表示 |
| wsl --list --online (-l -o) | 導入可能なディストリの一覧を表示 |
| wsl --list --running | 実行中のディストリのみ表示 |
| wsl --list --quiet (-q) | 名前のみ簡潔に表示 |
| wsl --status | 既定ディストリ・既定バージョン・カーネル等の状態を表示 |
| wsl --version | WSL/カーネル/WSLg 等コンポーネントのバージョンを表示 |
| wsl --help | コマンド・引数のヘルプを表示 |
# 導入済みディストリと WSL バージョン・状態を確認(まずこれで現状把握) wsl -l -v # NAME STATE VERSION # * Ubuntu-24.04 Running 2 (* は既定ディストリ)
| コマンド / 引数 | 説明 |
|---|---|
| wsl | 既定ディストリを起動(シェルに入る) |
| wsl -d, --distribution <名前> | 指定ディストリを起動 |
| wsl -u, --user <ユーザー> | 指定ユーザーで起動(例: root) |
| wsl --cd <パス> | 起動時の作業ディレクトリを指定(~ でホーム) |
| wsl -e, --exec <コマンド> | 既定シェルを介さずコマンドを実行 |
| wsl -- <コマンド> | 以降を Linux コマンドとして実行 |
| wsl --system | システムディストロ(管理用)でコマンド実行 |
# 既定ディストリのシェルに入る wsl # 指定ディストリに root で入り、ホームを作業ディレクトリにする wsl -d Ubuntu-24.04 -u root --cd ~ # シェルに入らず1コマンドだけ実行して結果を Windows 側へ返す wsl -- uname -a # -- 以降を Linux コマンドとして実行 wsl -d Ubuntu-24.04 -- lsb_release -a
| コマンド / 引数 | 説明 |
|---|---|
| wsl --set-default, -s <名前> | 既定のディストリを設定 |
| wsl --set-default-version <1|2> | 新規導入時の既定 WSL バージョンを設定 |
| wsl --set-version <名前> <1|2> | 指定ディストリを WSL1/2 に変換 |
| wsl --terminate, -t <名前> | 指定ディストリを停止 |
| wsl --shutdown | 全ディストリと WSL2 仮想マシンを停止 |
# 新規導入の既定を WSL2 に(通常は既定で 2) wsl --set-default-version 2 # 既存ディストリを WSL1 → WSL2 へ変換(時間がかかる場合あり) wsl --set-version Ubuntu-24.04 2 # 既定ディストリを変更 wsl -s Ubuntu-24.04 # 設定変更やフリーズ時に全停止(VMごと落とす。次回起動で再作成) wsl --shutdown
| コマンド / 引数 | 説明 |
|---|---|
| wsl --export <名前> <file.tar> | ディストリを tar に書き出し(--vhd で .vhdx 形式) |
| wsl --import <名前> <格納先> <file.tar> | tar からディストリを登録(復元・複製) |
| wsl --import-in-place <名前> <file.vhdx> | 既存 .vhdx をその場で登録 |
| wsl --unregister <名前> | ディストリを削除(登録解除。データも消去) |
| wsl --manage <名前> --set-default-user <user> | 既定ユーザー変更等の管理操作 |
# 丸ごとバックアップ(tar に書き出し) wsl --export Ubuntu-24.04 D:\backup\ubuntu2404.tar # 別名で複製して検証用環境を作る(格納先フォルダは自動作成) wsl --import Ubuntu-work D:\wsl\work D:\backup\ubuntu2404.tar # 不要になったディストリを削除(.vhdx もろとも消える=取り消し不可) wsl --unregister Ubuntu-work
| コマンド / 引数 | 説明 |
|---|---|
| wsl --mount <デバイス> | 物理ディスク/VHD を WSL2 にマウント(--vhd / --bare / -p <partition>) |
| wsl --unmount [<デバイス>] | マウント解除(省略時は全て) |
# 物理ディスクを WSL2 にマウントして Linux 側から読む(PHYSICALDRIVE 番号は管理ツールで確認) wsl --mount \\.\PHYSICALDRIVE2 -p 1 # -p でパーティション番号を指定 wsl --unmount \\.\PHYSICALDRIVE2 # 使い終わったら解除
# root で apt を更新(-- 以降が Linux コマンド。&& で連結) wsl -d Ubuntu-24.04 -u root -- apt update && apt -y upgrade # ログインシェルで1行実行(-lc でログイン環境を読み込んで実行) wsl --cd ~ -e bash -lc "uname -a"