Поделиться через


Использование аргументов командной строки для терминала Windows

Используется wt.exe для открытия нового экземпляра терминала Windows из командной строки. Вместо этого можно использовать псевдоним wt выполнения.

Замечание

Если вы создаете терминал Windows из исходного кода на GitHub, вы можете открыть эту сборку с помощью wtd.exe или wtd.

Аргумент командной строки терминала Windows для разделительных областей

Синтаксис командной строки

Командная wt строка принимает два типа значений: параметры и команды. Параметры — это список флагов и других параметров, которые управляют поведением командной wt строки в целом. Команды предоставляют действие или список действий, разделенных точкой с запятой, реализуемой командной строкой. Если команда не указана, командная строка используется new-tab по умолчанию.

wt [options] [command ; ]

Замечание

СвойствоwindowingBehavior может повлиять на поведение команды wt.exe. Измените этот параметр, чтобы установить значение по умолчанию между открытием нового окна или открытием новой вкладки.

Чтобы отобразить сообщение справки, в котором перечислены доступные аргументы командной строки, введите: wt -h, wt --helpwt -?или wt /?.

Параметры и команды

Ниже приведен полный список поддерживаемых команд и параметров командной wt строки.

Вариант Description
--help, -h, -?, /? Отображает сообщение справки.
--maximized, -M Запускает развернутый терминал.
--fullscreen, -F Запускает терминал как полноэкранный.
--focus, -f Запускает терминал в режиме фокусировки. Можно сочетать с maximized.
--pos x,y Запускает терминал по заданной позиции. x или y может быть опущен, чтобы использовать значение по умолчанию из параметров.
--size c,r Запускает терминал с указанным количеством столбцов (c) и строк (r).
--window, -w window-id Выполняет указанную команду в определенном окне.

Параметр --window можно использовать для отправки команд в существующие окна терминала.

window-id может быть целым идентификатором окна или именем окна. Он также принимает следующие зарезервированные значения:

  • new или -1: всегда выполняйте эту команду в новом окне
  • last или 0: всегда выполняйте эту команду в последнем используемом окне

Если окно не существует с заданным window-id, новое окно будет создано с таким идентификатором или именем.

Например, при запуске wt -w _quake откроется новое окно землетрясения. При выполнении этой команды снова откроется новая вкладка в существующем окне землетрясения.

Команда "Создать вкладку"

Используйте эту команду для создания новой вкладки. Дополнительную информацию см. в разделе о действииnewTab.

Command Параметр Description Ценности
new-tab, nt --profile, -p profile-name Создает новую вкладку на основе назначенного имени профиля. Имя профиля
new-tab, nt --startingDirectory, -d starting-directory Создает новую вкладку на основе назначенного начального пути к каталогу. Путь к каталогу
new-tab, nt --title title Создает новую вкладку с назначенным заголовком. Текст, используемый в качестве заголовка вкладки
new-tab, nt --tabColor hex-color Создает новую вкладку с назначенным цветом вкладки. Шестнадцатеричный цвет как #RGB или #RRGGBB
new-tab, nt --suppressApplicationTitle Переопределите параметр профиля suppressApplicationTitle и задайте для него значение true
new-tab, nt --useApplicationTitle Переопределите параметр профиля suppressApplicationTitle и задайте для него значение false
new-tab, nt --colorScheme scheme-name Переопределите параметр профиля colorScheme и задайте его схеме из параметров с именем. scheme-name Имя цветовой схемы в параметрах
new-tab, nt --appendCommandLine Добавляет указанную командную строку к команде по умолчанию профиля вместо замены
new-tab, nt --inheritEnvironment, !--reloadEnvironment Наследуйте собственные переменные среды терминала при создании нового сеанса, а не создание нового блока среды. Значение по умолчанию устанавливается при commandline передаче.
new-tab, nt commandline Создает новую вкладку на основе назначенной командной строки. Исполняемый файл с необязательными аргументами

Подсказка

Если вы измените название вкладки в терминале Windows и хотите сохранить это название, необходимо включить параметр suppressApplicationTitle , задав для него значение true.

