as, aS (Set Alias)

I comandi as e aS definiscono un nuovo alias o ridefiniscono uno esistente.

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 

Parametri

Nome
Specifica il nome dell'alias. Questo nome può essere qualsiasi stringa di testo che non contiene uno spazio o la sequenza di tasti INVIO e non inizia con "al", "as", "aS" o "ad". Il nome fa distinzione tra maiuscole e minuscole.

EquivalentLine
Specifica l'alias equivalente. EquivalentLine fa distinzione tra maiuscole e minuscole. È necessario aggiungere almeno uno spazio tra Name e EquivalentLine. Il numero di spazi tra questi due parametri non è importante. L'alias equivalente non contiene mai spazi iniziali. Dopo questi spazi, EquivalentLine include il resto della riga. I punti e virgola, le virgolette e gli spazi vengono considerati come caratteri letterali e gli spazi finali sono inclusi.

EquivalentPhrase
Specifica l'alias equivalente. EquivalentPhrase fa distinzione tra maiuscole e minuscole . È necessario aggiungere almeno uno spazio tra Name e EquivalentPhrase. Il numero di spazi tra questi due parametri non è importante. L'alias equivalente non contiene mai spazi iniziali.

È possibile racchiudere EquivalentPhrase tra virgolette ("). Indipendentemente dal fatto che si usino virgolette, EquivalentPhrase può contenere spazi, virgole e virgolette singole ('). Se si racchiude EquivalentPhrase tra virgolette, può includere punti e virgola, ma non virgolette aggiuntive. Se non si racchiude EquivalentPhrase tra virgolette, può includere virgolette in qualsiasi posizione diversa dal primo carattere, ma non può includere punti e virgola. Gli spazi finali vengono inclusi indipendentemente dal fatto che si usino le virgolette.

/e
Imposta l'alias equivalente alla variabile di ambiente specificata da EnvironmentVariable .

AmbienteVariable
Specifica la variabile di ambiente utilizzata per determinare l'equivalente alias. L'ambiente del debugger viene usato, non quello della destinazione. Se il debugger è stato avviato in una finestra del prompt dei comandi, vengono usate le variabili di ambiente in tale finestra.

/mamma
Imposta l'alias equivalente alla stringa ASCII con terminazione Null che inizia in Address.

/Mu
Imposta l'alias equivalente alla stringa Unicode con terminazione Null che inizia in Indirizzo.

/Msa
Imposta l'alias equivalente alla struttura ANSI_STRING che si trova in Address.

/msu
Imposta l'alias equivalente alla struttura UNICODE_STRING che si trova in Address.

Indirizzo
Specifica il percorso della memoria virtuale utilizzata per determinare l'alias equivalente.

/x
Imposta l'alias equivalente al valore a 64 bit di Expression.

Espressione
Specifica l'espressione da valutare. Questo valore diventa l'alias equivalente. Per altre informazioni sulla sintassi, vedere Sintassi delle espressioni numeriche.

/f
Imposta l'alias equivalente al contenuto del file File . È consigliabile usare sempre l'opzione /f insieme a aS, non con come.

File
Specifica il file il cui contenuto diventa l'alias equivalente. Il file può contenere spazi, ma non è mai consigliabile racchiudere il file tra virgolette. Se si specifica un file non valido, viene visualizzato un messaggio di errore "Memoria insufficiente".

/c
Imposta l'alias equivalente all'output dei comandi specificati da CommandString . L'alias equivalente include i ritorni a capo se sono presenti all'interno della visualizzazione del comando e un ritorno a capo alla fine della visualizzazione di ogni comando (anche se si specifica un solo comando).

CommandString
Specifica i comandi i cui output diventano l'alias equivalente. Questa stringa può includere un numero qualsiasi di comandi separati da punti e virgola.

Ambiente

Informazioni aggiuntive

Per altre informazioni su come usare gli alias, vedere Uso degli alias.

Osservazioni:

Se non si usano opzioni, il comando as usa il resto della riga come equivalente dell'alias.

È possibile terminare il comando aS con un punto e virgola. Questa tecnica è utile in uno script quando è necessario inserire tutti i comandi in una singola riga. Si noti che se la parte della riga dopo il punto e virgola richiede l'espansione dell'alias, è necessario racchiudere la seconda parte della riga in un nuovo blocco. Nell'esempio seguente viene generato l'output previsto, 0x6.

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

Se si omette il nuovo blocco, non si ottiene l'output previsto. Ciò avviene perché l'espansione di un alias appena impostato non viene eseguita finché non viene immesso un nuovo blocco di codice. Nell'esempio seguente il nuovo blocco viene omesso e l'output è il testo "myAlias" anziché il valore previsto 0x6.

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

Per altre informazioni sull'uso degli alias negli script, vedere Uso degli alias.

Se si usa un'opzione /e, /ma, /mu, /msa, /msu o /x, i comandi as e aS funzionano allo stesso modo e il comando termina se viene rilevato un punto e virgola.

Se Name è già il nome di un alias esistente, tale alias viene ridefinito.

È possibile usare il comando as o aS per creare o modificare qualsiasi alias denominato dall'utente. Ma non è possibile usare il comando per controllare un alias a nome fisso (da $u 0 a $u 9).

È possibile usare le opzioni /ma, /mu, /msa, /msu, /f e /c per creare un alias contenente ritorni a capo. Tuttavia, non è possibile usare un alias che contiene ritorni a capo per eseguire più comandi in sequenza. È invece necessario usare punti e virgola.