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 touche ENTRÉE et qui ne commence pas par « al », « as », « aS » ou « ad ». Le nom respecte la casse.

Ligne équivalente
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.

EquivalentPhrase
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 ou non des guillemets, EquivalentPhrase peut contenir des espaces, des virgules et des guillemets uniques ('). Si vous placez EquivalentPhrase entre guillemets, il peut inclure des points-virgules, mais pas de 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 ou non des guillemets.

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

EnvironnementVariable
Spécifie la variable d’environnement utilisée pour déterminer l’équivalent de l’alias. L’environnement du débogueur est utilisé, 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.

/ma
Définit l’équivalent de l’alias égal à la chaîne ASCII terminée par null qui commence à Adresse.

/Mu
Définit l’équivalent de l’alias égal à la chaîne Unicode terminée par null qui commence à Adresse.

/Msa
Définit l’équivalent de l’alias égal à la structure ANSI_STRING qui se trouve dans Adresse.

/Msu
Définit l’équivalent de l’alias égal à la structure UNICODE_STRING qui se trouve dans 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’équivalent de l’alias égal à la valeur 64 bits de Expression.

Expression
Spécifie l’expression à évaluer. Cette valeur devient l’équivalent de l’alias. Pour plus d’informations sur la syntaxe, consultez Syntaxe des expressions numériques.

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

File
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 fichier entre guillemets. Si vous spécifiez un fichier non valide, vous recevez un message d’erreur « Mémoire insuffisante ».

/C
Définit l’alias équivalent à la sortie des commandes spécifiées par CommandString . L’équivalent de l’alias inclut les retours chariot s’ils sont présents dans l’affichage de la commande et un retour chariot à la fin de l’affichage de chaque commande (même si vous ne spécifiez qu’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	Vidage en direct sur incident
Plateformes	Tous

Informations supplémentaires

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

Remarques

Si vous n’utilisez aucun commutateur, la commande as 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 une 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. En effet, 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 les 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 à $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 chariot pour exécuter plusieurs commandes dans l’ordre. Au lieu de cela, vous devez utiliser des points-virgules.