아래 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
: "Linux용 Windows 하위 시스템" 선택적 구성 요소를 활성화하여 Microsoft Store 버전의 WSL을 설치하는 동안 WSL 1을 동시에 사용 설정합니다. -
--no-distribution
: WSL을 설치할 때 배포를 설치하지 마세요.
메모
Windows 10 또는 이전 버전에서 WSL을 실행하는 경우 배포를 지정하려면 -d
명령에 --install
플래그를 포함해야 할 필요가 있을 수 있습니다: wsl --install -d <distribution name>
.
사용 가능한 Linux 배포 목록
wsl --list --online
온라인 스토어를 통해 사용할 수 있는 Linux 배포 목록을 참조하세요. 이 명령은 다음과 같이 입력할 수도 있습니다. wsl -l -o
.
설치된 Linux 배포판 나열
wsl --list --verbose
Windows 머신에 설치된 Linux 배포 목록(배포가 실행 중인지 중지되었는지 여부) 및 배포를 실행하는 WSL 버전(WSL 1 또는 WSL 2)을 참조하세요.
WSL 1 및 WSL 2비교합니다. 이 명령은 다음과 같이 입력할 수도 있습니다. wsl -l -v
. 목록 명령과 함께 사용할 수 있는 추가 옵션에는 모든 배포를 나열하는 --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 이상에서만 사용할 수 있습니다.
경고
WSL 1과 WSL 2 간의 전환은 시간이 오래 걸릴 수 있으며 두 아키텍처 간의 차이로 인해 오류가 발생할 수 있습니다. 대규모 프로젝트가 있는 배포의 경우 변환을 시도하기 전에 파일을 백업하는 것이 좋습니다.
기본 WSL 버전 설정
wsl --set-default-version <Version>
WSL 1 또는 WSL 2의 기본 버전을 설정하려면 <Version>
숫자 1 또는 2로 바꿉니다. 예를 들어 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과 함께 사용하여 사용자의 홈 디렉터리에서 시작할 수 있습니다. WSL 명령 프롬프트 내에서 디렉터리에서 집으로 다시 이동하려면 cd ~
명령을 사용할 수 있습니다.
PowerShell 또는 CMD에서 특정 Linux 배포 실행
wsl --distribution <Distribution Name> --user <User Name>
특정 사용자로 특정 Linux 배포판을 실행하려면 <Distribution Name>
을 선호하는 Linux 배포판의 이름(예: Debian)으로, <User Name>
을 기존 사용자의 이름(예: root)으로 바꾸세요. 사용자가 WSL 배포에 없는 경우 오류가 발생합니다. 현재 사용자 이름을 인쇄하려면 whoami
명령을 사용합니다.
WSL 업데이트
wsl --update
WSL 버전을 최신 버전으로 업데이트합니다. 옵션은 다음과 같습니다.
-
--web-download
: Microsoft Store가 아닌 GitHub에서 최신 업데이트를 다운로드합니다.
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 -l
사용합니다.
경고
이 명령은 가져온 배포에 대해 작동하지 않습니다. 이러한 배포에는 실행 가능한 시작 관리자가 없기 때문입니다. 대신 /etc/wsl.conf
파일을 사용하여 가져온 배포판의 기본 사용자를 변경할 수 있습니다.
고급 설정 구성 문서에서 자동 탑재 옵션을 참조하세요.
시스템 종료
wsl --shutdown
실행 중인 모든 배포판과 WSL 2 경량 유틸리티 가상 머신을 즉시 종료합니다. 이 명령은 메모리 사용량 제한을 변경하거나 .wslconfig 파일변경하는 WSL 2 가상 머신 환경을 다시 시작해야 하는 경우에 필요할 수 있습니다.
끝내다
wsl --terminate <Distribution Name>
지정된 배포를 종료하거나 실행을 중지하려면 <Distribution Name>
대상 배포의 이름으로 바꿉습니다.
IP 주소 식별
-
wsl hostname -I
: WSL 2(WSL 2 VM 주소)를 통해 설치된 Linux 배포의 IP 주소를 반환합니다. -
ip route show | grep -i default | awk '{ print $3}'
: WSL 2(WSL 2 VM)에서 볼 수 있는 Windows 컴퓨터의 IP 주소를 반환합니다.
자세한 설명은 WSL을 사용하여 네트워크 애플리케이션에 액세스하는 : IP 주소식별을 참조하세요.
배포본 내보내기
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 배포판에 실제 디스크를 연결하고 탑재합니다.
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.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
명령 구문으로 대체되었습니다.
Windows Subsystem for Linux