Aliases de console

Importante

Este documento descreve a funcionalidade da plataforma do console que não faz mais parte do nosso roteiro de ecossistema. Não recomendamos o uso desse conteúdo em novos produtos, mas continuaremos a oferecer suporte aos usos existentes por tempo indeterminado. Nossa solução moderna preferida se concentra em sequências de terminais virtuais para máxima compatibilidade em cenários de multiplataforma. Você pode encontrar mais informações sobre essa decisão de design em nosso documento Console clássico versus terminal virtual.

Os aliases de console são usados para mapear cadeias de caracteres de origem para cadeias de caracteres de destino. Por exemplo, você pode definir um alias de console que mapeia "test" para "cd \a_very_long_path\test". Ao digitar "test" na linha de comando, o subsistema de console expande o alias e executa o comando cd especificado.

Para definir um alias de console, use Doskey.exe para criar uma macro ou use a função AddConsoleAlias. O exemplo a seguir usa Doskey.exe:

doskey test=cd \a_very_long_path\test

A chamada a seguir para AddConsoleAlias cria o mesmo alias de console:

AddConsoleAlias( TEXT("test"),
                 TEXT("cd \\<a_very_long_path>\\test"),
                 TEXT("cmd.exe"));

Para adicionar parâmetros a uma macro de alias de console com Doskey.exe, use os parâmetros $1 em lote por meio do $9. Para mais informações sobre os códigos especiais que podem ser usados em definições de macro Doskey, consulte a ajuda de linha de comando para Doskey.exe ou Doskey no TechNet.

Todas as instâncias de um arquivo executável em execução na mesma janela do console compartilham os aliases de console definidos. Múltiplas instâncias do mesmo arquivo executável em execução em janelas de console diferentes não compartilham aliases de console. Arquivos executáveis diferentes em execução na mesma janela do console não compartilham aliases do console.

Para recuperar a cadeia de caracteres de destino de uma cadeia de caracteres de origem especificada e um arquivo executável, use a função GetConsoleAlias. Para recuperar todos os aliases de um arquivo executável especificado, use a função GetConsoleAliases. Para recuperar os nomes de todos os aliases para os quais foram definidos aliases de console, use a função GetConsoleAliasExes.