Partilhar via


Aliases de Consola

Importante

Este documento descreve a funcionalidade da plataforma de console que não faz mais parte do nosso roteiro de ecossistema. Não recomendamos o uso deste 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 multiplataforma. Você pode encontrar mais informações sobre essa decisão de design em nosso documento clássico de console 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". Quando você digita "test" na linha de comando, o subsistema do 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:

teste doskey=cd \a_very_long_path\test

A seguinte chamada 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 usando Doskey.exeo , use os parâmetros $1 de lote através do $9. Para obter mais informações sobre os códigos especiais que podem ser usados em definições de macro Doskey, consulte a ajuda da linha de comando ou Doskey.exeDoskey no TechNet.

Todas as instâncias de um arquivo executável em execução na mesma janela do console compartilham quaisquer aliases de console definidos. Várias instâncias do mesmo arquivo executável em execução em janelas de console diferentes não compartilham aliases de console. Diferentes arquivos executáveis em execução na mesma janela do console não compartilham aliases de console.

Para recuperar a cadeia de caracteres de destino para 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 os aliases de console foram definidos, use a função GetConsoleAliasExes .