Команда split-pane

Используйте эту команду для создания новой области разделения. Дополнительные сведения см. в описании действия splitPane.

Command Параметр Description Ценности
split-pane, sp -H, --horizontal, -V, --vertical Создает новую область разделенного окна по горизонтали или по вертикали. N/A. Никаких дополнительных значений для назначения.
split-pane, sp --profile, -p profile-name Создает новую область разделенного окна на основе назначенного профиля командной строки. Если этот параметр не назначен, используется профиль по умолчанию. Имя профиля
split-pane, sp --startingDirectory, -d starting-directory Создает новую область разделенного окна на основе назначенного начального пути каталога. Если этот параметр не назначен, используется начальный каталог по умолчанию. Путь к каталогу
split-pane, sp --title Создает новую область разделенного окна с назначенным заголовком. Текст, используемый в качестве заголовка вкладки
split-pane, sp --tabColor Создает новую область разделенного окна с назначенным цветом вкладки. Шестнадцатеричный цвет как #RGB или #RRGGBB
split-pane, sp --size, -s size Создает новую область разделенного окна с назначенным размером. Float, указывающий часть родительской панели, которая будет использоваться десятичным значением. Например, .4 чтобы представить 40% родительской панели.
split-pane, sp commandline Создает новую область разделенного окна на основе назначенной командной строки. Исполняемый файл с необязательными командами
split-pane, sp --duplicate, -D Создает новую область разделенного окна, которая дублирует текущую панель. N/A. Никаких дополнительных значений для назначения.
split-pane, sp --suppressApplicationTitle Переопределяет параметр профиля suppressApplicationTitle и задает для него значение true.
split-pane, sp --useApplicationTitle Переопределяет параметр профиля suppressApplicationTitle и задает для него значение false.
split-pane, sp --colorScheme scheme-name Переопределяет параметр профиля colorScheme и устанавливает схему из настроек с именем scheme-name. Имя цветовой схемы в параметрах

Команда "Фокус-вкладка"

Используйте эту команду, чтобы сосредоточить определенную вкладку в окне. Дополнительные сведения см. в описании действия switchToTab.

Command Параметр Description Ценности
focus-tab, ft --target, -t tab-index Фокусируется на конкретной вкладке в соответствии с её номером индекса. Индекс TAB в виде целого числа

Команда "Переместить фокус"

Используйте эту команду для перемещения фокуса в окне. Дополнительные сведения см. в описании действия moveFocus.

Command Параметр Description Ценности
move-focus, mf <direction> Переместите фокус между панелями. См. ниже сведения о принятых direction значениях

Принятые direction значения

  • up, , downleftили right переместить фокус в заданном направлении.
  • first Перемещает фокус на первую конечную панель в дереве.
  • previous перемещает фокус на последнюю используемую панель перед текущей областью.
  • nextInOrder, previousInOrder перемещает фокус на следующую или предыдущую область в порядке создания.

Команда "Панель перемещения"

Используйте эту команду для перемещения области в окне. Дополнительные сведения см. в описании действия movePane.

Command Параметр Description Ценности
move-pane, mp --tab,-t <index> Перемещение активной панели на данную вкладку в окне Отсчитываемый от нуля индекс вкладки для перемещения области в.

Команда "Область переключения"

Используйте эту команду, чтобы заменить позицию двух панелей в окне. См. также swapPane действие.

Command Параметр Description Ценности
swap-pane <direction> Переключение области на область в заданном направлении См. ниже сведения о принятых direction значениях

Принятые direction значения (эти значения совпадают с под командой move-focus ):

  • up, , downleftилиright: переключение активной панели на одну из них в заданном направлении.
  • first: переключите активную панель на первую конечную панель в дереве.
  • previous: переключите активную панель на последнюю используемую панель перед текущей областью.
  • nextInOrder, previousInOrder: переключение активной панели на следующую или предыдущую область в порядке создания.

Примеры аргументов командной строки

Команды могут немного отличаться в зависимости от используемой командной строки.

Передача аргумента в оболочку по умолчанию

