다음을 통해 공유


WSL에 대한 기본 명령

아래 WSL 명령은 PowerShell 또는 Windows 명령 프롬프트에서 지원하는 형식으로 나열됩니다. Bash/Linux 배포 명령줄에서 이러한 명령을 실행하려면 wslwsl.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 명령 구문으로 대체되었습니다.