Configurações de inicialização no Terminal do Windows

  • Artigo

As propriedades listadas abaixo afetam toda a janela do terminal, independentemente das configurações de perfil. Elas devem ser colocadas na raiz do arquivo settings.json.

Perfil padrão

Defina o perfil padrão que é aberto digitando Ctrl+Shift+T, digitando a associação de teclas atribuída a newTab, executando wt new-tab sem especificar um perfil ou clicando no ícone '+'.

Nome da propriedade:defaultProfile

Necessidade: Necessária

Aceita: GUID ou nome do perfil como uma cadeia de caracteres

Valor padrão: GUID do PowerShell


Aplicativo de terminal padrão

Defina o emulador de terminal padrão no Windows dentro do qual todos os aplicativos de linha de comando serão executados.

Nome da propriedade: isso modifica uma configuração do sistema operacional e não tem um nome de propriedade dentro do arquivo settings.json.

Necessidade: Necessária

Aceita: qualquer emulador de terminal que aparece na lista suspensa

Valor padrão: Host do Console do Windows

Importante

Esse recurso só está disponível durante a execução do Canal do Desenvolvedor do Programa Insider do Windows 10 ou do Windows 11.


Iniciar na inicialização do computador

Quando definido como true, isso permite iniciar o Terminal do Windows na inicialização. Definir isso como false desabilitará a entrada da tarefa de inicialização.

Observação: se a entrada da tarefa de inicialização do Terminal do Windows for desabilitada pela política da organização ou por ação do usuário, essa configuração não terá efeito.

Nome da propriedade:startOnUserLogin

Necessidade: Opcional

Aceita:true, false

Valor padrão:false


Comportamento ao iniciar uma nova sessão de terminal

Quando definido como "defaultProfile", o Terminal do Windows iniciará uma nova sessão abrindo uma só guia com seu perfil padrão.

Quando definido como "persistedWindowLayout", isso permite que o Terminal do Windows salve o layout de janelas abertas ao fechar e restaure todas as janelas salvas ao iniciar uma nova sessão. O Terminal do Windows salvará o layout de todas as janelas abertas automaticamente para auxiliar na restauração de falhas e também salvará o layout ao usar a ação quit. Além disso, fechar a última janela aberta clicando no botão X ou usando o comando closeWindow salvará o layout dessa última janela.

Observação: no momento, o Terminal do Windows salvará as seguintes informações:

  • A posição, o tamanho e o nome de cada janela

  • O layout da guia de cada janela, incluindo o layout e o perfil de cada painel, mas não o conteúdo desses painéis

  • Se o shell estiver configurado para relatar o diretório de trabalho atual, ele também será salvo

Nome da propriedade:firstWindowPreference

Necessidade: Opcional

Aceita:"defaultProfile", "persistedWindowLayout"

Valor padrão:"defaultProfile"


Modo de inicialização

Isso define se o terminal será iniciado maximizado, em tela inteira ou em uma janela. Definir como focus é equivalente a iniciar o terminal no modo default, mas com o modo de foco habilitado. De maneira semelhante, definir como maximizedFocus resultará na inicialização do terminal em uma janela maximizada com o modo de foco habilitado.

Nome da propriedade:launchMode

Necessidade: Opcional

Aceita:"default", "maximized", "fullscreen", "focus", "maximizedFocus"

Valor padrão:"default"


Comportamento da nova instância

Essa configuração controla como novas instâncias de terminal são anexadas a janelas existentes. Essa propriedade só será usada se o --window,-w windowargumento de linha de comando não for fornecido. Essa configuração aceita os seguintes valores possíveis:

  • useNew: criar uma janela, sempre. É assim que o terminal sempre se comportou antes da versão 1.7.
  • useExisting: criar guias na janela usada mais recentemente nesta área de trabalho. Se não houver uma janela nessa área de trabalho virtual, criar uma janela de terminal.
  • useAnyExisting: criar guias na janela usada mais recentemente, independentemente da área de trabalho virtual na qual a janela está.

Nome da propriedade:windowingBehavior

