Alias di console

Importante

Questo documento descrive le funzionalità della piattaforma della console che non fanno più parte della roadmap dell'ecosistema. Non è consigliabile usare questo contenuto nei nuovi prodotti, ma continueremo a supportare gli utilizzi esistenti per il futuro indefinito. La soluzione moderna preferita è incentrata sulle sequenze di terminale virtuale per garantire la massima compatibilità negli scenari multipiattaforma. Per altre informazioni su questa decisione di progettazione, vedere il documento relativo alla console classica e al terminale virtuale.

Gli alias della console vengono usati per eseguire il mapping delle stringhe di origine alle stringhe di destinazione. Ad esempio, è possibile definire un alias della console che esegue il mapping di "test" a "cd \a_very_long_path\test". Quando si digita "test" nella riga di comando, il sottosistema della console espande l'alias ed esegue il comando cd specificato.

Per definire un alias della console, usare Doskey.exe per creare una macro oppure utilizzare la funzione AddConsoleAlias. Nell'esempio seguente viene usato Doskey.exe:

doskey test=cd \a_very_long_path\test

La chiamata seguente a AddConsoleAlias crea lo stesso alias della console:

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

Per aggiungere parametri a una macro alias della console usando Doskey.exe, usare i $1 parametri batch tramite $9. Per altre informazioni sui codici speciali che possono essere usati nelle definizioni di macro Doskey, vedere la Guida della riga di comando per Doskey.exe o Doskey in TechNet.

Tutte le istanze di un file eseguibile in esecuzione nella stessa finestra della console condividono tutti gli alias della console definiti. Più istanze dello stesso file eseguibile in esecuzione in diverse finestre della console non condividono gli alias della console. I file eseguibili diversi in esecuzione nella stessa finestra della console non condividono gli alias della console.

Per recuperare la stringa di destinazione per una stringa di origine e un file eseguibile specificati, usare la funzione GetConsoleAlias. Per recuperare tutti gli alias per un file eseguibile specificato, usare la funzione GetConsoleAliases. Per recuperare i nomi di tutti gli alias per i quali sono stati definiti gli alias della console, usare la funzione GetConsoleAliasExes.