WSL의 명령 참고자료

아래의 기본 WSL 명령은 PowerShell 또는 Windows 명령 프롬프트에서 지원하는 형식으로 나열되어 있습니다. Bash/Linux 배포 명령줄에서 이러한 명령을 실행하려면 wslwsl.exe로 바꿔야 합니다.

기본 명령

다음은 WSL을 설치한 후 지원되는 기본 명령입니다.

설치

wsl --install

WSL 및 Linux의 Ubuntu 배포판을 설치합니다. 자세히 알아보기.

특정 Linux 배포판 설치

wsl --install --distribution <Distribution Name>

<Distribution Name>을 배포판 이름으로 바꿔서 기본 배포판(Ubuntu) 외에 설치할 Linux 배포판을 지정합니다. 이 명령은 wsl -d <Distribution Name>으로 입력할 수도 있습니다.

사용 가능한 Linux 배포판 나열

wsl --list --online

온라인 스토어를 통해 받을 수 있는 Linux 배포판 목록을 참조하세요. 이 명령은 wsl -l -o으로 입력할 수도 있습니다.

설치된 Linux 배포판 나열

wsl --list --verbose

상태(배포판이 실행 중인지 또는 중지되었는지 여부) 및 배포판을 실행하는 WSL 버전(WSL 1 또는 WSL 2)을 포함하여 Windows 머신에 설치된 Linux 배포 목록을 참조하세요. 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>를 기존 사용자의 이름(예: 루트)으로 바꿉니다. 해당 사용자가 WSL 배포판에 없는 경우 오류가 발생합니다. 현재 사용자 이름을 출력하려면 whoami 명령을 사용합니다.

WSL 업데이트

wsl --update

WSL Linux 커널 버전을 수동으로 업데이트합니다. wsl --update rollback 명령을 사용하여 이전 버전의 WSL Linux 커널로 롤백할 수도 있습니다.

WSL 상태 확인

wsl --status

기본 배포판 유형, 기본 배포판 및 커널 버전과 같은 WSL 구성에 대한 일반 정보를 참조하세요.

Help 명령

wsl --help

WSL에서 사용할 수 있는 옵션 및 명령 목록을 참조하세요.

홈 디렉터리

wsl ~

~는 wsl과 함께 사용하여 사용자의 홈 디렉터리에서 시작할 수 있습니다. WSL 명령 프롬프트 내 디렉터리에서 홈으로 다시 이동하기 위해 cd ~ 명령을 사용할 수 있습니다.

Shutdown

wsl --shutdown

실행 중인 모든 배포판과 WSL 2 경량 유틸리티 가상 머신을 즉시 종료합니다. 이 명령은 메모리 사용 제한 변경 또는 .wslconfig 파일 변경처럼 WSL 2 가상 머신 환경을 다시 시작해야 하는 인스턴스에서 필요할 수 있습니다.

종료

wsl --terminate <Distribution Name>

지정된 배포판을 종료하거나 실행을 중지하려면 <Distribution Name>을 대상 배포판의 이름으로 바꿉니다.

배포판을 TAR 파일로 내보내기

wsl --export <Distribution Name> <FileName>

배포를 tar 파일로 내보냅니다. 파일 이름은 표준 출력을 위한 것입니다.

새 배포판 가져오기

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

지정된 tar 파일을 새 배포로 가져옵니다. 파일 이름은 표준 입력을 위한 것입니다. 가져온 배포판을 WSL 1에서 실행할 것인지 아니면 WSL 2에서 실행할 것인지 지정하려면 이 명령에서 --version 옵션을 사용합니다.

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 탑재 옵션을 예로 들 수 있습니다. 그러나 현재는 파일 시스템 관련 옵션만 지원됩니다. ro, rw 또는 noatime과 같은 일반 옵션은 지원되지 않습니다.
  • wsl --unmount <DiskPath>: 모든 WSL 2 배포판에서 디스크를 탑재 해제하고 분리합니다. <DiskPath>가 포함되지 않으면 이 명령은 탑재된 모든 디스크를 탑재 해제하고 분리합니다.

참고

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 명령 구문으로 대체되었습니다.