Alias de la consola

Importante

En este documento se describe la funcionalidad de la plataforma de consola que ya no forma parte de nuestra hoja de ruta del ecosistema. No se recomienda usar este contenido en nuevos productos, pero seguiremos admitiendo los usos existentes para un futuro indefinido. Nuestra solución moderna preferida se centra en secuencias de terminal virtual para lograr la máxima compatibilidad en escenarios multiplataforma. Puede encontrar más información sobre esta decisión de diseño en nuestro documento de la consola clásica frente al terminal virtual.

Los alias de consola se usan para asignar cadenas de origen a cadenas de destino. Por ejemplo, puede definir un alias de consola que asigne "test" a "cd \a_very_long_path\test". Al escribir "test" en la línea de comandos, el subsistema de consola expande el alias y ejecuta el comando cd especificado.

Para definir un alias de consola, use Doskey.exe para crear una macro o use la función AddConsoleAlias. En el ejemplo siguiente se usa Doskey.exe:

doskey test=cd \a_very_long_path\test

La siguiente llamada a AddConsoleAlias crea el mismo alias de consola:

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

Para agregar parámetros a una macro de alias de consola mediante Doskey.exe, use los parámetros por lotes $1 a través de $9. Para obtener más información sobre los códigos especiales que se pueden usar en las definiciones de macro de Doskey, consulte la ayuda de la línea de comandos para Doskey.exe o Doskey en TechNet.

Todas las instancias de un archivo ejecutable que se ejecute en la misma ventana de consola comparten los alias de consola definidos. Varias instancias de un mismo archivo ejecutable que se ejecute en una ventana de consola diferente no comparten los alias de consola. Diferentes archivos ejecutables que se ejecuten en la misma ventana de consola no comparten los alias de consola.

Para recuperar la cadena de destino de una cadena de origen y un archivo ejecutable especificados, use la función GetConsoleAlias. Para recuperar todos los alias de un archivo ejecutable especificado, use la función GetConsoleAliases. Para recuperar los nombres de todos los alias para los que se han definido los alias de consola, use la función GetConsoleAliasExes.