====== WSL2 コマンドリファレンス ======
 --- //[[http://www.y2sunlight.com|y2sunlight]] 2020-12-07//

[[wsl2:top|WSL2に戻る]]

関連記事

  * [[wsl2:install|WSL2 インストール]]
  * WSL2 コマンドリファレンス
  * [[wsl2:interop|WSL2 LinuxとのWindowsの相互運用性]]
  * [[wsl2:clone|WSL2 ディストリビューションの複製]]
  * [[wsl2:terminal|Windows ターミナル]]

リンク
   * [[https://docs.microsoft.com/en-us/windows/wsl/reference|Command Reference for Windows Subsystem for Linux]] --- Microsoftドキュメント

本章は[[https://docs.microsoft.com/en-us/windows/wsl/reference|Microsoftドキュメント]]の邦訳に注釈を加えたものです。

----

WSLと対話する最良の方法は、wsl.exeコマンドを使用することです。

===== WSL2をデフォルトバージョンとして設定する =====

Powershellで次のコマンドを実行して、新しいLinuxディストリビューションをインストールするときにWSL2をデフォルトバージョンとして設定します。

<code powershell>
wsl --set-default-version 2
</code>

\\

===== ディストリビューションのバージョンをWSL1またはWSL2に設定する =====

PowerShellコマンドラインを開いて次のコマンドを入力すると、インストールした各Linuxディストリビューションに割り当てられているWSLバージョンを確認できます。（ Windowsビルド19041以降でのみ使用可能： ''wsl -l -v'' ）

<code powershell>
wsl --list --verbose
</code>

実行例
<code powershell>
PS C:\> wsl --list --verbose
  NAME            STATE           VERSION
* Ubuntu-20.04    Running         2
</code>

ディストリビューションのバージョン(WSL1 またはWSL2)を設定するには、以下を実行してください：

<code powershell>
wsl --set-version <distribution name> <versionNumber>
</code>

''<distribution name>'' はディストリビューションの実際の名前に置き換え、''<versionNumber>'' は番号「1」または「2」に置き換えてください。上記と同じコマンドを実行し、「2」を「1」に置き換えることで、いつでもWSL1に戻すことができます。

さらに、WSL2をデフォルトのアーキテクチャにしたい場合は、次のコマンドを使用して行うことができます：

<code powershell>
wsl --set-default-version 2
</code>

これにより、インストールされた新しいディストリビューションのバージョンがWSL2に設定されます。

===== wsl.exe =====

以下は、Windowsバージョン1903以降の ''wsl.exe'' を使用する場合のすべてのオプションを含むリストです。

使用法：
<code powershell>
wsl [Argument] [Options...] [CommandLine]
</code>

\\

==== Linuxコマンドを実行する ====

  * 引数なし \\ コマンドラインが指定されていない場合、wsl.exe はデフォルトのシェルを起動します。

  * ''<nowiki>--</nowiki>exec <CommandLine>'', ''-e <CommandLine>'' \\ デフォルトのLinuxシェルを使用せずに、指定されたコマンドを実行します。

  * ''<nowiki>--</nowiki>'' \\ 残りのコマンドラインをそのまま渡します。

上記のコマンドは、次のオプションも受け入れます：

  * ''<nowiki>--</nowiki>distribution <Distro>'', ''-d <Distro>'' \\ 指定されたディストリビューションを実行します。

  * ''<nowiki>--</nowiki>user <UserName>'', ''-u <UserName>'' \\ 指定されたユーザーとして実行します。

\\

==== WSLを管理する ====

  * ''<nowiki>--</nowiki>export <Distro> <FileName>'' \\ ディストリビューションをtarファイルにエクスポートします。ファイル名は、標準出力の場合は ''-'' にすることができます。

  * ''<nowiki>--</nowiki>import <Distro> <InstallLocation> <FileName>'' \\ 指定されたtarファイルを新しいディストリビューションとしてインポートします。ファイル名は、標準入力の場合は ''-'' にすることができます。

  * ''<nowiki>--</nowiki>list [Options]'', ''-l [Options]'' \\ ディストリビューションをリストします. \\ Options:
    * ''<nowiki>--</nowiki>all'' \\ 現在インストールまたはアンインストールされているディストリビューションを含む、すべてのディストリビューションを一覧表示します。
    * ''<nowiki>--</nowiki>running'' \\ 現在実行中のディストリビューションのみを一覧表示します。
    * ''<nowiki>--</nowiki>quit'', ''<nowiki>-</nowiki>q'' \\ ディストリビューション名のみを表示します。
    * ''<nowiki>--</nowiki>verbose'', ''<nowiki>-</nowiki>v'' \\ すべてのディストリビューションについての詳細情報を表示します。

  * ''<nowiki>--</nowiki>set-default <Distro>'', ''-s <Distro>'' \\ デフォルトのディストリビューションを設定します。

  * ''<nowiki>--</nowiki>terminate <Distro>'', ''-t <Distro>'' \\ 指定されたディストリビューションを終了します。 

  * ''<nowiki>--</nowiki>shutdown'' \\ 実行中のすべてのディストリビューションとWSL2ライトウェイト ユーティリティ仮想マシンを直ちに終了します。

  * ''<nowiki>--</nowiki>unregister <Distro>'' \\ ディストリビューションの登録を解除します。 

  * ''<nowiki>--</nowiki>help'' 使い方を表示します。

\\

===== 追加のコマンド =====

WSLと対話するための歴史的なコマンドもあります。それらの機能は wsl.exe に含まれていますが、引き続き使用できます。

==== wslconfig.exe ====

このコマンドを使用すると、WSLディストリビューションを構成できます。以下はそのオプションのリストです。

使用法：
<code powershell>
wslconfig [Argument] [Options...]
</code>

=== 引数 ===

  * ''/l [Options]'', ''/list [Options]'' \\ 登録済みのディストリビューションを一覧表示します。

Options:

  * ''/all'' \\ オプションで、現在インストールまたはアンインストールされているディストリビューションを含む、すべてのディストリビューションを一覧表示します。

  * ''/running'' \\ 現在実行中のディストリビューションのみを一覧表示します。

  * ''/s <Distro>'', ''/setdefault <Distro>'' \\ デフォルトのディストリビューションを設定します。

  * ''/t <Distro>'', ''/terminate <Distro>'' \\ ディストリビューションを終了します。

  * ''/u <Distro>'', ''/unregister <Distro>'' \\ ディストリビューションの登録を解除します。

  * ''/upgrade <Distro>'' \\ ディストリビューションをWslFsファイルシステム形式にアップグレードします。

\\

==== bash.exe ====

このコマンドは、bash シェルを開始するために使用されます。 以下は、このコマンドで使用できるオプションです。

使用法：
<code powershell>
bash [Options...]
</code>

  * オプションなし \\ 現在のディレクトリでBashシェルを起動します。Bashシェルがインストールされていない場合、自動的に ''lxrun /install''が実行されます。(''lxrun /install'' は Windows 10 1803 以降では非推奨になっているWSLのダウンロードとインストール処理を行うコマンドです)

  * ''~'' \\ ''bash ~'' はユーザーのホームディレクトリの中で bash シェルをに起動します。'' cd〜 '' の実行に似ています。

  * ''<nowiki>-c "<command>"</nowiki>'' \\ コマンドを実行し、出力をプリントして、Windowsコマンドプロンプトに戻ります。 \\ 例： ''<nowiki>bash -c "ls"</nowiki>''

\\