Общие параметры профиля в Терминале Windows

  • Статья

Указанные ниже параметры относятся к каждому отдельному профилю. Если вы хотите применить параметр ко всем профилям, вы можете добавить его в раздел defaults над списком профилей в файле settings.json.

"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 в папке GitHubRepos в каталоге Documents, найдя профиль powershell.exe и добавив "startingDirectory": "%USERPROFILE%/Documents/GitHubRepos",.

Пример с WSL: настраивая начальный каталог для дистрибутива Linux, установленного через WSL, используйте формат "startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME", заменив заполнители соответствующими именами вашего дистрибутива. Например, "startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1". Если вы используете пользовательский интерфейс параметров Терминала Windows, а не файл settings.json, чтобы объявить этот путь, вы можете использовать кнопку Обзор, чтобы выбрать начальный каталог, или введите путь WSL в формате //wsl.localhost/DISTRO NAME/home/USERNAME. Например, //wsl.localhost/Ubuntu-20.04/home/user1.

Поведение по умолчанию: если значение startDirectory не указано, вы получите разные результаты в зависимости от того, где вы запускаете Терминал:

  • Если выполнить Терминал Windows из меню :%WINDIR%\System32
  • Если вы запускаете wt.exe из меню :%WINDIR%\System32
  • Если вы запускаете wt.exe из Win+R: %USERPROFILE%
  • При запуске wt.exe из адресной строки проводника — любая нужная папка.

Примечание.

Обратные косые черты нужно экранировать. Например, C:\Users\USERNAME\Documents следует изменить на C:\\Users\\USERNAME\\Documents.

Icon

Этот параметр задает значок, отображаемый на вкладке, в раскрывающемся меню, в списке переходов и на переключателе вкладок.

Имя свойства:icon.

Степень необходимости: необязательно

Принимает: расположение файла в виде строки или эмодзи.

Пример: поместив изображение значка ubuntu.ico в папку %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState, вы можете отобразить значок, добавив эту строку в профиль в файле settings.json: "icon": "ms-appdata:///roaming/ubuntu.ico".


___

Tab title

Если задано, name будет заменен на заголовок для передачи в оболочку при запуске. Некоторые оболочки (например, bash) могут игнорировать это начальное значение, а другие (Command Prompt, PowerShell) могут использовать это значение в течение всего времени существования приложения. Сведение о настройке заголовка оболочки см. в руководстве по работе с заголовками вкладок.

Имя свойства:tabTitle.

Степень необходимости: необязательно

Принимает: Строка


___

Автоматически запускать от имени администратора

Если этот параметр включен, этот профиль будет автоматически открываться в окне с повышенными привилегиями (запуск от имени администратора) по умолчанию. Если запустить этот профиль из окна без повышенных привилегий, для размещения этого профиля будет создано новое окно терминала с повышенными привилегиями. Если запустить этот профиль из окна с повышенными привилегиями, оно откроется как новая вкладка.

Если задать значение false, открытие этого профиля в окне с повышенными привилегиями не приведет к запуску окна без повышенных привилегий для размещения этого профиля. Профиль просто откроется в окне с повышенными привилегиями и будет выполняться от имени администратора.

Если задать значение profiles.defaults, все профили будут запускаться от имени администратора по умолчанию, если только не будет явно задано значение false.

Это свойство может быть переопределено в действиях newTab и splitPane с использованием свойства elevate.

Вкладки с повышенными привилегиями и без них не могут использоваться в одном окне терминала. Дополнительные сведения см. в разделе с вопросами и ответами.

Имя свойства:elevate.

Степень необходимости: необязательно

Принимает:true, false.

Значение по умолчанию:false.


___

Скрыть профиль из раскрывающегося списка

Если для hidden задано значение true, профиль не будет отображаться в списке профилей. Эту функцию можно использовать для скрытия профилей по умолчанию и динамически создаваемых профилей, оставляя их в файле параметров. Дополнительные сведения о динамических профилях см. на этой странице.

Имя свойства:hidden.

Степень необходимости: необязательно

Принимает:true, false.

Значение по умолчанию:false.