Partager via


Alias d’une console

Important

Ce document décrit les fonctionnalités de la plateforme de la console qui ne font plus partie de la feuille de route de notre écosystème. Nous vous déconseillons d’utiliser ce contenu dans de nouveaux produits, mais nous continuerons à prendre en charge des utilisations existantes pour l’avenir indéterminé. Notre solution moderne préférée se concentre sur les séquences de terminaux virtuels pour une compatibilité maximale dans les scénarios multiplateformes. Vous trouverez plus d’informations sur cette décision de conception dans notre document sur les consoles classiques et les terminaux virtuels.

Les alias de console sont utilisés pour mapper des chaînes sources à des chaînes cibles. Par exemple, vous pouvez définir un alias de console qui mappe « test » à « cd \a_very_long_path\test ». Lorsque vous entrez « test » sur la ligne de commande, le sous-système de console développe l’alias et exécute la commande cd spécifiée.

Pour définir un alias de console, utilisez Doskey.exe pour créer une macro ou utilisez la fonction AddConsoleAlias. L'exemple suivant utilise Doskey.exe :

doskey test=cd \a_very_long_path\test

L’appel suivant à la fonction AddConsoleAlias crée le même alias de console :

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

Pour ajouter des paramètres à une macro d’alias de console à l’aide de Doskey.exe, utilisez les paramètres de lot $1 via $9. Pour plus d’informations sur les codes spéciaux qui peuvent être utilisés dans les définitions de macro Doskey, consultez l’aide de ligne de commande pour Doskey.exe ou Doskey sur TechNet.

Toutes les instances d’un fichier exécutable s’exécutant dans la même fenêtre de console partagent tous les alias de console définis. Plusieurs instances du même fichier exécutable s’exécutant dans différentes fenêtres de console ne partagent pas d’alias de console. Différents fichiers exécutables s’exécutant dans la même fenêtre de console ne partagent pas d’alias de console.

Pour récupérer la chaîne cible d’une chaîne source et d’un fichier exécutable spécifiés, utilisez la fonction GetConsoleAlias. Pour récupérer tous les alias d'un fichier exécutable spécifié, utilisez la fonction GetConsoleAliases. Pour récupérer les noms de tous les alias pour lesquels des alias de console ont été définis, utilisez la fonction GetConsoleAliasExes.