コマンドレット拡張エージェントについて
適用先: Exchange Server 2010 SP2, Exchange Server 2010 SP3
コマンドレット拡張エージェントは、コマンドレットの実行時に Exchange Server 2010 コマンドレットによって呼び出される Microsoft Exchange 2010 のコンポーネントです。コマンドレット拡張エージェントは、その名前が示すように、コマンドレットの要求に基づいてデータの処理または追加操作の実行を支援することで、それらを呼び出すコマンドレットの機能を拡張します。コマンドレット拡張エージェントは、エッジ トランスポート サーバーの役割以外のサーバーの役割で利用可能です。
エージェントは、Exchange 管理シェル コマンドレットの機能を変更、置き換え、または拡張できます。また、コマンド上で提供されない必須パラメーターの値の提供、ユーザーが入力した値の上書き、コマンドレットの実行中にコマンドレット ワークフロー外の他の操作の実行などを行うことができます。
たとえば、New-Mailbox コマンドレットは、新しいメールボックスを作成するメールボックス データベースを指定する、Database パラメーターを受け入れます。Exchange Server 2007 では、New-Mailbox コマンドレットの実行時に Database パラメーターを指定しない場合、コマンドは失敗します。Exchange 2010 では、New-Mailbox コマンドレットは、その実行時に Mailbox Resources Management
エージェントを呼び出します。Database パラメーターが指定されていない場合、Mailbox Resources Management
エージェントは、自動的に新しいメールボックスを作成する適切なメールボックス データベースを特定し、その値を Database パラメーターに挿入します。
コマンドレット拡張エージェントは Exchange 2010 コマンドレットによってのみ呼び出すことができます。Exchange 2007 コマンドレットと他の Microsoft およびサード パーティ製品によって提供されるコマンドレットは、コマンドレット拡張エージェントを呼び出すことができません。スクリプトもコマンドレット拡張子エージェントを直接呼び出すことはできません。ただし、スクリプトに Exchange 2010 コマンドレットが含まれている場合、これらのコマンドレットはコマンドレット拡張エージェントを呼び出し続けます。
コマンドレット拡張子エージェントに関連する管理タスクについては、「コマンドレット拡張エージェントの管理」を参照してください。
エージェントの優先度
エージェントの優先度によって、コマンドレットの実行中にエージェントが呼び出される順序が決まります。優先度が高い、つまり 0 に近いエージェントが最初に実行されます。2 つ以上のエージェントが同じプロパティの値を設定しようとする場合に、エージェントの優先度が重要になります。優先度が最も高いエージェントによるプロパティ値の設定試行は成功し、優先度の低いエージェントによる同じプロパティ設定に対する後続の試行は無視されます。たとえば、オブジェクトの Name プロパティが優先度 3 のエージェントと優先度 6 の別のエージェントによって変更される場合、優先度 6 のエージェントによる変更は無視されます。
Scripting agent
を使用して、他の優先度の高いエージェントによって設定される可能性があるプロパティの値を設定する場合、次のオプションがあります。
現在プロパティを設定しているエージェントを無効にします。
Scripting agent
を置き換える既存のエージェントより高い優先度に設定します。エージェントの優先度を同じ値のままにして、
Scripting agent
の下で実行するスクリプトによって他のエージェントが提供する値が重視されることを確認します。
注意
優先度の変更またはビルトイン エージェントの機能の置き換えは、高度な操作です。変更について完全に理解するようにしてください。
エージェントの優先度の変更の詳細については、「コマンドレット拡張エージェントの優先度を変更する」を参照してください。
ビルトイン エージェント
Exchange 2010 には、コマンドレットの実行時に呼び出すことができるいくつかのエージェントが含まれています。次の表に、エージェント、その順序、および既定でそのエージェントが有効になっているかどうかの一覧を示します。Exchange 2010 を実行しているサーバーから、エージェントを追加または削除することはできません。しかし、スクリプト エージェントを使用して Microsoft Windows PowerShell スクリプトを実行することにより、エージェントを使用するコマンドレットの機能を拡張することはできます。Scripting agent の詳細については、「Scripting Agent について」を参照してください。
特定のエージェントの機能を、Scripting agent を使用して呼び出すカスタム スクリプトで提供する機能で置き換える場合、エージェントを有効または無効にしたり、エージェントの優先度を変更したりできます。
エージェントの構成は、組織レベルで格納されます。エージェントを有効または無効にするか、その優先度を設定する場合、組織内のすべてのサーバーにわたってエージェントの構成を設定します。例外は、スクリプトを Scripting agent
に追加する場合です。各サーバー上のスクリプトは個別に更新する必要があります。Scripting agent
で使用するためのスクリプトの構成の詳細については、「Scripting Agent について」を参照してください。
注意
各エージェントの機能およびエージェントと Exchange コマンドレットのやり取りを十分に理解していない場合、エージェントの優先度を変更したり、エージェントを有効または無効にすると、予期しない結果が発生する可能性があります。エージェントの構成を変更する前に、目的の変更内容と結果を十分に理解した上で、カスタム スクリプトが意図したとおりに動作することを確認してください。
Exchange 2010 コマンドレット拡張子エージェント
エージェント名 | 優先度 | 既定で有効 |
---|---|---|
管理監査ログ エージェント |
255 |
はい |
Scripting Agent |
6 |
いいえ |
OAB リソース管理エージェント |
5 |
True |
プロビジョニング ポリシー エージェント |
4 |
True |
メールボックス作成時刻エージェント |
3 |
True |
メールボックス リソース管理エージェント |
2 |
True |
Rus エージェント |
1 |
True |
クエリ ベース DN エージェント |
0 |
True |