Necessidade: Opcional

Aceita:"useNew", "useExisting", "useAnyExisting"

Valor padrão:"useNew"


Tamanho ao iniciar

Colunas na primeira inicialização

Este é o número de colunas de caracteres exibidas na janela após o primeiro carregamento. Quando launchMode é definido como "maximized" ou "maximizedFocus", essa propriedade é ignorada.

Nome da propriedade:initialCols

Necessidade: Opcional

Aceita: Inteiro

Valor padrão:120

Linhas na primeira inicialização

Este é o número de linhas exibidas na janela após o primeiro carregamento. Quando launchMode é definido como "maximized" ou "maximizedFocus", essa propriedade é ignorada.

Nome da propriedade:initialRows

Necessidade: Opcional

Aceita: Inteiro

Valor padrão:30


Posição de inicialização

Isso define a posição de pixel do canto superior esquerdo da janela após o primeiro carregamento. Em um sistema com vários monitores, essas coordenadas são relativas à parte superior esquerda da tela primária. Se uma coordenada X ou Y não for fornecida, o terminal usará o padrão do sistema para esse valor. Se launchMode for definido como "maximized" ou "maximizedFocus", a janela será maximizada no monitor especificado por essas coordenadas.

Nome da propriedade:initialPosition

Necessidade: Opcional

Aceita: Coordenadas em uma cadeia de caracteres nos seguintes formatos: ",", "#,#", "#," e ",#"

Valor padrão:","


Centralizar na inicialização

Quando definido como true, a janela do terminal será automaticamente centralizada na exibição em que abrir. O terminal usará o "initialPosition" para determinar qual exibição será aberta.

Isso interage com as outras configurações de inicialização das seguintes maneiras:

  • "initialPosition": "x,y", "centerOnLaunch": true, "launchMode": "default": centralizar no monitor em que x,y se encontra.
  • "initialPosition": "x,y", "centerOnLaunch": true, "launchMode": "maximized": maximizado no monitor em que x,y se encontra (centerOnLaunch não adiciona nada).
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "default": centralizar no monitor padrão.
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "focus": centralizar e entrar no modo de foco no monitor padrão.
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "maximized": maximizado no monitor padrão (centerOnLaunch não adiciona nada).

Nome da propriedade:centerOnLaunch

Necessidade: Opcional

Aceita:true, false

Valor padrão:false


Desabilitar os perfis dinâmicos

Isso define quais geradores de perfis dinâmicos estão desabilitados, impedindo que eles adicionem os respectivos perfis à lista de perfis na inicialização. Para obter informações sobre perfis dinâmicos, visite a página Perfis dinâmicos.

Nome da propriedade:disabledProfileSources

Necessidade: Opcional

Aceita:"Windows.Terminal.Wsl", "Windows.Terminal.Azure", "Windows.Terminal.PowershellCore" e/ou "Windows.Terminal.SSH" dentro de uma matriz

Valor padrão:[]


Ações de inicialização

Isso define a lista de ações a ser executada na inicialização, permitindo que o terminal seja inicializado com um conjunto personalizado de guias e painéis por padrão. Essas ações serão aplicadas somente se nenhum argumento de linha de comando tiver sido fornecido. A lista de ações é representada por uma cadeia de caracteres com o mesmo formato que os comandos nos argumentos de linha de comando. Para obter mais informações sobre o formato de comandos, visite a página Argumentos de linha de comando.

Nome da propriedade:startupActions

Necessidade: Opcional

Aceita: cadeia de caracteres que representa uma lista de comandos a executar

Valor padrão:""


Continuar com a execução em segundo plano (versão prévia)

Quando definido como true, isso permite que o terminal continue com a execução em segundo plano após o fechamento da última janela. Isso permite que o modo terremoto globalSummon e funcione mesmo quando nenhuma janela está aberta. Essa configuração só está disponível em compilações de pré-visualização do Terminal.

Nome da propriedade:compatibility.allowHeadless

Necessidade: Opcional

Aceita:true, false

Valor padrão:false