as、aS (エイリアスの設定)

  • [アーティクル]

as および aS コマンドは、新しいエイリアスを定義するか、既存のエイリアスを再定義します。

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

パラメーター

名前
エイリアス名を指定します。 この名前には、スペースや Enter キー ストロークを含まず、「al」、「as」、「aS」、「ad」で始まらない任意のテキスト文字列を指定できます。 Name では大文字と小文字が区別されます。

EquivalentLine
エイリアスの実体を指定します。 EquivalentLine では大文字と小文字が区別されます。 Name と EquivalentLine の間には 1 つ以上のスペースを追加する必要があります。 これら 2 つのパラメーター間のスペースの数は重要ではありません。 エイリアスの実体の先頭にスペースが含まれることはありません。 これらのスペースの後、EquivalentLine は行の残りを追加します。 セミコロン、引用符、スペースはリテラル文字として扱われ、末尾のスペースも含まれます。

EquivalentPhrase
エイリアスの実体を指定します。 EquivalentPhrase では大文字と小文字が区別されます。 Name と EquivalentPhrase の間には 1 つ以上のスペースを追加する必要があります。 これら 2 つのパラメーター間のスペースの数は重要ではありません。 エイリアスの実体の先頭にスペースが含まれることはありません。

EquivalentPhrase は引用符 (") で囲むことができます。 引用符を使用するかどうかにかかわらず、EquivalentPhrase にはスペース、コンマ、単一引用符 (') を含めることができます。 EquivalentPhrase を引用符で囲む場合は、セミコロンを含めることができますが、追加の引用符を含めることができません。 EquivalentPhrase を引用符で囲まない場合は、最初の文字以外の場所に引用符を含めることができますが、セミコロンを含めることはできません。 引用符を使用するかどうかにかかわらず、末尾にスペースが含まれます。

/e
EnvironmentVariable で指定している環境変数を実体とするエイリアスを設定します。

EnvironmentVariable
エイリアスの実体として使用される環境変数を指定します。 ターゲットの環境ではなく、デバッガーの環境が使用されます。 コマンド プロンプト ウィンドウでデバッガーを起動した場合は、そのウィンドウの環境変数が使用されます。

/ma
Address で始まる null 終端の ASCII 文字列を実体とするエイリアスを設定します。

/mu
Address で始まる null 終端の Unicode 文字列を実体とするエイリアスを設定します。

/msa
Address に位置する ANSI_STRING 構造体を実体とするエイリアスを設定します。

/msu
Address に位置する UNICODE_STRING 構造体を実体とするエイリアスを設定します。

アドレス
エイリアスの実体として使用される仮想メモリの位置を指定します。

/x
Expression 64 ビット値を実体とするエイリアスを設定します。

Expression
評価する式を指定します。 この値がエイリアスの実体になります。 構文の詳細については、「数値式の構文」を参照してください。

/f
File ファイルの内容を実体とするエイリアスを設定します。 /f スイッチは、as とではなく、常に aS と共に使用する必要があります。

ファイル
内容がエイリアスの実体になるファイルを指定します。 File にはスペースを含めることができますが、File を引用符で囲むことはできません。 無効なファイルを指定した場合は、「メモリ不足」のエラー メッセージが表示されます。

/c
CommandString で指定したコマンドの出力を実体とするエイリアスを設定します。 エイリアスには、コマンド表示内に改行がある場合は改行を含めます。1 つのコマンドのみを指定する場合でも同じです。

CommandString
出力がエイリアスの実体になるコマンドを指定します。 この文字列には、セミコロンで区切られた任意の数のコマンドを含めることができます。

環境

アイテム 説明
モード ユーザー モード、カーネル モード
ターゲット ライブ、クラッシュ ダンプ
プラットフォーム すべて

追加情報

エイリアスの使用方法の詳細については、「エイリアスの使用」を参照してください。

解説

スイッチを使用しない場合、as コマンドは行の残りの部分をエイリアスの実体として使用します。

aS コマンドはセミコロンで終了させることができます。 この手法は、すべてのコマンドを一行にまとめる必要があるスクリプトに便利です。 行のセミコロン以降の部分でエイリアスの展開が必要な場合は、その 2 番目の部分を新しいブロックに含める必要があります。 次の例を実行すると、予期した出力である「0x6」が得られます。

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

新しいブロックを省略した場合、予期した出力は得られません。 これは、新しく設定したエイリアスが、新しいコード ブロックに入った後でのみ展開されるためです。 次の例では、新しいブロックが省略されているため、予期した出力である 0x6 は得られず、テキスト「myAlias」が出力されています。

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

スクリプトでのエイリアスの使用の詳細については、「エイリアスの使用」を参照してください。

/e、/ma、/mu、/msa、/msu、または /x スイッチを使用する場合、as および aS コマンドは同じように振る舞い、セミコロンが見つかるとコマンドは終了します。

Name が既存のエイリアスの名前である場合、そのエイリアスは再定義されます。

as または aS コマンドを使用して、ユーザー指定名のアリアスを作成または変更できます。 ただし、このコマンドを使用して固定名のエイリアス ($u0 ～ $u9) を制御することはできません。

/ma、/mu、/msa、/msu、/f、/c のスイッチを使用して、改行を含むアリアスを作成できます。 ただし、改行を含むエイリアスを使用して複数のコマンドを順番に実行することはできません。 代わりに、セミコロンを使用する必要があります。