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

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

Примечание

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

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

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

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

wt [options] [command ; ]

Примечание

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

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

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

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

Параметр Описание
--help, -h, -?, /? Отображает справочное сообщение.
--maximized, -M Запускает терминал в развернутом режиме.
--fullscreen, -F Запускает терминал в полноэкранном режиме.
--focus, -f Запускает терминал в режиме фокусировки. Может использоваться вместе с maximized.
--window, -w<window-id> Запускает терминал в определенном окне.

Команда New-tab

Команда Параметр Описание Значения
new-tab, nt --profile, -p profile-name Создает вкладку на основе назначенного имени профиля. Имя профиля
new-tab, nt --startingDirectory, -d starting-directory Создает вкладку на основе назначенного пути к начальному каталогу. Путь к каталогу.
new-tab, nt commandline Создает вкладку на основе назначенной командной строки. Исполняемый файл с необязательными командами
new-tab, nt --title Создает вкладку с назначенным заголовком. Текст, используемый в качестве заголовка вкладки
new-tab, nt --tabColor Создает вкладку с назначенным цветом вкладки. Цвет в шестнадцатеричном формате #RGB или #RRGGBB

Совет

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

Команда Split-pane

Команда Параметр Описание Значения
split-pane, sp -H, --horizontal, -V, --vertical Создает область окна, разделенного горизонтально или вертикально. Недоступно Нет дополнительных значений для назначения.
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 Создает область разделенного окна с назначенным размером. Число с плавающей запятой, указывающее часть родительской области для использования, представленную десятичным числом. Например, .4 для представления 40 % родительской области.
split-pane, sp commandline Создает область разделенного окна на основе назначенной командной строки. Исполняемый файл с необязательными командами
split-pane, sp --duplicate, -D Создает область разделенного окна, которая дублирует текущую область. Недоступно Нет дополнительных значений для назначения.

Команда Focus-tab

Команда Параметр Описание Значения
focus-tab, ft --target, -t tab-index Фокусируется на определенной вкладке в соответствии с номером индекса вкладки. Индекс вкладки в виде целого числа

Команда Move-focus

Команда Параметр Описание Значения
move-focus, mf direction Перемещает фокус между областями в заданном направлении. Принимаются значения up, down, left или right.

Примечание

При открытии Терминала Windows из cmd (командная строка), если вы хотите использовать настраиваемые параметры профиля "cmd", выполните команду wt -p cmd. Если нет, просто используйте wt cmd для запуска параметров профиля по умолчанию.

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

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

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

Чтобы запустить экземпляр Терминала 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 пока нельзя открывать новые вкладки или панели в имеющемся экземпляре.

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

Чтобы указать папку, которая будет использоваться в качестве начального каталога для консоли (в данном случае каталог 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) перед возвратом к командной строке. Обратите внимание, что это поведение отличается от поведения средства "Командная строка", которое немедленно возвращается к командной строке.