Windows 터미널의 일반 프로필 설정

아래에 나열된 설정은 각각의 고유한 프로필에만 적용됩니다. 설정을 모든 프로필에 적용하려면 해당 설정을 settings.json 파일의 프로필 목록 위에 있는 defaults 섹션에 추가하면 됩니다.

"defaults":
{
    // SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
    // PROFILE OBJECTS
]

이름

드롭다운 메뉴에 표시될 프로필 이름입니다. 이 값은 시작 시 셸에 전달할 "제목"으로도 사용됩니다. 일부 셸(예: bash)은이 초기 값을 무시하기로 선택할 수 있지만, 다른 셸(Command Prompt, PowerShell)은 애플리케이션의 수명 동안 이 값을 사용할 수 있습니다. 이 "제목" 동작은 tabTitle을 사용하여 재정의할 수 있습니다.

속성 이름:name

필요 여부: 필수

허용하는 값: 문자열



명령줄

프로필에 사용되는 실행 파일입니다.

속성 이름:commandline

필요 여부: 선택

허용하는 값: 실행 파일 이름(문자열)

기본값:"cmd.exe"



시작 디렉터리

로드될 때 셸이 시작하는 디렉터리입니다.

속성 이름:startingDirectory

필요 여부: 선택

허용하는 값: 폴더 위치(문자열)

기본값:"%USERPROFILE%"

참고: 시작 디렉터리가 정의되지 않은 경우 기본값은 "%USERPROFILE%"로 설정됩니다(사용자 설정의 상대 경로, 예: C:\Users\<your username>). 그러나 시작 디렉터리가 명시적으로 null로 설정된 경우 터미널을 시작하는 위치에 따라 다른 결과를 얻게 됩니다.

예: powershell.exe 프로필을 찾고 "startingDirectory": "%USERPROFILE%/Documents/GitHubRepos",를 추가하여 Documents 디렉터리의 GitHubRepos 폴더에서 PowerShell 프로필을 시작합니다.

WSL 사용 예:WSL을 통해 설치된 Linux 배포에 대한 시작 디렉터리를 설정하는 경우 "startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME" 형식을 사용하고 자리 표시자를 배포의 적절한 이름으로 바꿉니다. 예: "startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1". settings.json 파일 대신 Windows 터미널 설정 UI를 사용하는 경우 이 경로를 선언하려면 찾아보기... 단추를 사용하여 시작 디렉터리를 선택하거나 WSL 경로를 //wsl.localhost/DISTRO NAME/home/USERNAME으로 입력합니다. 예: //wsl.localhost/Ubuntu-20.04/home/user1.

기본 동작: startingDirectory 값이 지정되지 않으면 터미널을 시작하는 위치에 따라 다른 결과를 얻게 됩니다.

  • 시작 메뉴 Windows 터미널 실행하는 경우:%WINDIR%\System32
  • 시작 메뉴 wt.exe 실행하는 경우:%WINDIR%\System32
  • Win+R에서 wt.exe 실행하는 경우:%USERPROFILE%
  • 탐색기 주소 표시줄에서 wt.exe를 실행하는 경우: 보고 있던 폴더

참고 항목

백슬래시는 이스케이프해야 합니다. 예를 들어 C:\Users\USERNAME\DocumentsC:\\Users\\USERNAME\\Documents로 입력해야 합니다.


Icon

탭, 드롭다운 메뉴, 점프 목록 및 탭 전환기에 표시되는 아이콘을 설정합니다.

속성 이름:icon

필요 여부: 선택

허용하는 값: 파일 위치(문자열 또는 이모지)

예:ubuntu.ico 아이콘 이미지를 %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState에 있는 폴더에 배치하면 "icon": "ms-appdata:///roaming/ubuntu.ico" 줄을 settings.json의 프로필에 추가하여 아이콘을 표시할 수 있습니다.


___

Tab title

설정하면 name을 시작 시 셸에 전달할 제목으로 바꿉니다. 일부 셸(예: bash)은이 초기 값을 무시하기로 선택할 수 있지만, 다른 셸(Command Prompt, PowerShell)은 애플리케이션의 수명 동안 이 값을 사용할 수 있습니다. 셸이 제목을 설정하게 하는 방법은 탭 제목 자습서를 참조하세요.

속성 이름:tabTitle

필요 여부: 선택

허용하는 값: 문자열


___

관리자 권한으로 자동 실행

설정되면 이 프로필은 기본적으로 "관리자 권한이 있는" 창(관리자 권한으로 실행)에서 자동으로 열립니다. 관리자 권한이 없는 창에서 이 프로필을 실행하면 이 프로필을 호스트하기 위해 관리자 권한이 있는 터미널 창이 새로 만들어집니다. 이미 관리자 권한이 있는 창에서 이 프로필을 시작하면 새 탭으로 열립니다.

이 속성을 false로 설정한 경우 관리자 권한이 있는 창에서 이 프로필을 열면 이 프로필을 호스트하기 위해 관리자 권한이 없는 창이 시작되지 않습니다. 프로필은 관리자 권한으로 실행되는 관리자 권한이 있는 창에서만 열립니다.

profiles.defaults에서 이 속성을 설정하면 구체적으로 false로 설정하여 재정의하는 경우를 제외하고는 기본적으로 모든 프로필이 관리자 권한으로 실행됩니다.

이 속성은 elevate 속성을 사용하여 newTabsplitPane 작업에서 재정의할 수 있습니다.

관리자 권한이 있는 탭과 관리자 권한이 없는 탭은 동일한 터미널 창에 있을 수 없습니다. 자세한 내용은 FAQ를 참조하세요.

속성 이름:elevate

필요 여부: 선택

허용하는 값:true, false

기본값:false


___

드롭다운에서 프로필 숨기기

hiddentrue로 설정하면 프로필이 프로필 목록에 표시되지 않습니다. 기본 프로필 및 동적으로 생성된 프로필을 숨기면서도 설정 파일에 남겨 두기 위한 목적으로 사용할 수 있습니다. 동적 프로필에 대한 자세한 내용을 보려면 동적 프로필 페이지를 방문하세요.

속성 이름:hidden

필요 여부: 선택

허용하는 값:true, false

기본값:false