Чтобы запустить экземпляр терминала Windows и выполнить команду, вызовите команду, а затем выполните wt.exe команду.

Ниже приведен пример вызова терминала Windows для передачи аргумента команды ping для эхо-IP-адреса:

wt ping learn.microsoft.com

Ниже приведен пример вызова терминала Windows для открытия новой вкладки с командной строкой PowerShell, подтверждения вызова команды Start-Service и открытия другой новой вкладки с командной строкой Windows, открытой в каталоге /k :

wt new-tab PowerShell -c Start-Service ; new-tab cmd /k dir

Назначение определенного окна

В следующих примерах показано, как использовать --window,-w параметр для назначения определенных окон.

// Open a new tab with the default profile in the current window
wt -w 0 nt

// Open a new tab in a new window with the default profile
wt -w -1 nt

// Open a new tab in the first-created terminal window with the default profile
wt -w 1 nt

// Open a new tab in the terminal window named foo with the default profile. If foo does not exist, create a new window named foo.
wt -w foo nt

Открытие нового экземпляра профиля

Чтобы открыть новый экземпляр терминала, например профиль Ubuntu-18.04, введите следующее:

wt -p "Ubuntu-18.04"

-p Используйте флаг, чтобы указать профиль терминала Windows, который требуется открыть. Замените Ubuntu-18.04 именем любого установленного профиля терминала. Эта команда всегда открывает новое окно. Чтобы открыть новую вкладку оболочки в существующем (уже открытом) экземпляре терминала Windows, используйте: wt -w [window id](#options-and-commands) [executable name] Например, wt -w 0 cmd открывает окно командной строки в последнем открытом экземпляре терминала Windows. Если вы запускаете профиль (исполняемый файл оболочки в сочетании с цветовой схемой, заголовком, командой и другими параметрами, которые управляют взаимодействием с сеансом консоли), необходимо использовать имя профиля в команде: wt -w 0 -p "Profile Name"

Назначение каталога

Чтобы указать папку, которую консоль использует в качестве начального каталога, введите следующую команду. В этом примере начальный каталог — это d:\.

wt -d d:\

Несколько вкладок

Чтобы открыть новый экземпляр терминала с несколькими вкладками, введите следующее:

wt ; ;

Чтобы открыть новый экземпляр терминала с несколькими вкладками, в этом случае введите профиль командной строки и профиль PowerShell:

wt -p "Command Prompt" ; new-tab -p "Windows PowerShell"

Несколько панелей

Чтобы открыть новый экземпляр терминала с одной вкладкой, содержащей три области с профилем командной строки, профилем PowerShell и профилем по умолчанию с командной строкой WSL, введите:

wt -p "Command Prompt" ; split-pane -p "Windows PowerShell" ; split-pane -H wsl.exe

Флаг -H (или --horizontal) указывает, что области будут разделены по горизонтали. Флаг -V (или --vertical) указывает, что вы хотите, чтобы области были разделены по вертикали.

Несколько вкладок и панелей

Последовательность команд new-tab и split-pane для получения нескольких вкладок, каждая из которых содержит разделенные панели. Чтобы открыть новый экземпляр терминала с двумя вкладками, каждая с двумя панелями с командной строкой и командной строкой WSL с каждой вкладкой в другом каталоге введите:

wt -p "Command Prompt" ; split-pane -V wsl.exe ; new-tab -d c:\ ; split-pane -H -d c:\ wsl.exe

Заголовок области

Чтобы открыть новый экземпляр терминала с пользовательскими заголовками для каждой области терминала, используйте --title аргумент. Чтобы задать заголовок каждой панели при открытии нескольких вкладок, введите:

wt --title tabname1 ; new-tab -p "Ubuntu-18.04" --title tabname2

Панели на одной вкладке могут иметь разные заголовки. Заголовок вкладки отражает заголовок панели с фокусом. Чтобы присвоить имена независимым панелям, задайте заголовок после разделения панелей, введя следующее:

wt --title pane1 ; split-pane -p "Command Prompt" --title pane2

Использование заголовка приложения

Чтобы открыть новый экземпляр терминала, позволяющий приложениям задать заголовок вкладки, отправляя сообщения об изменении заголовка, используйте --useApplicationTitle флаг. Чтобы отключить эти сообщения, используйте --suppressApplicationTitle флаг. Если вы не предоставляете ни один флаг, терминал использует параметры профиля. Чтобы открыть вкладку с заголовком tabname , который приложение не переопределяет, введите следующее:

wt --title tabname --suppressApplicationTitle

Цвет вкладок

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

wt --tabColor #009999 ; new-tab --tabColor #f59218

Когда вы устанавливаете --tabColor для вкладки, вы связываете ее с первой панелью этой вкладки. Таким образом, на вкладке с несколькими панелями цвет применяется только в том случае, если первая панель находится в фокусе. Чтобы задать цвет вкладки для дополнительных областей, вы должны также добавить параметр --tabColor в подкоманду split-pane. В приведенном ниже примере вкладка с двумя панелями создается с цветами вкладок, указанными для каждой панели:

wt new-tab --tabColor '#009999' `; split-pane --tabColor '#f59218'

Цветовая схема

Чтобы открыть новый экземпляр терминала с определенной цветовой схемой (вместо colorScheme набора в профиле), используйте --colorScheme аргумент. Этот аргумент переопределяет значение, определенное в профиле.

wt --colorScheme Vintage ; split-pane --colorScheme "Tango Light"

Фокус на вкладке

Чтобы открыть новый экземпляр терминала с определенной вкладкой в фокусе, используйте -t флаг (или --target), а также номер индекса табуляции. Чтобы открыть профиль по умолчанию на первой вкладке и в профиле Ubuntu-18.04, на второй вкладке (-t 1) введите:

wt ; new-tab -p "Ubuntu-18.04" ; focus-tab -t 1

Примеры нескольких команд из PowerShell

Терминал Windows использует символ ; с запятой в качестве разделителя для разделения команд в командной строке wt . К сожалению, PowerShell также используется ; в качестве разделителя команд. Чтобы обойти эту проблему, используйте следующие приемы для выполнения нескольких wt команд в PowerShell. Во всех следующих примерах создается новое окно терминала с тремя панелями — одной из которых выполняется командная строка, одна с PowerShell, а последняя — WSL.

В следующих примерах start не используется для выполнения командной строки. Вместо этого они используют два других метода обхода командной строки.

  • Только экранирование точек с запятой, чтобы PowerShell игнорировал их и передавал прямо в wt.
  • Использование --% позволяет PowerShell обрабатывать остальную часть командной строки в качестве аргументов для приложения.
wt new-tab "cmd" `; split-pane -p "Windows PowerShell" `; split-pane -H wsl.exe
wt --% new-tab cmd ; split-pane -p "Windows PowerShell" ; split-pane -H wsl.exe

В обоих из этих примеров только что созданное окно терминала Windows правильно анализирует все предоставленные аргументы командной строки.

Однако эти методы в настоящее время не рекомендуется. PowerShell ожидает закрытия только что созданного окна терминала перед возвращением контроля к PowerShell. По умолчанию PowerShell всегда ожидает закрытия программ Магазина Windows (таких как Windows Terminal) перед возвратом к запросу. Это поведение отличается от поведения командной строки, которая сразу возвращается к приглашению.

Добавление исполняемого файла терминала Windows в PATH

Чтобы добавить исполняемый файл терминала Windows (wt.exe) в PATH, включите его псевдоним "выполнение приложения" на странице "Управление псевдонимами выполнения приложения " параметров Windows. Псевдоним терминала Windows включен по умолчанию, но может потребоваться подтвердить его, если у вас возникли проблемы с доступом к нему.

Если у вас по-прежнему возникают проблемы с доступом к псевдонимам выполнения приложения, проверьте, содержит ли ваш PATH: %LOCALAPPDATA%\Microsoft\WindowsApps Не пытайтесь вносить изменения в C:\Program Files\WindowsApps.

Параметры Windows для псевдонимов выполнения приложений