PowerShellExecutor.dll アドオンのトレースを設定する方法

PowerShellExecutor.dll は、ゲートウェイと Microsoft PowerShell 間の通信を実装するアドオンです。この PowerShell は、Exchange Server 2007 アカウントを管理するのに使用します。このアドオンは、残りのゲートウェイとトレース機能を共有せず、残りのゲートウェイと同様のスタンドアロンのトレース機能を備えています。

PowerShellExecutor のトレース設定は、ほかのゲートウェイのレジストリキーとして同じレジストリキーに格納されます。

HKEY_LOCAL_MACHINE\Software\Waveset\Lighthouse\Gateway

このベースキーは、Identity Manager のデバッグページからトレースを設定したり、トレースコマンド引数でゲートウェイを開始すると作成されます。

シャットダウン時に、レジストリにトレースできるようにゲートウェイから現 PowerShellExecutor 設定が書き込まれます。次の設定があります。

• traceFileName

  コンテンツ。 トレース出力用のファイル名 (レジストリ型 REG_SZ)

  「デフォルト」。" "

  PowerShellExecutor トレースに生成するトレースファイル名。このファイル名には、

  • ファイル名などが省略されていないパスを設定できます。

  • スラッシュ (\) で終わることはできません。

    ファイルを除き、traceFileName 内の省略されていないパスが必要です。

    これが設定されている場合、そのファイルがもはやアクティブでなければ、ローテーション後にログのローテーションから設定済みファイル名にタイムスタンプが付与されます。このタイムスタンプは、次の形式で表示されます。

    yyyyMMddHHmmss

• traceLevel

  コンテンツ。 トレースレベル (レジストリ型 REG_DWORD)

  「デフォルト」。0 (トレースなし)

  許容。0–4

  このキーは、残りのゲートウェイと共有されます。ゲートウェイ全体は、常に同じレベルでトレースを行います。

• traceMaxSize

  「内容」。バイト単位の最大ファイルサイズ (レジストリ型 REG_DWORD または REG_QWORD)

  「デフォルト」。100000 バイト

  最小。100000 バイト

  ほかのシステムに移動できるよう、トレーステキストは、バイトオーダーマークが付いた UTF–8 エンコード化テキストで書き込まれます。

• traceMaxFiles

  「内容」。トレースファイル数 (レジストリ型 REG_DWORD )

  「デフォルト」。2

  最小。1

  この設定は、システムで保持するトレースファイル数を制御します。最大ファイル数の設定を 1 にし続けると、最大サイズに達したときにファイルが上書きされてしまいます。最後の書き込み時刻を基にして一番古いファイルは、最大ファイル数に達したときに削除されます。

• traceConfigInterval

  「内容」。ミリ秒単位のタイムアウト (レジストリ型 REG_DWORD)

  「デフォルト」。300000 ms (5 分)

  最小。60000 ミリ秒 (1 分)

すべてのトレース設定は、このタイムアウト値を基にしてレジストリから再読み取りされます。本稼動環境では、オーバーヘッドを最小限に抑えるために、この値を 24 時間などの大きな値に設定するようにしてください。