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.

EquivalentLine
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 equivalente alias 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.

EquivalentPhrase
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 equivalente alias 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. Espaços à direita são incluídos independentemente de você usar aspas.

/e
Define o alias equivalente à variável de ambiente especificada por EnvironmentVariable .

EnvironmentVariable
Especifica a variável de ambiente usada para determinar o equivalente do alias. O ambiente do depurador é usado, não o do destino. Se você tiver iniciado o depurador em uma janela do Prompt de Comando, as variáveis de ambiente nessa janela serão usadas.

/Mãe
Define o alias equivalente à cadeia de caracteres ASCII terminada em nulo que começa em Address.

/Mu
Define o alias equivalente à cadeia de caracteres Unicode terminada em nulo que começa em Address.

/Msa
Define o alias equivalente à estrutura ANSI_STRING localizada em Address.

/Msu
Define o alias equivalente à estrutura UNICODE_STRING localizada em Address.

Endereço
Especifica o local da memória virtual usada para determinar o equivalente do alias.

/X
Define o alias equivalente ao valor de 64 bits de Expression.

Expressão
Especifica a expressão a ser avaliada. Esse valor se torna o equivalente ao alias. Para obter mais informações sobre a sintaxe, consulte Sintaxe de expressão numérica.

/f
Define o alias equivalente ao conteúdo do arquivo file . Você sempre deve usar a opção /f junto com aS, não com como.

File
Especifica o arquivo cujo conteúdo se torna o equivalente ao alias. O arquivo pode conter espaços, mas você nunca deve colocar Arquivo entre aspas. Se você especificar um arquivo inválido, receberá uma mensagem de erro "Memória insuficiente".

/C
Define o alias equivalente à saída dos comandos especificados por CommandString . O alias equivalente inclui retornos de carro se eles estiverem presentes na exibição de comando e um retorno de carro no final da exibição de cada comando (mesmo que você especifique apenas um comando).

CommandString
Especifica os comandos cujas saídas se tornam equivalentes ao alias. 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 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 expansão do alias, você deverá colocar a 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 acontece 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 Name 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 contém retornos de carro. No entanto, você não pode usar um alias que contém retornos de carro para executar vários comandos em sequência. Em vez disso, você deve usar ponto e vírgula.