コマンドレット拡張エージェントを管理する

  • [アーティクル]

製品: Exchange Server 2013

このトピックでは、Microsoft Exchange Server 2013 のコマンドレット拡張エージェントの優先度の有効化、無効化、表示、および変更を行う方法を示します。 Exchange 2013 のコマンドレット拡張エージェントの詳細については、「コマンドレット拡張エージェント」を参照してください。

はじめに把握しておくべき情報

  • 各手順の推定完了時間:5 分未満

  • この手順を実行する際には、あらかじめアクセス許可が割り当てられている必要があります。 必要なアクセス許可を確認するには、 Exchange とシェルのインフラストラクチャのアクセス許可 に関するトピックの「コマンドレット拡張エージェント」エントリを参照してください。

  • を有効にする前に Scripting Agent、正しく構成されていることを確認する必要があります。 の Scripting Agent詳細については、「 コマンドレット拡張エージェント」を参照してください。

  • これらの手順を実行するには、シェルを使用する必要があります。

  • このトピックの手順で使用可能なキーボード ショートカットについては、「Exchange 管理センターのキーボード ショートカット」を参照してください。

ヒント

問題がある場合は、 Exchange のフォーラムで質問してください。 Exchange Serverのフォーラムにアクセスしてください。

コマンドレット拡張エージェントを有効にする

Exchange 2013 のコマンドレット拡張エージェントを有効にすると、Exchange 2013 が実行されている組織内のすべてのサーバーでエージェントが実行されます。 有効にしたエージェントはコマンドレットから使用可能になり、コマンドレットはそのエージェントを使用して追加の操作を実行できます。

警告

エージェントを有効にする場合は、その前に、エージェントの動作とエージェントが組織に与える影響を把握してください。

この例では、 Enable-CmdletExtensionAgent コマンドレットを使用してコマンドレット拡張エージェントを有効にします。 コマンドレットを実行するときには有効にするエージェント名を指定する必要があります。 を Scripting Agent有効にする前に、構成ファイルが組織内のすべてのサーバーに展開 ScriptingAgentConfig.xml されていることを確認する必要があります。 構成ファイルを最初にデプロイせず、 を有効に Scripting ``Agentした場合、Get 以外のすべてのコマンドレットは実行時に失敗します。 この例では、 を Scripting Agent有効にします。

Enable-CmdletExtensionAgent "Scripting Agent"

構文およびパラメーターの詳細については、「Enable-CmdletExtensionAgent」を参照してください。

コマンドレット拡張エージェントを無効にする

Exchange 2013 でコマンドレット拡張エージェントを無効にすると、Exchange 2013 を実行している組織内のすべてのサーバーでエージェントが無効になります。 エージェントが無効の場合、コマンドレットがエージェントを使用できなくなります。 コマンドレットは、追加の操作を行うために、エージェントを使用できなくなります。

警告

エージェントを無効にする場合は、その前に、エージェントの動作とエージェントを無効にすることが組織に与える影響を把握してください。

コマンドレット拡張エージェントを無効にするには、 Disable-CmdletExtensionAgent コマンドレットを使用します。 コマンドレットを実行する場合は、無効にするエージェントの名前を指定します。 この例では、 を Scripting Agent無効にします。

Disable-CmdletExtensionAgent "Scripting Agent"

構文およびパラメーターの詳細については、「Disable-CmdletExtensionAgent」を参照してください。

既存のコマンドレット拡張エージェントを表示する

コマンドレット拡張エージェントの表示により、Exchange 2013 組織において最初に実行されるエージェントおよび有効なエージェントを確認できます。 パイプラインと Format-Table コマンドレットの詳細については、以下のトピックを参照してください。

この例では、 Get-CmdletExtensionAgent コマンドレットを使用して特定のコマンドレット拡張エージェントの詳細を取得します。 この例では、 の Mailbox Permissions Agent 詳細が返されます。

Get-CmdletExtensionAgent "Mailbox Permissions Agent"

この例では、 Get-CmdletExtensionAgent コマンドレットを使用して複数のコマンドレット拡張エージェントを取得し、出力を Format-Table コマンドレットにパイプします。 この例では、組織内のすべてのコマンドレット拡張エージェントの一覧を表示し、 Format-Table コマンドレットを使用すると、各エージェントの Name、 Enabled、 Priority プロパティがテーブルに表示されます。

Get-CmdletExtensionAgent | Format-Table Name, Enabled, Priority

構文およびパラメーターの詳細については、「Get-CmdletExtensionAgent」を参照してください。

コマンドレット拡張エージェントの優先度を変更する

Exchange 2013 でコマンドレット拡張エージェントの優先度を変更する機能は、コマンドレットによって特定のエージェントを呼び出してから別のエージェントを呼び出す場合に便利です。 これは、 で Scripting Agent実行されるカスタム スクリプトを作成し、そのスクリプトを組み込みエージェントよりも優先する場合に特に便利です。 の Scripting Agent詳細については、「 コマンドレット拡張エージェント」を参照してください。

警告

優先度の変更またはビルトイン エージェントの機能の置き換えは、高度な操作です。 変更について完全に理解するようにしてください。

エージェントは、ゼロからエージェントの最大数まで並べられます。 ゼロに近いエージェントは、エージェント優先度が高くなります。 優先度の高いエージェントが最初に呼び出されます。 エージェント優先度の詳細については、「コマンドレット拡張エージェント」を参照してください。

この例では、 Set-CmdletExtensionAgent コマンドレットの使用により、コマンドレット拡張エージェントの優先度を変更します。 この例では、 の Scripting Agent 優先順位が 3 に変更されています。

Set-CmdletExtensionAgent "Scripting Agent" -Priority 3

構文とパラメーターの詳細については、「Set-CmdletExtensionAgent」を参照してください。