Como usar argumentos de linha de comando para terminal do Windows

Você pode usar wt.exe para abrir uma nova instância do Terminal do Windows por meio da linha de comando. Você também pode usar o alias de execução wt em vez disso.

Observação

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

Sintaxe de linha de comando

A linha de comando wt aceita dois tipos de valores: opções e comandos. As opções são uma lista de sinalizadores e outros parâmetros que podem controlar o comportamento da linha de comando wt como um todo. Os comandos fornecem a ação ou a lista de ações separadas por ponto e vírgula que devem ser implementadas. Se nenhum comando for especificado, o comando será considerado como new-tab por padrão.

wt [options] [command ; ]

Observação

O comportamento do comando wt.exe pode ser afetado pela propriedade windowingBehavior. Essa configuração pode ser ajustada como padrão entre abrir uma nova janela ou abrir uma nova guia.

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

Opções e comandos

Abaixo, temos a lista completa de comandos e opções compatíveis com a linha de comando wt.

Opção	Descrição
--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 parâmetro --window pode ser usado para enviar comandos a 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 executar este comando em uma nova janela
• last ou 0: sempre executar este comando na última janela usada

Se não existir nenhuma janela com o window-id fornecido, uma janela será criada com a mesma ID e o mesmo nome.

Por exemplo, a execução de wt -w _quake abrirá uma nova "janela no modo quake". Uma nova execução desse comando abrirá uma nova guia na janela no modo quake existente.

Comando nova guia

Usado para criar uma guia. Veja também a ação newTab.

Comando	Parâmetro	Descrição	Valores
new-tab, nt	--profile, -p profile-name	Cria uma guia com base no nome do perfil atribuído.	Nome do perfil
new-tab, nt	--startingDirectory, -d starting-directory	Cria uma guia com base no caminho do diretório inicial atribuído.	Caminho do diretório
new-tab, nt	commandline	Cria uma guia com base na linha de comando atribuída.	Executável com comandos opcionais
new-tab, nt	--title	Cria uma guia com o título atribuído.	Texto a ser usado como o título da guia
new-tab, nt	--tabColor	Cria uma guia com a cor da guia atribuída.	Cor hexa como #RGB ou #RRGGBB
new-tab, nt	--suppressApplicationTitle	Substituir a configuração suppressApplicationTilte do perfil e defini-la como true
new-tab, nt	--useApplicationTitle	Substituir a configuração suppressApplicationTilte do perfil e defini-la como false
new-tab, nt	--colorScheme scheme-name	Substituir a configuração colorScheme do perfil e defini-la como o esquema das configurações com o nome scheme-name	O nome de um esquema de cores nas configurações

Dica

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

Comando dividir painel

Usado para criar um painel dividido. Veja também a ação splitPane.

Comando	Parâmetro	Descrição	Valores
split-pane, sp	-H, --horizontal, -V, --vertical	Cria um painel de janela dividida horizontal ou verticalmente.	N/D Nenhum valor adicional a ser atribuído.
split-pane, sp	--profile, -p profile-name	Cria um painel de janela dividida com base no perfil de linha de comando atribuído. Se esse parâmetro não for atribuído, o perfil padrão será usado.	Nome do perfil
split-pane, sp	--startingDirectory, -d starting-directory	Cria um painel de janela dividida com base no caminho do diretório inicial atribuído. Se esse parâmetro não for atribuído, o diretório inicial padrão será usado.	Caminho do diretório
split-pane, sp	--title	Cria um 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 painel de janela dividida com a cor de guia atribuída.	Cor hexa como #RGB ou #RRGGBB
split-pane, sp	--size, -s size	Cria um 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 painel de janela dividida com base na linha de comando atribuída.	Executável com comandos opcionais
split-pane, sp	--duplicate, -D	Cria um painel de janela dividida que é uma duplicata do painel atual.	N/D Nenhum valor adicional a ser atribuído.
split-pane, sp	--suppressApplicationTitle	Substituir a configuração suppressApplicationTilte do perfil e defini-la como true
split-pane, sp	--useApplicationTitle	Substituir a configuração suppressApplicationTilte do perfil e defini-la como false
split-pane, sp	--colorScheme scheme-name	Substituir a configuração colorScheme do perfil e defini-la como o esquema das configurações com o nome scheme-name	O nome de um esquema de cores nas configurações

