Configurações de inicialização no Terminal do Windows
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 e 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" e "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" e "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 argumento de linha de --window,-w window 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" e "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 quex,yse encontra."initialPosition": "x,y","centerOnLaunch": true,"launchMode": "maximized": maximizado no monitor em quex,yse encontra (centerOnLaunchnã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 (centerOnLaunchnão adiciona nada).
Nome da propriedade: centerOnLaunch
Necessidade: Opcional
Aceita: true e 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 e false
Valor padrão: false
Windows Terminal