as, aS (Définir l’alias)

Les commandes as et aS définissent un nouvel alias ou redéfinissent un alias existant.

as Name EquivalentLine 
aS Name EquivalentPhrase 
aS Name "EquivalentPhrase" 
as /e Name EnvironmentVariable 
as /ma Name Address 
as /mu Name Address 
as /msa Name Address 
as /msu Name Address 
as /x Name Expression 
aS /f Name File 
as /c Name CommandString 

Paramètres

Nom
Spécifie le nom de l’alias. Ce nom peut être n’importe quelle chaîne de texte qui ne contient pas d’espace ou de frappe ENTRÉE et ne commence pas par « al », « as », « aS » ou « ad ». Le nom respecte la casse.

ÉquivalentLine
Spécifie l’équivalent de l’alias. EquivalentLine respecte la casse. Vous devez ajouter au moins un espace entre Name et EquivalentLine. Le nombre d’espaces entre ces deux paramètres n’est pas important. L’équivalent d’alias ne contient jamais d’espaces de début. Après ces espaces, EquivalentLine inclut le reste de la ligne. Les points-virgules, les guillemets et les espaces sont traités comme des caractères littéraux, et les espaces de fin sont inclus.

ÉquivalentPhrase
Spécifie l’équivalent de l’alias. EquivalentPhrase respecte la casse. Vous devez ajouter au moins un espace entre Name et EquivalentPhrase. Le nombre d’espaces entre ces deux paramètres n’est pas important. L’équivalent d’alias ne contient jamais d’espaces de début.

Vous pouvez placer EquivalentPhrase entre guillemets ("). Que vous utilisiez des guillemets, EquivalentPhrase peut contenir des espaces, des virgules et des guillemets simples ('). Si vous placez EquivalentPhrase entre guillemets, il peut inclure des points-virgules, mais pas des guillemets supplémentaires. Si vous ne placez pas EquivalentPhrase entre guillemets, il peut inclure des guillemets à n’importe quel emplacement autre que le premier caractère, mais il ne peut pas inclure de points-virgules. Les espaces de fin sont inclus, que vous utilisiez des guillemets.

/e
Définit l’alias équivalent à la variable d’environnement spécifiée par EnvironmentVariable .

EnvironmentVariable
Spécifie la variable d’environnement utilisée pour déterminer l’équivalent de l’alias. L’environnement du débogueur est utilisé, et non pas celui de la cible. Si vous avez démarré le débogueur dans une fenêtre d’invite de commandes, les variables d’environnement de cette fenêtre sont utilisées.

/maman
Définit l’alias équivalent à la chaîne ASCII terminée par null qui commence à l’adresse.

/mu
Définit l’alias équivalent à la chaîne Unicode terminée par null qui commence à l’adresse.

/Msa
Définit l’alias équivalent à la structure ANSI_STRING située à l’adresse.

/msu
Définit l’alias équivalent à la structure UNICODE_STRING située à l’adresse.

Adresse
Spécifie l’emplacement de la mémoire virtuelle utilisée pour déterminer l’équivalent de l’alias.

/x
Définit l’alias équivalent à la valeur 64 bits de l’expression.

Expression
Indique l’expression à évaluer. Cette valeur devient l’équivalent de l’alias. Pour plus d’informations sur la syntaxe, consultez la syntaxe d’expression numérique.

/f
Définit l’alias équivalent au contenu du fichier fichier . Vous devez toujours utiliser le commutateur /f avec aS, et non pas comme.

Fichier
Spécifie le fichier dont le contenu devient l’équivalent de l’alias. Le fichier peut contenir des espaces, mais vous ne devez jamais placer le fichier entre guillemets. Si vous spécifiez un fichier non valide, vous recevez un message d’erreur « Hors mémoire ».

/c
Définit l’alias équivalent à la sortie des commandes spécifiées par CommandString . L’équivalent d’alias inclut les retours chariot s’ils sont présents dans l’affichage de commandes et un retour chariot à la fin de l’affichage de chaque commande (même si vous spécifiez une seule commande).

CommandString
Spécifie les commandes dont les sorties deviennent l’équivalent de l’alias. Cette chaîne peut inclure n’importe quel nombre de commandes séparées par des points-virgules.

Environnement

Élément	Description
Modes	Mode utilisateur, mode noyau
Targets	Live, vidage de la mémoire
Platforms	Tous

Informations supplémentaires

Pour plus d’informations sur l’utilisation des alias, consultez Utilisation d’alias.

Notes

Si vous n’utilisez aucun commutateur, la commande utilise le reste de la ligne comme équivalent d’alias.

Vous pouvez mettre fin à la commande aS par un point-virgule. Cette technique est utile dans un script lorsque vous devez placer toutes les commandes sur une seule ligne. Notez que si la partie de la ligne après le point-virgule nécessite l’expansion de l’alias, vous devez placer cette deuxième partie de la ligne dans un nouveau bloc. L’exemple suivant génère la sortie attendue, 0x6.

0:001> aS /x myAlias 5 + 1; .block{.echo myAlias}
0x6

Si vous omettez le nouveau bloc, vous n’obtenez pas la sortie attendue. Cela est dû au fait que l’expansion d’un alias nouvellement défini ne se produit pas tant qu’un nouveau bloc de code n’est pas entré. Dans l’exemple suivant, le nouveau bloc est omis et la sortie est le texte « myAlias » au lieu de la valeur attendue 0x6.

0:001> aS /x myAlias 5 + 1; .echo myAlias
myAlias

Pour plus d’informations sur l’utilisation d’alias dans des scripts, consultez Utilisation d’alias.

Si vous utilisez un commutateur /e, /ma, /mu, /msa, /msu ou /x, les commandes as et aS fonctionnent de la même façon et la commande se termine si un point-virgule est rencontré.

Si Name est déjà le nom d’un alias existant, cet alias est redéfini.

Vous pouvez utiliser la commande as ou aS pour créer ou modifier n’importe quel alias nommé par l’utilisateur. Mais vous ne pouvez pas utiliser la commande pour contrôler un alias de nom fixe ($u 0 pour $u 9).

Vous pouvez utiliser les commutateurs /ma, /mu, /msa, /msu, /f et /c pour créer un alias qui contient des retours chariot. Toutefois, vous ne pouvez pas utiliser un alias qui contient des retours chariots pour exécuter plusieurs commandes dans la séquence. Au lieu de cela, vous devez utiliser des points-virgules.