Основные команды для WSL

Приведенные ниже команды WSL перечислены в формате, поддерживаемом PowerShell или командной строкой Windows. Чтобы выполнить эти команды из командной строки дистрибутива Bash или Linux, необходимо заменить wsl на wsl.exe. Для полного списка команд выполните wsl --help. Если вы еще не сделали этого, мы рекомендуем обновить версию WSL, установленную из Microsoft Store, чтобы получать обновления WSL сразу после их доступности. (Узнайте больше об установке WSL через Microsoft Store.).

Установить

wsl --install

Установите WSL и дистрибутив Linux Ubuntu по умолчанию. Дополнительные сведения. Эту команду можно также использовать для установки дополнительных дистрибутивов Linux, выполнив wsl --install <Distribution Name>. Для валидного списка названий дистрибутивов выполните wsl --list --online.

Варианты включают:

• --distribution. Укажите дистрибутив Linux для установки. Доступные дистрибутивы можно найти, выполнив wsl --list --online.
• --no-launch: установите дистрибутив Linux, но не запускайте его автоматически.
• --web-download: установите из интернет-источника, а не с помощью Microsoft Store.

Если WSL не установлен, рассмотрите следующие варианты:

• --inbox: устанавливает WSL с помощью компонента Windows вместо использования Microsoft Store. (обновления WSL будут получаться через обновления Windows, а не выпускаться сразу, как они становятся доступными в магазине).
• --enable-wsl1. Включает WSL 1 во время процесса установки версии WSL из магазина Microsoft Store, также активируя необязательный компонент "Подсистема Windows для Linux".
• --no-distribution. Не устанавливайте дистрибутив при установке WSL.

Список доступных дистрибутивов Linux

wsl --list --online

См. список дистрибутивов Linux, доступных через интернет-магазин. Эта команда также может быть введена следующим образом: wsl -l -o.

Список установленных дистрибутивов Linux

wsl --list --verbose

Ознакомьтесь со списком дистрибутивов Linux, установленных на компьютере Windows, включая состояние (запущено или остановлено) и версию WSL под управлением дистрибутива (WSL 1 или WSL 2). Сравнение WSL 1 и WSL 2. Эта команда также может быть введена следующим образом: wsl -l -v. Дополнительные параметры, которые можно использовать с командой списка, включают: --all для перечисления всех дистрибутивов, --running для перечисления только запущенных дистрибутивов или --quiet только для отображения имен рассылки.

Установите версию WSL на 1 или 2

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

Чтобы назначить версию WSL (1 или 2), в которую работает дистрибутив Linux, замените <distribution name> именем дистрибутива и замените <versionNumber> на 1 или 2. Сравнение WSL 1 и WSL 2. WSL 2 доступен только в Windows 11 или Windows 10 версии 1903, сборке 18362 или более поздней версии.

Установка версии WSL по умолчанию

wsl --set-default-version <Version>

Чтобы задать версию WSL 1 или WSL 2 по умолчанию, замените <Version> номером 1 или 2. Например, wsl --set-default-version 2. Номер представляет версию WSL по умолчанию для новых установок дистрибутива Linux. Сравнение WSL 1 и WSL 2. WSL 2 доступен только в Windows 11 или Windows 10 версии 1903, сборке 18362 или более поздней версии.

Установка дистрибутива Linux по умолчанию

wsl --set-default <Distribution Name>

Чтобы задать дистрибутив Linux по умолчанию, который будет использоваться для выполнения команд WSL, замените <Distribution Name> именем предпочтительного дистрибутива Linux.

Изменение каталога на домашний

wsl ~

~ можно использовать с wsl для запуска в домашнем каталоге пользователя. Чтобы перейти из любого каталога в домашний каталог в командной строке WSL, используйте команду: cd ~.

Запуск определенного дистрибутива Linux из PowerShell или CMD

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

Чтобы запустить определенный дистрибутив Linux с определенным пользователем, замените <Distribution Name> именем предпочтительного дистрибутива Linux (т. е. Debian) и <User Name> с именем существующего пользователя (т. е. root). Если пользователь не существует в дистрибутиве WSL, появится сообщение об ошибке. Чтобы распечатать текущее имя пользователя, используйте команду whoami.

