as, aS (definir alias)
Os comandos as e aS definem um novo alias ou redefinem um 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
Nome
Especifica o nome do alias. Esse nome pode ser qualquer cadeia de caracteres de texto que não contenha um espaço ou o pressionamento de tecla ENTER e não comece com "al", "as", "aS" ou "ad". O nome diferencia maiúsculas de minúsculas.
Linha Equivalente
Especifica o alias equivalente. EquivalentLine diferencia maiúsculas de minúsculas. Você deve adicionar pelo menos um espaço entre Name e EquivalentLine. O número de espaços entre esses dois parâmetros não é importante. O alias equivalente nunca contém espaços à esquerda. Após esses espaços, EquivalentLine inclui o restante da linha. Ponto-e-vírgula, aspas e espaços são tratados como caracteres literais e espaços à direita são incluídos.
Frase Equivalente
Especifica o alias equivalente. EquivalentPhrase diferencia maiúsculas de minúsculas. Você deve adicionar pelo menos um espaço entre Name e EquivalentPhrase. O número de espaços entre esses dois parâmetros não é importante. O alias equivalente nunca contém espaços à esquerda.
Você pode colocar EquivalentPhrase entre aspas ("). Independentemente de você usar aspas, EquivalentPhrase pode conter espaços, vírgulas e aspas simples ('). Se você colocar EquivalentPhrase entre aspas, ele poderá incluir ponto-e-vírgula, mas não aspas adicionais. Se você não colocar EquivalentPhrase entre aspas, ele poderá incluir aspas em qualquer local diferente do primeiro caractere, mas não poderá incluir ponto-e-vírgula. Os espaços à direita são incluídos independentemente de você usar aspas.
/e
Define o alias equivalente igual à variável de ambiente especificada por EnvironmentVariable .
Variável de ambiente
Especifica a variável de ambiente usada para determinar o alias equivalente. O ambiente do depurador é usado, não o do destino. Se você iniciou o depurador em uma janela do Prompt de Comando, as variáveis de ambiente nessa janela serão usadas.
/mamã
Define o alias equivalente igual à cadeia de caracteres ASCII terminada em nulo que começa em Address.
/Mu
Define o alias equivalente igual à cadeia de caracteres Unicode terminada em nulo que começa em Address.
/Msa
Define o alias equivalente igual à estrutura ANSI_STRING localizada em Endereço.
/msu
Define o alias equivalente igual à estrutura UNICODE_STRING localizada em Endereço.
Endereço
Especifica o local da memória virtual usada para determinar o alias equivalente.
/x
Define o alias equivalente igual ao valor de 64 bits de Expression.
Expressão
Especifica a expressão a ser avaliada. Esse valor se torna o alias equivalente. Para obter mais informações sobre a sintaxe, consulte Sintaxe de expressão numérica.
/f
Define o alias equivalente igual ao conteúdo do arquivo Arquivo . Você deve sempre usar a opção /f junto com aS, não com as.
Arquivo
Especifica o arquivo cujo conteúdo se torna o alias equivalente. File pode conter espaços, mas você nunca deve colocar File entre aspas. Se você especificar um arquivo inválido, receberá uma mensagem de erro "Sem memória".
/c
Define o alias equivalente igual à saída dos comandos especificados por CommandString . O alias equivalente inclui retornos de carro se eles estiverem presentes na exibição do comando e um retorno de carro no final da exibição de cada comando (mesmo se você especificar apenas um comando).
Sequência de comandos
Especifica os comandos cujas saídas se tornam o alias equivalente. Essa cadeia de caracteres pode incluir qualquer número de comandos separados por ponto-e-vírgula.
Ambiente
| Item | Descrição |
|---|---|
| Modos | Modo de usuário, modo kernel |
| Destinos | Ao vivo, despejo de memória |
| Plataformas | Tudo |
Informações Adicionais
Para obter mais informações sobre como usar aliases, consulte Usando aliases.
Comentários
Se você não usar nenhuma opção, o comando as usará o restante da linha como o alias equivalente.
Você pode encerrar o comando aS por um ponto-e-vírgula. Essa técnica é útil em um script quando você precisa colocar todos os comandos em uma única linha. Observe que, se a parte da linha após o ponto-e-vírgula exigir a expansão do alias, você deverá colocar essa segunda parte da linha em um novo bloco. O exemplo a seguir produz a saída esperada, 0x6.
0:001> aS /x myAlias 5 + 1; .block{.echo myAlias}
0x6
Se você omitir o novo bloco, não obterá a saída esperada. Isso ocorre porque a expansão de um alias recém-definido não ocorre até que um novo bloco de código seja inserido. No exemplo a seguir, o novo bloco é omitido e a saída é o texto "myAlias" em vez do valor esperado 0x6.
0:001> aS /x myAlias 5 + 1; .echo myAlias
myAlias
Para obter mais informações sobre como usar aliases em scripts, consulte Usando aliases.
Se você usar uma opção /e, /ma, /mu, /msa, /msu ou /x , os comandos as e aS funcionarão da mesma forma e o comando terminará se um ponto-e-vírgula for encontrado.
Se Nome já for o nome de um alias existente, esse alias será redefinido.
Você pode usar o comando as ou aS para criar ou alterar qualquer alias nomeado pelo usuário. Mas você não pode usar o comando para controlar um alias de nome fixo ($u 0 a $u 9).
Você pode usar as opções /ma, /mu, /msa, /msu, /f e /c para criar um alias que contenha retornos de carro. No entanto, você não pode usar um alias que contenha retornos de carro para executar vários comandos em sequência. Em vez disso, você deve usar ponto e vírgula.