as, aS (Establecer alias)
Los comandos as y aS definen un nuevo alias o vuelven a definir uno existente.
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
Parámetros
Nombre
Especifica el nombre del alias. Este nombre puede ser cualquier cadena de texto que no contenga un espacio o la pulsación de tecla ENTRAR y no comience por "al", "as", "aS" o "ad". El nombre distingue mayúsculas de minúsculas.
EquivalentLine
Especifica el alias equivalente. EquivalentLine distingue mayúsculas de minúsculas. Debe agregar al menos un espacio entre Name y EquivalentLine. El número de espacios entre estos dos parámetros no es importante. El alias equivalente nunca contiene espacios iniciales. Después de estos espacios, EquivalentLine incluye el resto de la línea. Los puntos y coma, las comillas y los espacios se tratan como caracteres literales y se incluyen espacios finales.
EquivalentPhrase
Especifica el alias equivalente. EquivalentPhrase distingue mayúsculas de minúsculas. Debe agregar al menos un espacio entre Name y EquivalentPhrase. El número de espacios entre estos dos parámetros no es importante. El alias equivalente nunca contiene espacios iniciales.
Puede incluir EquivalentPhrase entre comillas ("). Independientemente de si usa comillas, EquivalentPhrase puede contener espacios, comas y comillas simples ('). Si incluye EquivalentPhrase entre comillas, puede incluir punto y coma, pero no comillas adicionales. Si no incluye EquivalentPhrase entre comillas, puede incluir comillas en cualquier ubicación que no sea el primer carácter, pero no puede incluir punto y coma. Los espacios finales se incluyen independientemente de si se usan comillas.
/e
Establece el alias equivalente a la variable de entorno que especifica EnvironmentVariable .
EnvironmentVariable
Especifica la variable de entorno que se usa para determinar el alias equivalente. Se usa el entorno del depurador, no el del destino. Si inició el depurador en una ventana del símbolo del sistema, se usan las variables de entorno de esa ventana.
/mamá
Establece el alias equivalente a la cadena ASCII terminada en null que comienza en Address.
/mu
Establece el alias equivalente a la cadena Unicode terminada en NULL que comienza en Address.
/Msa
Establece el alias equivalente a la estructura ANSI_STRING que se encuentra en Address.
/msu
Establece el alias equivalente a la estructura UNICODE_STRING que se encuentra en Address.
Dirección
Especifica la ubicación de la memoria virtual que se usa para determinar el alias equivalente.
/x
Establece el alias equivalente al valor de 64 bits de Expression.
Expresión
Especifica la expresión que se va a evaluar. Este valor se convierte en el alias equivalente. Para obtener más información sobre la sintaxis, consulte Sintaxis de expresión numérica.
/f
Establece el alias equivalente a igual al contenido del archivo File . Siempre debe usar el modificador /f junto con aS, no con as.
Archivo
Especifica el archivo cuyo contenido se convierte en el alias equivalente. El archivo puede contener espacios, pero nunca debe incluir el archivo entre comillas. Si especifica un archivo no válido, recibirá un mensaje de error "Memoria insuficiente".
/c
Establece el alias equivalente a la salida de los comandos que especifica CommandString . El alias equivalente incluye retornos de carro si están presentes en la pantalla del comando y un retorno de carro al final de la presentación de cada comando (incluso si especifica solo un comando).
CommandString
Especifica los comandos cuyos resultados se convierten en el alias equivalente. Esta cadena puede incluir cualquier número de comandos separados por punto y coma.
Entorno
| Elemento | Descripción |
|---|---|
| Modos | Modo de usuario, modo kernel |
| Destinos | En tiempo real, volcado de errores |
| Platforms | All |
Información adicional
Para obtener más información sobre cómo usar alias, consulte Uso de alias.
Comentarios
Si no usa ningún modificador, el comando as usa el resto de la línea como alias equivalente.
Puede finalizar el comando aS por punto y coma. Esta técnica es útil en un script cuando tiene que colocar todos los comandos en una sola línea. Tenga en cuenta que si la parte de la línea después del punto y coma requiere la expansión del alias, debe incluir esa segunda parte de la línea en un nuevo bloque. En el ejemplo siguiente se genera la salida esperada, 0x6.
0:001> aS /x myAlias 5 + 1; .block{.echo myAlias}
0x6
Si omite el nuevo bloque, no obtendrá la salida esperada. Esto se debe a que la expansión de un alias recién establecido no se produce hasta que se escribe un nuevo bloque de código. En el ejemplo siguiente, se omite el nuevo bloque y la salida es el texto "myAlias" en lugar del valor esperado 0x6.
0:001> aS /x myAlias 5 + 1; .echo myAlias
myAlias
Para obtener más información sobre el uso de alias en scripts, consulte Uso de alias.
Si usa un modificador /e, /ma, /mu, /msa, /msu o /x , los comandos as y aS funcionan igual y el comando finaliza si se encuentra un punto y coma.
Si Name ya es el nombre de un alias existente, ese alias se vuelve a definir.
Puede usar el comando as o aS para crear o cambiar cualquier alias con nombre de usuario. Pero no puede usar el comando para controlar un alias de nombre fijo ($u 0 a $u 9).
Puede usar los modificadores /ma, /mu, /msa, /msu, /f y /c para crear un alias que contenga retornos de carro. Sin embargo, no puede usar un alias que contenga retornos de carro para ejecutar varios comandos en secuencia. En su lugar, debe usar punto y coma.