Configurações gerais de perfil no Terminal do Windows

As configurações listadas abaixo são específicas para cada perfil exclusivo. Se pretender que uma definição seja aplicada a todos os seus perfis, pode adicioná-la à defaults secção acima da lista de perfis no seu ficheirosettings.json.

"defaults":
{
    // SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
    // PROFILE OBJECTS
]

Pedido de perfil

A ordem dos perfis no "list" determina a numeração do índice de perfil. Isso é usado para mapear para a combinação de teclas de inicialização, como Ctrl+Shift+1. Para alterar o número de índice do perfil, basta cortar/colar os objetos de perfil acima ou abaixo uns dos outros. O primeiro no mapeará para o "list" índice 1, portanto, será atribuído ao combo de teclas, Ctrl+Shift+1.

Nome

Este é o nome do perfil que será exibido no menu suspenso. Esse valor também é usado como o "título" para passar para o shell na inicialização. Alguns shells (como bash) podem optar por ignorar esse valor inicial, enquanto outros (Command Prompt, PowerShell) podem usar esse valor ao longo do tempo de vida do aplicativo. Esse comportamento de "título" pode ser substituído usando tabTitle.

Nome da propriedade:name

Necessidade: Necessário

Aceita: String

Linha de comando

Este é o executável usado no perfil.

Nome da propriedade:commandline

Necessidade: Opcional

Aceita: Nome do arquivo executável como uma cadeia de caracteres

Valor padrão:"cmd.exe"

Exemplo: Para executar um ficheiro batch sempre que cmd.exe é executado, defina este valor como "cmd.exe caminho /k\to\script.bat"

Diretório inicial

Este é o diretório em que o shell inicia quando é carregado.

Nome da propriedade:startingDirectory

Necessidade: Opcional

Aceita: Local da pasta como uma cadeia de caracteres

Valor padrão:"%USERPROFILE%"

OBSERVAÇÃO: Quando o diretório inicial não estiver definido, o valor padrão será definido como "%USERPROFILE%" (o caminho relativo às configurações do usuário, por exemplo, pode ser C:\Users\<your username>). No entanto, se o diretório inicial estiver explicitamente definido como null, então você obterá resultados diferentes, dependendo de onde você iniciar o Terminal.

Exemplo: Inicie o perfil do PowerShell na pasta GitHubRepos do diretório Documents localizando o perfil powershell.exe e adicionando "startingDirectory": "%USERPROFILE%/Documents/GitHubRepos",

Exemplo com WSL: Ao definir o diretório inicial para uma distribuição Linux instalada via WSL, use o formato: "startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME", substituindo os espaços reservados pelos nomes próprios da sua distribuição. Por exemplo, "startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1". Se você estiver usando a interface do usuário Configurações do Terminal do Windows, em vez do arquivosettings.json, para declarar esse caminho, poderá usar o botão Procurar... para selecionar seu diretório inicial ou inserir o caminho WSL como: //wsl.localhost/DISTRO NAME/home/USERNAME. Por exemplo, //wsl.localhost/Ubuntu-20.04/home/user1.

Comportamento padrão: Quando o valor startingDirectory não é especificado, você obterá resultados diferentes dependendo de onde você inicia o Terminal:

• Se executar o Terminal do Windows a partir do menu Iniciar: %WINDIR%\System32
• Se você executar wt.exe no menu Iniciar: %WINDIR%\System32
• Se executar wt.exe a partir do Win+R: %USERPROFILE%
• Se você executar wt.exe a partir da barra de endereço do explorador: qualquer pasta que você estava olhando.

Ícone

Isso define o ícone que é exibido dentro da guia, menu suspenso, lista de atalhos e seletor de guias.

Nome da propriedade:icon

Necessidade: Opcional

Aceita: Local do arquivo como uma cadeia de caracteres ou um emoji

Exemplo: Ao colocar a imagem ubuntu.ico do ícone na pasta localizada em %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState, você pode exibir o ícone adicionando esta linha ao perfil em seu settings.json: "icon": "ms-appdata:///roaming/ubuntu.ico".

Título do separador

Se definido, isso substituirá o name como o título a ser passado para o shell na inicialização. Alguns shells (como bash) podem optar por ignorar esse valor inicial, enquanto outros (Command Prompt, PowerShell) podem usar esse valor ao longo do tempo de vida do aplicativo. Se você quiser saber como fazer com que o shell defina seu título, visite o tutorial do título da guia.

Nome da propriedade:tabTitle

Necessidade: Opcional

Aceita: String

Executar automaticamente como Administrador

Se definido, esse perfil será aberto automaticamente em uma janela "elevada" (executando como Administrador) por padrão. Se você executar esse perfil a partir de uma janela não elevada, uma nova janela de terminal elevada será criada para hospedar esse perfil. Se você iniciar esse perfil a partir de uma janela já elevada, ele será aberto como uma nova guia.

Quando esta propriedade estiver definida como false, abrir este perfil numa janela elevada não iniciará uma janela não elevada para alojar este perfil. O perfil será simplesmente aberto na janela elevada, executando como Administrador.

Se você definir essa propriedade no profiles.defaults, todos os perfis serão iniciados como Administrador por padrão, a menos que sejam substituídos pela configuração específica como false.

Esta propriedade pode ser substituída newTab nas ações e splitPane com a elevate propriedade.

Guias elevadas e não elevadas não podem existir na mesma janela do terminal. Para mais detalhes, consulte as Perguntas frequentes.

Nome da propriedade:elevate

Necessidade: Opcional

Aceita:true, false

Valor padrão:false

Ocultar perfil da lista suspensa

Se hidden estiver definido como true, o perfil não aparecerá na lista de perfis. Isso pode ser usado para ocultar perfis padrão e perfis gerados dinamicamente, deixando-os em seu arquivo de configurações. Para saber mais sobre perfis dinâmicos, visite a página Perfis dinâmicos.

Nome da propriedade:hidden

Necessidade: Opcional

Aceita:true, false

Valor padrão:false