Compartilhar via

Usando argumentos de linha de comando para o Terminal do Windows

Use wt.exe para abrir uma nova instância do Terminal do Windows na linha de comando. Você também pode usar o alias wt de execução.

Observação

Se você criar o Terminal do Windows com base no código-fonte no GitHub, poderá abrir esse build usando wtd.exe ou wtd.

Argumento de linha de comando do Terminal do Windows para painéis divididos

Sintaxe de linha de comando

A wt linha de comando aceita dois tipos de valores: opções e comandos. As opções são uma lista de sinalizadores e outros parâmetros que controlam o comportamento da linha de wt comando como um todo. Os comandos fornecem a ação ou a lista de ações separadas por ponto-e-vírgula que a linha de comando implementa. Se você não especificar um comando, a linha de comando usará new-tab por padrão.

wt [options] [command ; ]

Observação

A windowingBehavior propriedade pode afetar o comportamento do wt.exe comando. Ajuste essa configuração como padrão entre abrir uma nova janela ou abrir uma nova guia.

Para exibir uma mensagem de ajuda que lista os argumentos de linha de comando disponíveis, insira: wt -h, , wt --help, wt -?ou wt /?.

Opções e comandos

Abaixo está a lista completa de comandos e opções com suporte para a wt linha de comando.

Opção Description
--help, -h, -?, /? Exibe a mensagem de ajuda.
--maximized, -M Inicia o terminal maximizado.
--fullscreen, -F Inicia o terminal como tela inteira.
--focus, -f Inicia o terminal no modo de foco. Pode ser combinado com maximized.
--pos x,y Inicia o terminal na posição fornecida. x ou y pode ser omitido, para usar o valor padrão das configurações.
--size c,r Inicia o terminal com o número especificado de colunas (c) e linhas (r).
--window, -w window-id Executa o comando especificado em uma janela específica.

O --window parâmetro pode ser usado para enviar comandos para janelas de terminal existentes.

window-id pode ser a ID de inteiro de uma janela ou o nome de uma janela. Ele também aceita os seguintes valores reservados:

  • new ou -1: sempre execute este comando em uma nova janela
  • last ou 0: sempre execute este comando na janela usada mais recentemente

Se nenhuma janela existir com a determinada window-id, uma nova janela será criada com essa ID/nome.

Por exemplo, a execução wt -w _quake abrirá uma nova "janela de terremoto". Executar esse comando novamente abrirá uma nova guia na janela de terremoto existente.

Novo comando de guia

Utilize este comando para criar uma nova guia. Para mais informações, consulte a açãonewTab.

Command Parâmetro Description Valores
new-tab, nt --profile, -p profile-name Cria uma nova guia com base no nome do perfil atribuído. Nome do perfil
new-tab, nt --startingDirectory, -d starting-directory Cria uma nova guia com base no caminho de diretório inicial atribuído. Caminho do diretório
new-tab, nt --title title Cria uma nova guia com o título atribuído. Texto a ser usado como o título da guia
new-tab, nt --tabColor hex-color Cria uma nova guia com a cor da guia atribuída. Cor hexáxe como #RGB ou #RRGGBB
new-tab, nt --suppressApplicationTitle Substitua a configuração do suppressApplicationTitle perfil e defina-a como true
new-tab, nt --useApplicationTitle Substitua a configuração do suppressApplicationTitle perfil e defina-a como false
new-tab, nt --colorScheme scheme-name Substitua a configuração do colorScheme perfil e defina-a para o esquema das configurações com o nome scheme-name O nome de um esquema de cores nas configurações
new-tab, nt --appendCommandLine Acrescenta a linha de comando fornecida ao comando padrão do perfil em vez de substituí-la
new-tab, nt --inheritEnvironment, !--reloadEnvironment Herda as variáveis de ambiente do próprio terminal ao criar a nova sessão, em vez de criar um novo bloco de ambiente. Esse padrão é definido quando um commandline é passado.
new-tab, nt commandline Cria uma nova guia com base na linha de comando atribuída. Executável com argumentos opcionais

Dica

Se você alterar o título de uma guia no Terminal do Windows e quiser que esse título persista, você deverá habilitar a opção suppressApplicationTitle definindo-a como true.

Comando de painel dividido

Use este comando para criar um novo painel dividido. Para obter mais informações, confira a Ação splitPane.