Comando focar guia

Usado para focalizar uma guia específica dentro da janela. Veja também a ação switchToTab.

Comando	Parâmetro	Descrição	Valores
focus-tab, ft	--target, -t tab-index	Volta o foco para uma guia específica de acordo com seu número no índice de guias.	Índice de guias como um inteiro

Comando mover foco

Usado para mover o foco dentro da janela. Veja também a ação moveFocus.

Comando	Parâmetro	Descrição	Valores
move-focus, mf	<direction>	Move o foco entre painéis.	Veja abaixo os valores de direction aceitos

Valores de direction aceitos

• up, down, left ou right movem o foco na direção determinada.
• first move o foco para o primeiro painel folha na árvore.
• previous move o foco para o último painel usado antes do painel atual.
• nextInOrder, previousInOrder movem o foco para o painel seguinte ou anterior na ordem de criação.

Comando move-pane

Usado para mover um painel dentro da janela. Veja também a ação movePane.

Comando	Parâmetro	Descrição	Valores
move-pane, mp	--tab,-t <index>	Mover o painel ativo para a guia fornecida na janela	O índice indexado em zero da guia para a qual o painel deve ser movido.

Comando swap-pane

Usado para trocar a posição de dois painéis dentro da janela. Veja também a ação swapPane.

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

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

• up, down, left ou right: trocar o painel ativo pelo que está na direção determinada.
• first: trocar o painel ativo pelo primeiro painel folha na árvore.
• previous: trocar o painel ativo pelo último painel usado antes do painel atual.
• nextInOrder, previousInOrder: trocar o painel ativo pelo painel seguinte ou anterior na ordem de criação.

Exemplos de argumentos de linha de comando

Os comandos podem variar um pouco dependendo da linha de comando que você está usando.

Passando um argumento para o shell padrão

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

Veja um exemplo de chamada para 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 chamada para o Terminal do Windows para abrir uma nova guia com uma linha de comando do PowerShell, confirmar a chamada para o comando Start-Service e abrir outra guia com o Prompt de Comando do Windows aberto no diretório /k:

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

Direcionar a uma janela específica

Abaixo estão exemplos de como direcionar janelas específicas usando a opção --window,-w.

Prompt de comando

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

PowerShell

// 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 then, create a new window named foo.
wt -w foo nt

Linux

// Open a new tab with the default profile in the current window
cmd.exe /c "wt.exe" -w 0 nt

// Open a new tab in a new window with the default profile
cmd.exe /c "wt.exe" -w -1 nt

// Open a new tab in the first-created terminal window with the default profile
cmd.exe /c "wt.exe" -w 1 nt

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

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c informa ao CMD para encerrar após a execução.

Abrir uma nova instância de perfil

Para abrir uma nova instância de terminal (nesse caso o comando abrirá o perfil chamado "Ubuntu-18.04"), digite:

Prompt de comando

wt -p "Ubuntu-18.04"

PowerShell

wt -p "Ubuntu-18.04"

Linux

cmd.exe /c "wt.exe" -p "Ubuntu-18.04"

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c informa ao CMD para encerrar após a execução.

O sinalizador -p é usado para especificar o perfil do Terminal do Windows que deve ser aberto. Substitua "Ubuntu-18.04" pelo nome de um perfil de terminal que você tenha instalado. Isso sempre abrirá uma nova janela. O Terminal do Windows ainda não é capaz de abrir novas guias ou painéis em uma instância existente.

Direcionar a um diretório

Para especificar a pasta que deve ser usada como o diretório inicial para o console, que neste caso é o diretório d:\, digite:

Prompt de comando

wt -d d:\

PowerShell

wt -d d:\

Linux

cmd.exe /c "wt.exe" -d d:\

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c informa ao CMD para encerrar após a execução.

Várias guias

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

Prompt de comando

wt ; ;

