Параметры запуска в Терминале Windows

  • Статья

Перечисленные ниже свойства влияют на все окно терминала, независимо от параметров профиля. Они должны размещаться в корне файла settings.json.

Профиль по умолчанию

Задайте профиль по умолчанию, который открывается, введя клавиши CTRL+SHIFT+T, введя привязку ключа, назначенную newTab, выполняясь wt new-tab без указания профиля или щелкнув значок "+".

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

Необходимость: обязательный

Принимает: GUID или имя профиля в виде строки

Значение по умолчанию: GUID PowerShell


Приложение терминала по умолчанию

Задайте эмулятор терминала по умолчанию в Windows для всех приложений командной строки.

Имя свойства: изменяет параметр ОС и не имеет имя свойства в файле settings.json.

Необходимость: обязательный

Принимает: любой эмулятор терминала, который отображается в раскрывающемся списке.

Значение по умолчанию: узел консоли Windows.

Важно!

Эта функция доступна только в версии Канала разработчика по Программе предварительной оценки Windows 10 или Windows 11.


Запуск при запуске компьютера

Если задать значение true, Терминал Windows Terminal будет запускаться при загрузке. Если задать значение false, запуск при загрузке будет отключен.

Примечание. Если запись запуска Терминала Windows отключена политикой организации или действием пользователя, этот параметр не будет работать.

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

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

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

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


Поведение при запуске нового сеанса терминала

Если задано значение "defaultProfile", Терминал Windows запустит новый сеанс, открыв одну вкладку с профилем по умолчанию.

Если задано значение "persistedWindowLayout", это позволяет Терминалу Windows сохранять макет открытых окон при закрытии и восстанавливать все сохраненные окна при запуске нового сеанса. Терминал Windows сохранит макет всех открытых окон автоматически, чтобы упростить восстановление после сбоев, а также сохранит макет при использовании действия quit. Кроме того, закрытие последнего открытого окна путем нажатия кнопки X или с помощью команды closeWindow приведет к сохранению макета последнего окна.

Примечание. В настоящее время Терминал Windows сохраняет следующие сведения:

  • Расположение, размер и имя каждого окна.

  • Макет вкладок каждого окна, включая макет и профиль каждой области, но не все содержимое этих областей.

  • Если в вашей оболочке настроено информирование о текущем рабочем каталоге, он также будет сохраняться.

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

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

Принимает:"defaultProfile", "persistedWindowLayout".

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


Launch mode

Определяет, запускать ли терминал в развернутом, полноэкранном режиме или режиме окна. Значение focus эквивалентно запуску терминала в режиме default, но с включенным режимом фокусировки. Аналогично, со значением maximizedFocus терминал будет запущен в развернутом окне с включенным режимом фокусировки.

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

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

Принимает:"default", "maximized", "fullscreen", "focus", "maximizedFocus".

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


Поведение нового экземпляра

Этот параметр определяет, как новые экземпляры терминала присоединяются к существующим окнам. Это свойство используется только в том случае, если не указан аргумент командной строки--window,-w window. Этот параметр принимает следующие возможные значения:

  • useNew: всегда создавать новое окно. Это стандартное поведение терминала до версии 1.7.
  • useExisting: создавать новые вкладки в последнем использованном окне на этом рабочем столе. Если на этом виртуальном рабочем столе нет существующего окна, создать новое окно терминала.
  • useAnyExisting: создать новые вкладки в последнем использованном окне независимо от того, на каком виртуальном рабочем столе оно располагается.

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

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

Принимает:"useNew", "useExisting", "useAnyExisting".

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


Размер окна при запуске

Столбцы при первом запуске

Это число символьных столбцов, отображаемых в окне при первой загрузке. Если для launchMode задано значение "maximized" или "maximizedFocus", это свойство игнорируется.

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

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

Принимает: целое число

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

Строки при первом запуске

Это число строк, отображаемых в окне при первой загрузке. Если для launchMode задано значение "maximized" или "maximizedFocus", это свойство игнорируется.

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

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

Принимает: целое число

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


Расположение при запуске

Задает позицию пикселя верхнего левого угла окна при первой загрузке. В системе с несколькими экранами эти координаты указываются относительно левого верхнего угла основного экрана. Если координата X или Y не указана, терминал будет использовать для этого системное значение по умолчанию. Если для launchMode задано значение "maximized" или "maximizedFocus", окно будет развернуто на мониторе, заданном с помощью этих координат.

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

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

Принимает: координаты в виде строки в форматах ",", "#,#", "#,", ",#".

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


Центрировать при запуске

Если задано значение true, окно терминала будет автоматически центрироваться на экране, на котором оно открывается. Терминал будет использовать "initialPosition", чтобы определить дисплей для открытия окна.

На другие параметры запуска это влияет следующим образом:

  • "initialPosition": "x,y", "centerOnLaunch": true, "launchMode": "default": центрировать на мониторе с x,y.
  • "initialPosition": "x,y", "centerOnLaunch": true, "launchMode": "maximized": развернуть на мониторе с x,y (centerOnLaunch не делает ничего).
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "default": центрировать на мониторе по умолчанию.
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "focus": центрировать и включить режим фокусировки на мониторе по умолчанию.
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "maximized": развернуть на мониторе по умолчанию (centerOnLaunch не делает ничего).

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

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

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

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


Отключение динамических профилей

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

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

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

Принимает:"Windows.Terminal.Wsl", "Windows.Terminal.Azure", "Windows.Terminal.PowershellCore"и /или "Windows.Terminal.SSH" внутри массива

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


Действия при запуске

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

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

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

Принимает: строка, представляющая список команд для выполнения.

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


Продолжить работу в фоновом режиме (предварительная версия)

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

Имя свойства:compatibility.allowHeadless.

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

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

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