Command Parâmetro Description Valores
split-pane, sp -H, --horizontal, -V, --vertical Cria um novo painel de janela dividida horizontal ou verticalmente. N/A. Nenhum valor adicional a ser atribuído.
split-pane, sp --profile, -p profile-name Cria um novo painel de janela dividida com base no perfil de linha de comando atribuído. Se você não atribuir esse parâmetro, o perfil padrão será usado. Nome do perfil
split-pane, sp --startingDirectory, -d starting-directory Cria um novo painel de janela dividida com base no caminho de diretório inicial atribuído. Se você não atribuir esse parâmetro, o diretório inicial padrão será usado. Caminho do diretório
split-pane, sp --title Cria um novo painel de janela dividida com o título atribuído. Texto a ser usado como o título da guia
split-pane, sp --tabColor Cria um novo painel de janela dividida com a cor da guia atribuída. Cor hexáxe como #RGB ou #RRGGBB
split-pane, sp --size, -s size Cria um novo painel de janela dividida com o tamanho atribuído. Float que especifica a parte do painel pai a ser usada representada por um decimal. Por exemplo, .4 para representar 40% do painel pai.
split-pane, sp commandline Cria um novo painel de janela dividida com base na linha de comando atribuída. Executável com comandos opcionais
split-pane, sp --duplicate, -D Cria um novo painel de janela dividida que duplica o painel atual. N/A. Nenhum valor adicional a ser atribuído.
split-pane, sp --suppressApplicationTitle Substitui a configuração do perfil suppressApplicationTitle e a ajusta para true.
split-pane, sp --useApplicationTitle Substitui a configuração do suppressApplicationTitle perfil e a define como false.
split-pane, sp --colorScheme scheme-name Substitui a configuração do colorScheme perfil e define-a para o esquema das configurações com o nome scheme-name. O nome de um esquema de cores nas configurações

Comando de guia de foco

Use este comando para concentrar uma guia específica dentro da janela. Para obter mais informações, confira a Ação switchToTab.

Command Parâmetro Description Valores
focus-tab, ft --target, -t tab-index Concentra-se em uma aba específica de acordo com seu número de índice da aba. Índice de tabulação como um inteiro

Comando Move-focus

Use este comando para mover o foco dentro da janela. Para obter mais informações, confira a Ação moveFocus.

Command Parâmetro Description Valores
move-focus, mf <direction> Mova o foco entre os painéis. Veja abaixo os valores aceitos direction

Valores aceitos direction

  • up, downou leftright mova o foco na direção determinada.
  • first move o foco para o primeiro painel folha na árvore.
  • previous move o foco para o painel usado mais recentemente antes do painel atual.
  • nextInOrder, previousInOrder move o foco para o próximo painel ou anterior em ordem de criação.

Comando move-pane

Use este comando para mover um painel dentro da janela. Para obter mais informações, confira a Ação movePane.

Command Parâmetro Description Valores
move-pane, mp --tab,-t <index> Mover o painel ativo para a guia fornecida na janela O índice indexado zero da guia para a qual mover o painel.

Comando de painel de troca

Use este comando para trocar a posição de dois painéis dentro da janela. Veja também a açãoswapPane.

Command Parâmetro Description Valores
swap-pane <direction> Trocar o painel pelo painel na direção determinada Veja abaixo os valores aceitos direction

Valores aceitos direction (esses valores são os mesmos que o move-focus subcomando):

  • up, downou leftright: troque o painel ativo com aquele na direção determinada.
  • first: troque o painel ativo pelo primeiro painel folha na árvore.
  • previous: troque o painel ativo pelo painel usado mais recentemente antes do painel atual.
  • nextInOrder, previousInOrder: troque o painel ativo pelo painel seguinte ou anterior na ordem de criação.

Exemplos de argumento de linha de comando

Os comandos podem variar ligeiramente dependendo de qual linha de comando você está usando.

Passando um argumento para o shell padrão

Para iniciar uma instância do Terminal do Windows e fazer com que ele execute um comando, chame wt.exe seguido pelo seu comando.

Aqui está um exemplo de como chamar o Terminal do Windows para passar um argumento de comando ping para ecoar um endereço IP:

wt ping learn.microsoft.com

Veja um exemplo de como chamar o Terminal do Windows para abrir uma nova guia com uma linha de comando do PowerShell, confirmando chamar o comando Iniciar Serviço e abrindo outra nova guia com o Prompt de Comando do Windows aberto para o /k diretório:

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

Direcionar uma janela específica

Os exemplos a seguir mostram como usar a opção --window,-w para direcionar janelas específicas.

// 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

Abrir uma nova instância de perfil

Para abrir uma nova instância de terminal, como o perfil chamado "Ubuntu-18.04", insira:

wt -p "Ubuntu-18.04"

