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

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