Обновление WSL

wsl --update

Обновите версию WSL до последней версии. Варианты включают:

• --web-download. Скачайте последнее обновление из GitHub, а не в Microsoft Store.

Проверка состояния WSL

wsl --status

Ознакомьтесь с общей информацией о вашей конфигурации WSL, такой как тип распределения по умолчанию, дистрибутив по умолчанию и версия ядра.

Проверьте версию 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 --shutdown

Немедленно завершает все запущенные дистрибутивы и виртуальную машину упрощенной служебной программы WSL 2. Эта команда может потребоваться в случаях, когда требуется перезапуск среды виртуальной машины WSL 2, таких как изменения ограничений использования памяти или внесения изменений в файл .wslconfig.

Прекращать

wsl --terminate <Distribution Name>

Чтобы завершить указанное распределение или остановить его выполнение, замените <Distribution Name> именем целевого дистрибутива.

Определение IP-адреса

• wsl hostname -I. Возвращает IP-адрес дистрибутива Linux, установленный через WSL 2 (адрес виртуальной машины WSL 2)
• ip route show | grep -i default | awk '{ print $3}'. Возвращает IP-адрес компьютера Windows, как видно из WSL 2 (виртуальная машина WSL 2)

Более подробное описание см. в разделе Доступ к сетевым приложениям с помощью WSL: определение IP-адреса.

Экспорт дистрибутива

wsl --export <Distribution Name> <FileName>

Экспортирует моментальный снимок указанного распределения в новый файл распределения. По умолчанию используется формат tar. Имя файла может быть - для стандартных входных данных. Варианты включают:

• --vhd. Указывает, что распределение экспорта должно быть VHDX-файлом вместо tar-файла (это поддерживается только с помощью WSL 2).

Импорт дистрибутива

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

Импортирует указанный tar-файл в качестве нового дистрибутива. Имя файла может быть - для стандартных входных данных. Варианты включают:

• --vhd. Указывает распределение импорта должно быть VHDX-файлом вместо tar-файла (это поддерживается только с помощью 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 удалит Ubuntu из доступных в WSL дистрибутивов. Запуск wsl --list покажет, что он больше не указан.

Вы также можете удалить приложение распространения Linux на компьютере с Windows так же, как и любое другое приложение магазина. Чтобы переустановить, найдите дистрибутив в Microsoft Store и нажмите кнопку "Запустить".

Подключение диска или устройства

wsl --mount <DiskPath>

Присоедините и смонтируйте физический диск во всех дистрибутивах WSL2, заменив <DiskPath> на путь к каталогу или файлу, где находится диск. См. о том, как подключить диск Linux в WSL 2. Варианты включают:

• --vhd. Указывает, что <Disk> ссылается на виртуальный жесткий диск.
• --name. Подключение диска с помощью настраиваемого имени для точки подключения
• --bare: подключите диск к WSL2, но не монтируйте его.
• --type <Filesystem>: тип файловой системы, используемый при подключении диска; если тип не указан, по умолчанию используется ext4. Эта команда также может быть введена следующим образом: wsl --mount -t <Filesystem>. Тип файловой системы можно обнаружить с помощью команды: blkid <BlockDevice>, например, blkid <dev/sdb1>.
• --partition <Partition Number>: номер индекса раздела для монтирования, если не указан, по умолчанию используется весь диск.
• --options <MountOptions>. Существуют некоторые параметры файловой системы, которые можно включить при подключении диска. Например, параметры подключения ext4 например: wsl --mount -o "data-ordered" или wsl --mount -o "data=writeback. Однако в настоящее время поддерживаются только параметры, относящиеся к файловой системе. Универсальные параметры, такие как ro, rwили noatime, не поддерживаются.

Отключение дисков

wsl --unmount <DiskPath>

Отключите диск, указанный в пути к диску, если путь к диску не указан, эта команда отключит и отсоединит все подключенные диски.

Устаревшие команды WSL

wslconfig.exe [Argument] [Options]

bash [Options]

lxrun /[Argument]

Эти команды были исходным синтаксисом wsl для настройки дистрибутивов Linux, установленных с помощью WSL, но были заменены синтаксисом команды wsl или wsl.exe.