WSL의 기본 명령

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

설치

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: Microsoft Store 버전의 WSL을 설치하는 동안 "Linux용 Windows 하위 시스템" 선택적 구성 요소를 사용하도록 설정하여 WSL 1을 사용하도록 합니다.
  • --no-distribution: WSL을 설치할 때 배포를 설치하지 마세요.

사용 가능한 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, 배포판 이름만 표시하는 --quiet가 있습니다.

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 배포판의 이름으로 바꿉니다.

디렉터리를 홈으로 변경

wsl ~

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

PowerShell 또는 CMD에서 특정 Linux 배포판 실행

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

특정 사용자로 특정 Linux 배포판을 실행하려면 <Distribution Name>을 기본 Linux 배포판의 이름(즉, Debian)으로 바꾸고 <User Name>을 기존 사용자의 이름(예: 루트)으로 바꿉니다. 해당 사용자가 WSL 배포판에 없는 경우 오류가 발생합니다. 현재 사용자 이름을 출력하려면 whoami 명령을 사용합니다.

WSL 업데이트

wsl --update

WSL 버전을 최신 버전으로 업데이트합니다. 표시되는 옵션은 다음과 같습니다.

  • --web-download: Microsoft Store가 아닌 GitHub에서 최신 업데이트를 다운로드합니다.

WSL 상태 확인

wsl --status

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

WSL 버전 확인

wsl --version

WSL 및 해당 구성 요소에 대한 버전 정보를 확인합니다.

Help 명령

wsl --help

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

특정 사용자로 실행

wsl -u <Username>`, `wsl --user <Username>

WSL을 지정된 사용자로 실행하려면 <Username>를 WSL 배포에 있는 사용자의 이름으로 바꿉니다.

배포의 기본 사용자 변경

<DistributionName> config --default-user <Username>

배포 로그인에 대한 기본 사용자를 변경합니다. 사용자가 기본 사용자가 될 수 있도록 배포 내에 이미 있어야 합니다.

예를 들어 ubuntu config --default-user johndoe는 Ubuntu 배포에 대한 기본 사용자를 "johndoe" 사용자로 변경합니다.

참고

배포 이름을 확인하는 데 문제가 있는 경우 wsl -l 명령을 사용합니다.

경고

가져온 배포에는 실행 가능한 시작 관리자가 없기 때문에 이 명령은 작동하지 않습니다. 대신 /etc/wsl.conf 파일을 사용하여 가져온 배포의 기본 사용자를 변경할 수 있습니다. 고급 설정 구성 문서의 자동 탑재 옵션을 참조하세요.

Shutdown

wsl --shutdown

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

종료

wsl --terminate <Distribution Name>

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

배포 가져오기 및 내보내기

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

지정된 tar 파일을 새 배포로 가져오고 내보냅니다. 파일 이름은 표준 입력을 위한 것입니다. 표시되는 옵션은 다음과 같습니다.

  • --vhd: 가져오기/내보내기 배포 지정은 tar 파일이 아닌 .vhdx 파일이어야 합니다.
  • --version: 가져오기 전용의 경우, 배포를 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>

디스크 경로에 지정된 디스크를 분리합니다. 디스크 경로가 지정되지 않은 경우, 이 명령은 탑재된 모든 디스크를 장착 해제하여 분리합니다.

사용되지 않은 WSL 명령

wslconfig.exe [Argument] [Options]
bash [Options]
lxrun /[Argument]

이러한 명령은 WSL과 함께 설치된 Linux 배포판을 구성하는 원래 wsl 구문이지만 wsl 또는 wsl.exe 명령 구문으로 대체되었습니다.