PowerShell

wt `; `;

O PowerShell usa um ponto e vírgula (;) para delimitar instruções. Para interpretar um ponto e vírgula (;) como um delimitador de comandos para argumentos de linha de comando do Terminal do Windows, você precisa escapar caracteres de ponto e vírgula usando caracteres de acento grave. O PowerShell também tem o operador de interrupção de análise (--%), que o instrui a interromper qualquer interpretação depois dele e apenas passá-la como uma cadeia de caracteres verbatim.

Linux

cmd.exe /c "wt.exe" \; \;

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c informa ao CMD para encerrar após a execução.

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, digite:

Prompt de comando

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

PowerShell

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

O PowerShell usa um ponto e vírgula (;) para delimitar instruções. Para interpretar um ponto e vírgula (;) como um delimitador de comandos para argumentos de linha de comando do Terminal do Windows, você precisa escapar caracteres de ponto e vírgula usando caracteres de acento grave. O PowerShell também tem o operador de interrupção de análise (--%), que o instrui a interromper qualquer interpretação depois dele e apenas passá-la como uma cadeia de caracteres verbatim.

Linux

cmd.exe /c "wt.exe" -p "Command Prompt" \; new-tab -p "Windows PowerShell"

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c instrui o CMD a terminar após a execução, e a barra invertida \; + ponto e vírgula separa os comandos.

Vários painéis

Para abrir uma nova instância de terminal com uma guia que contém três painéis que executam um perfil de prompt de comando, um perfil do PowerShell e seu perfil padrão executando uma linha de comando do WSL, digite:

Prompt de comando

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

PowerShell

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

O PowerShell usa um ponto e vírgula (;) para delimitar instruções. Para interpretar um ponto e vírgula (;) como um delimitador de comandos para argumentos de linha de comando do Terminal do Windows, você precisa escapar caracteres de ponto e vírgula usando caracteres de acento grave. O PowerShell também tem o operador de interrupção de análise (--%), que o instrui a interromper qualquer interpretação depois dele e apenas passá-la como uma cadeia de caracteres verbatim.

Linux

cmd.exe /c "wt.exe" -p "Command Prompt" \; split-pane -p "Windows PowerShell" \; split-pane -H wsl.exe

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c instrui o CMD a terminar após a execução, e a barra invertida \; + ponto e vírgula separa os comandos.

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

Várias guias e painéis

Os comandos new-tab e split-pane podem ser sequenciados para obter várias guias, cada uma com painéis divididos. Para abrir uma nova instância do 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, digite:

Prompt de comando

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

PowerShell

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

O PowerShell usa um ponto e vírgula (;) para delimitar instruções. Para interpretar um ponto e vírgula (;) como um delimitador de comandos para argumentos de linha de comando do Terminal do Windows, você precisa escapar caracteres de ponto e vírgula usando caracteres de acento grave. O PowerShell também tem o operador de interrupção de análise (--%), que o instrui a interromper qualquer interpretação depois dele e apenas passá-la como uma cadeia de caracteres verbatim.

Linux

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

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c instrui o CMD a terminar após a execução, e a barra invertida \; + ponto e vírgula separa os comandos. Observação: para especificar um diretório do Windows como o diretório inicial para wsl.exe, são necessárias duas barras invertidas \\.

Título do painel

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

Prompt de comando

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

PowerShell

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

Linux

cmd.exe /c "wt.exe" --title tabname1 \; new-tab -p "Ubuntu-18.04" --title tabname2

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c informa ao CMD para terminar após a execução, e a barra \; + ponto e vírgula separa os comandos.

Os painéis na mesma guia podem ter títulos diferentes, o que refletirá sobre o título da guia, dependendo de qual painel tem foco. Para nomear painéis independentes, você pode definir o título depois de dividir os painéis inserindo:

Prompt de comando

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

PowerShell

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

Linux

cmd.exe /c "wt.exe" --title pane1 \; split-pane -p "Command Prompt" --title pane2

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c informa ao CMD para terminar após a execução, e a barra \; + ponto e vírgula separa os comandos.

Usando o bloco de aplicativo

