WSL의 기본 명령

아래의 WSL 명령은 PowerShell 또는 Windows 명령 프롬프트에서 지원하는 형식으로 나열되어 있습니다. Bash/Linux 배포 명령줄에서 이러한 명령을 실행하려면 wsl을 wsl.exe로 바꿔야 합니다. 전체 명령 목록을 보려면 wsl --help를 실행합니다. 아직 업데이트하지 않은 경우 사용 가능한 즉시 WSL 업데이트를 받으려면 Microsoft Store에서 설치된 WSL 버전으로 업데이트하는 것이 좋습니다. (Microsoft Store를 통해 WSL을 설치하는 방법에 대해 자세히 알아보세요.)

설치

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을 설치할 때 배포를 설치하지 마세요.

참고 항목

Windows 10 또는 이전 버전에서 WSL을 실행하는 경우 배포wsl --install -d <distribution name>를 지정하는 명령에 플래그를 --install 포함 -d 해야 할 수 있습니다.

사용 가능한 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 2는 Windows 11 또는 Windows 10, 버전 1903, 빌드 18362 이상에서만 사용할 수 있습니다.

Warning

WSL 1과 WSL 2 간의 전환은 시간이 오래 걸릴 수 있으며 두 아키텍처 간의 차이로 인해 오류가 발생할 수 있습니다. 대규모 프로젝트가 있는 배포의 경우 변환을 시도하기 전에 파일을 백업하는 것이 좋습니다.

기본 WSL 버전 설정

wsl --set-default-version <Version>

WSL 1 또는 WSL 2의 기본 버전을 설정하려면 숫자 1 또는 2로 바꿉 <Version> 니다. 예들 들어 wsl --set-default-version 2입니다. 숫자는 새 Linux 배포 설치에 대해 기본적으로 WSL 버전을 나타냅니다. WSL 1과 WSL 2를 비교해 보세요. WSL 2는 Windows 11 또는 Windows 10, 버전 1903, 빌드 18362 이상에서만 사용할 수 있습니다.

기본 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 --user <Username>

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

배포의 기본 사용자 변경

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

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

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

참고 항목

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

Warning

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

종료

wsl --shutdown

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

Terminate

wsl --terminate <Distribution Name>

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

IP 주소 식별

• WSL 2(WSL 2 VM 주소)를 통해 설치된 Linux 배포의 IP 주소에 대한 wsl hostname -i
• WSL 2(WSL 2 VM)에서 볼 수 있는 Windows 컴퓨터의 IP 주소에 대한 cat /etc/resolv.conf

배포 내보내기

wsl --export <Distribution Name> <FileName>

지정된 배포의 스냅샷 새 배포 파일로 내보냅니다. 기본값은 tar 형식입니다. 파일 이름은 표준 입력용일 - 수 있습니다. 표시되는 옵션은 다음과 같습니다.

• --vhd: 내보내기 배포를 tar 파일 대신 .vhdx 파일로 지정합니다(WSL 2를 사용하는 경우에만 지원됨).

배포 가져오기

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

지정된 tar 파일을 새 배포로 가져옵니다. 파일 이름은 표준 입력용일 - 수 있습니다. 표시되는 옵션은 다음과 같습니다.

• --vhd: 가져오기 배포를 tar 파일 대신 .vhdx 파일로 지정합니다(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는 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 명령 구문으로 대체되었습니다.