Compartilhar via

Configurações de perfil geral no Terminal do Windows

  • Artigo

As configurações listadas abaixo são específicas para cada perfil exclusivo. Se você quiser que uma configuração se aplique a todos os seus perfis, adicione-a à seção defaults acima da lista de perfis no arquivo settings.json.

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

Ordenação de Perfil

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

Nome

Esse é o nome do perfil que será exibido no menu suspenso. Esse valor também é usado 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 durante o tempo de vida do aplicativo. Esse comportamento de "título" pode ser substituído usando tabTitle.

Nome da propriedade: name

Necessidade: Necessária

Aceita: Cadeia de caracteres


Linha de comando

Esse é o executável usado no perfil.

Nome da propriedade: commandline

Necessidade: Opcional

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

Valor padrão: "cmd.exe"

Exemplo: para executar um arquivo em lotes sempre que cmd.exe for executado, defina esse valor como "cmd.exe /k path\to\script.bat"


Diretório inicial

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

Nome da propriedade: startingDirectory

Necessidade: Opcional

Aceita: Localização da pasta como uma cadeia de caracteres

Valor padrão: "%USERPROFILE%"

NOTA: 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, você obterá resultados diferentes dependendo de onde iniciar o Terminal.

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

Exemplo com WSL: ao definir o diretório inicial de uma distribuição do Linux instalada por meio do WSL, use o formato: "startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME", substituindo os espaços reservados pelos nomes adequados da sua distribuição. Por exemplo, "startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1". Se você estiver usando a interface do usuário de Configurações do Terminal do Windows, em vez do arquivo settings.json, para declarar esse caminho, poderá usar o botão Procurar... para selecionar o diretório inicial ou inserir o caminho do 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 for especificado, você obterá resultados diferentes dependendo de onde você iniciar o Terminal:

  • Se você executar o Terminal do Windows no menu Iniciar: %WINDIR%\System32
  • Se você executar wt.exe no menu Iniciar: %WINDIR%\System32
  • Se você executar o wt.exe a partir de Win+R: %USERPROFILE%
  • Se você executar wt.exe na barra de endereços do Explorer: qualquer pasta que você esteja examinando.

Observação

As barras invertidas precisam ser seguidas por caracteres de escape. Por exemplo, C:\Users\USERNAME\Documents deve ser inserido como C:\\Users\\USERNAME\\Documents.

ícone

Isso define o ícone exibido dentro da guia, no menu suspenso, na lista de atalhos e no alternador de guias.

Nome da propriedade: icon

Necessidade: Opcional

Aceita: localização do arquivo como uma cadeia de caracteres ou um emoji

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


___

Título da guia

Se definido, 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 durante o tempo de vida do aplicativo. Se você quiser saber como fazer com que o Shell defina seu título, visite o tutorial de título da guia.

Nome da propriedade: tabTitle

Necessidade: opcional

Aceita: Cadeia de caracteres


___

Executar automaticamente como Administrador

Se definido, esse perfil será aberto automaticamente em uma janela com privilégios elevados (em execução como Administrador) por padrão. Se você executar esse perfil de uma janela sem privilégios elevados, uma janela de terminal com privilégios elevados será criada para hospedar esse perfil. Se você iniciar esse perfil em uma janela que já tem privilégios elevados, ele será aberto como uma nova guia.

Quando essa propriedade for definida como false, abrir esse perfil em uma janela com privilégios elevados não iniciará uma janela sem privilégios para hospedar esse perfil. O perfil será simplesmente aberto na janela com privilégios elevados, em execução como Administrador.

Se você definir essa propriedade em profiles.defaults, todos os perfis serão iniciados como Administrador por padrão, a menos que isso seja substituído definindo especificamente essa configuração como false.

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

Guias com e sem privilégios elevados não podem existir na mesma janela do terminal. Para obter mais detalhes, confira as Perguntas frequentes.

Nome da propriedade: elevate

Necessidade: Opcional

Aceita: true e false

Valor padrão: false


___

Ocultar perfil do menu suspenso

Se hidden for definido como true, o perfil não será exibido 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 e false

Valor padrão: false