Para abrir uma nova instância do terminal, permitindo que os aplicativos dentro dela definam o título da guia enviando mensagens de alteração de título, use o sinalizador --useApplicationTitle. Para suprimir essas mensagens, use o sinalizador --suppressApplicationTitle. Se nenhum desses sinalizadores for fornecido, o comportamento será herdado das configurações do perfil. Para abrir uma guia com título tabname que não será substituída pelo aplicativo, digite:

Prompt de comando

wt --title tabname --suppressApplicationTitle

PowerShell

wt --title tabname --suppressApplicationTitle

Linux

cmd.exe /c "wt.exe" --title tabname --suppressApplicationTitle

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c instrui o CMD a terminar após a execução, e a barra invertida \; + ponto e vírgula separa os comandos.

Cor da guia

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

Prompt de comando

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

PowerShell

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

Linux

cmd.exe /c "wt.exe" --tabColor #009999 \; new-tab --tabColor #f59218

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c instrui o CMD a terminar após a execução, e \; separa os comandos.

Quando --tabColor é definido para uma guia, ele é associado 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, também será necessário adicionar o parâmetro --tabColor ao subcomando split-pane. No exemplo a seguir, uma guia com dois painéis é criada com as cores das guias especificadas para cada painel:

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

Esquema de cores

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

Prompt de comando

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

PowerShell

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

Linux

cmd.exe /c "wt.exe" --colorScheme Vintage \; split-pane --colorScheme "Tango Light"

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c instrui o CMD a terminar após a execução, e \; separa os comandos.

Foco da guia

Para abrir uma nova instância de terminal com uma guia específica em foco, use o sinalizador -t (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" focalizado na segunda guia (-t 1), digite:

Prompt de comando

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

PowerShell

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

Linux

cmd.exe /c "wt.exe" \; new-tab -p "Ubuntu-18.04" \; focus-tab -t 1

Os aliases de execução não funcionam em distribuições do WSL. Se você quiser usar o wt.exe de uma linha de comando do WSL, poderá gerá-lo diretamente por meio do CMD executando cmd.exe. A opção /c instrui o CMD a terminar após a execução, e a barra invertida \; + ponto e vírgula separa os comandos.

Exemplos de vários comandos do PowerShell

O Terminal do Windows usa o caractere de ponto e vírgula (;) como um delimitador para separar comandos na linha de comando wt. Entretanto, o PowerShell também usa ; como um separador de comandos. Para solucionar esse erro, você pode usar os seguintes truques para executar vários comandos wt por meio do PowerShell. Em todos os exemplos a seguir, uma nova janela de terminal é criada com três painéis: um prompt de comando em execução, outro 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, há dois outros métodos para escapar a linha de comando:

• Apenas escapar pontos-e-vírgulas para que PowerShell os ignore e os transmita-os diretamente para wt.
• Usando --%, de modo que o PowerShell tratará 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 criará a janela analisando corretamente todos os argumentos de linha de comando fornecidos.

No entanto, esses métodos não são recomendados atualmente, pois o PowerShell aguardará a janela do terminal recém-criada ser fechada antes de retornar o controle ao PowerShell. Por padrão, o PowerShell sempre aguardará que os aplicativos da Microsoft Store (como o Terminal do Windows) sejam fechados antes de retornar ao prompt. Observe que isso é diferente do comportamento do prompt de comando, que retornará ao prompt imediatamente.

Adicionar o executável do Terminal do Windows ao seu CAMINHO

Para adicionar o arquivo executável do Terminal do Windows (wt.exe) ao seu CAMINHO, habilite o "alias de execução de aplicativo" na página Gerenciar alias de execução do aplicativo das Configurações do Windows. O alias do Terminal do Windows fica ativado por padrão, mas vale a pena confirmar caso esteja tendo problemas para acessá-lo.

Se você ainda estiver tendo problemas para acessar alias de execução do aplicativo, talvez seja necessário verificar se o CAMINHO contém: %LOCALAPPDATA%\Microsoft\WindowsApps. Não tente fazer alterações em C:\Program Files\WindowsApps.