Use o -p sinalizador para especificar o perfil do Terminal do Windows que você deseja abrir. Substitua "Ubuntu-18.04" pelo nome de qualquer perfil de terminal instalado. Esse comando sempre abre uma nova janela. Para abrir uma nova guia shell em uma instância existente (já aberta) do Terminal do Windows, use: wt -w [window id](#options-and-commands) [executable name]. Por exemplo, wt -w 0 cmd abre um shell de prompt de comando na última instância do Terminal do Windows. Se você estiver iniciando um perfil (executável de shell combinado com esquema de cores, título, comando e outras configurações que controlam como ele interage com a sessão do console), você deve usar o nome do perfil no comando: wt -w 0 -p "Profile Name".

Direcionar um diretório

Para especificar a pasta que o console usa como o diretório inicial, insira o comando a seguir. Neste exemplo, o diretório inicial é o d:\ diretório:

wt -d d:\

Várias guias

Para abrir uma nova instância de terminal com várias guias, insira:

wt ; ;

Para abrir uma nova instância de terminal com várias guias, nesse caso, um perfil de Prompt de Comando e um perfil do PowerShell, insira:

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

Vários painéis

Para abrir uma nova instância de terminal com uma guia contendo três painéis executando um perfil de Prompt de Comando, um perfil do PowerShell e seu perfil padrão executando uma linha de comando WSL, insira:

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

O -H sinalizador (ou --horizontal) indica que você deseja que os painéis sejam divididos horizontalmente. O -V sinalizador (ou --vertical) indica que você deseja que os painéis se dividam verticalmente.

Várias guias e painéis

Seqüencie os comandos new-tab e split-pane para obter várias guias, cada uma com painéis divididos. Para abrir uma nova instância de terminal com duas guias, cada uma com dois painéis executando um Prompt de Comando e uma linha de comando WSL, com cada guia em um diretório diferente, insira:

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

Título do painel

Para abrir uma nova instância de terminal com títulos personalizados para cada painel de terminal, use o --title argumento. Para definir o título de cada painel ao abrir várias guias, insira:

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

Os painéis na mesma guia podem ter títulos diferentes. O título da guia reflete o título do painel que tem foco. Para nomear painéis independentes, defina o título depois de dividir os painéis inserindo:

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

Usando o título do aplicativo

Para abrir uma nova instância de terminal que permite que os aplicativos definam o título da guia enviando mensagens de alteração de título, use o --useApplicationTitle sinalizador. Para suprimir essas mensagens, use o --suppressApplicationTitle sinalizador. Se você não fornecer nenhum sinalizador, o terminal usará as configurações do perfil. Para abrir uma guia com o título tabname que o aplicativo não pode substituir, insira:

wt --title tabname --suppressApplicationTitle

Cor da guia

Para abrir uma nova instância de terminal com cores de guia personalizadas, use o --tabColor argumento. Esse argumento substitui o valor definido no perfil, mas o seletor de cores de guia também pode substituí-lo. No exemplo a seguir, um novo terminal é criado com duas guias de cores diferentes:

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

Ao definir --tabColor uma guia, associe-a ao primeiro painel dessa guia. Portanto, em uma guia com vários painéis, a cor será aplicada somente se o primeiro painel estiver em foco. Para definir a cor da guia para painéis adicionais, você também precisa adicionar o --tabColor parâmetro ao split-pane subcomando. No exemplo abaixo, uma guia com dois painéis é criada com cores de guia especificadas para cada painel:

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

Esquema de cores

Para abrir uma nova instância de terminal com um esquema de cores específico (em vez do colorScheme conjunto no perfil), use o --colorScheme argumento. Esse argumento substitui o valor definido no perfil.

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

Foco da guia

Para abrir uma nova instância de terminal com uma guia específica em foco, use o -t sinalizador (ou --target), juntamente com o número de índice de tabulação. Para abrir o perfil padrão na primeira guia e o perfil "Ubuntu-18.04" focado na segunda guia (-t 1), insira:

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

Exemplos de vários comandos do PowerShell

O Terminal do Windows usa o caractere ; ponto-e-vírgula como um delimitador para separar comandos na wt linha de comando. Infelizmente, o PowerShell também usa ; como separador de comandos. Para contornar esse problema, use os truques a seguir para executar vários wt comandos do PowerShell. Em todos os exemplos a seguir, uma nova janela de terminal é criada com três painéis : um executando o Prompt de Comando, um com o PowerShell e o último executando o WSL.

Os exemplos a seguir não usam start para executar a linha de comando. Em vez disso, eles usam dois outros métodos de escape da linha de comando:

  • Apenas escapando dos ponto-e-vírgula para que o PowerShell os ignore e passe-os diretamente para wt.
  • Usando --%, portanto, o PowerShell trata o restante da linha de comando como argumentos para o aplicativo.
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

Em ambos os exemplos, a janela do Terminal do Windows recém-criada analisa corretamente todos os argumentos de linha de comando fornecidos.

No entanto, esses métodos não são recomendados no momento. O PowerShell aguarda o fechamento da janela do terminal recém-criado antes de retornar o controle ao PowerShell. Por padrão, o PowerShell sempre aguarda o fechamento de aplicativos da Windows Store (como o Terminal do Windows) antes de retornar ao prompt. Esse comportamento é diferente do comportamento do Prompt de Comando, que retorna ao prompt imediatamente.

Adicionar executável do Terminal do Windows ao SEU PATH

Para adicionar o arquivo executável do Terminal do Windows (wt.exe) ao SEU PATH, habilite seu "alias de execução de aplicativo" na página Gerenciar aliases de execução do aplicativo das Configurações do Windows. O alias do Terminal do Windows está ativado por padrão, mas talvez você queira confirmá-lo se estiver tendo problemas para acessá-lo.

Se você ainda estiver tendo problemas para acessar aliases de execução do aplicativo, verifique se o PATH contém: %LOCALAPPDATA%\Microsoft\WindowsApps. Não tente fazer alterações em C:\Program Files\WindowsApps.

Configurações do Windows para aliases de execução de aplicativo

  • Last updated on