Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используется wt.exe для открытия нового экземпляра терминала Windows из командной строки. Вместо этого можно использовать псевдоним wt выполнения.
Замечание
Если вы создаете терминал Windows из исходного кода на GitHub, вы можете открыть эту сборку с помощью wtd.exe или wtd.
Синтаксис командной строки
Командная 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 Terminal