Forefront Protection 2010 for Exchange Server (FPE 2010) のForefront管理シェルは、PowerShellを用いたコマンドラインインタフェースです。
Forefront管理シェルは、FPE 2010の管理を目的として様々なコマンドレットが用意されていますが、 オンライン上では説明のみで詳細なコマンド オプション情報については公開されていないようです。
このヘルプ情報について、オンライン上で日本語として確認したいと思い、本ブログ上で纏めたいと思います (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集したものとなります)。
この記事では、「Set-FseOnDemandFilter」コマンドレットについて記載します (他のコマンドレットについては、「FPE 2010のForefront管理シェルで使用できるコマンドレットについて」を参照)。
■名前
Set-FseOnDemandFilter
■概要
フィルター リストをオンデマンド スキャンで使用できるように構成します。
■構文
| Set-FseOnDemandFilter [-File] -List <string> [-Action <RealtimeFilterActionEnum>] [-Enabled <Boolean>] [-Order <int>] [-Quarantine <Boolean>] [-SuppressFilterNotifications <Boolean>] [<CommonParameters>] Set-FseOnDemandFilter [-SenderDomain] -List <string> Set-FseOnDemandFilter [-Subject] -List <string> [-Action <RealtimeFilterActionEnum>] |
■説明
フィルター リストをオンデマンド スキャンで使用できるように構成します。New-FseFilterListで作成された新しいフィルター リストはすべて、オンデマンド スキャンに自動的に関連付けられます。
次の3種類のフィルター リストを使用できます。ファイル フィルター リスト、件名フィルター リスト、および送信者ドメイン フィルター リスト。それぞれ個別のパラメーター セット (-File、-Subject、および -SenderDomain) を各パラメーターの前に使用して構成します。フィルター名は各フィルターの種類内で一意です。
既定では、新しいフィルターには、次のプロパティが設定されています。
- ファイル フィルター: -Enabled $false -Action Delete -Quarantine $true
- 送信者ドメイン フィルターと件名フィルター: -Enabled $false -Action SkipDetect -Quarantine $true
■パラメーター
-Action <RealtimeFilterActionEnum>
アイテムがフィルター リストの条件に一致した場合に実行されるアクションを指定します。省略可能です。指定可能な値はSkipDetectおよびDeleteです。
“SkipDetect”は、一致が検出された場合、レコードは保持されるがメッセージは通常どおり配信可能であることを意味します。
“Delete”は、メッセージから添付ファイルを削除し、代わりに削除テキストを挿入します。
フィルター リストが作成されると、既定値が割り当てられます。ファイル フィルター リストの場合、既定値は”Delete”です。件名リストおよび送信者ドメイン リストの場合、既定値は”SkipDetect”です。Set-FseOnDemandFilterに値を指定しない場合は、既定の設定が維持されます。
| 必須 | false |
| 位置 | named |
| 既定値 | Delete or SkipDetect |
| パイプライン入力を許可する | true (ByValue, ByPropertyName) |
| ワイルドカード文字を許可する | false |
-Enabled <Boolean>
フィルター リストを有効または無効にします。省略可能です。指定可能な値は$falseおよび$trueです。値を指定しなかった場合、現在の設定が維持されます。フィルター リストが作成されると、既定で値$falseが割り当てられます。
| 必須 | false |
| 位置 | named |
| 既定値 | false |
| パイプライン入力を許可する | true (ByValue, ByPropertyName) |
| ワイルドカード文字を許可する | false |
-File [<SwitchParameter>]
構成中のファイル フィルター リストであることを示すパラメーター セットです。必須です。いずれか1つのパラメーター セットを選択する必要があります。-File、-SenderDomain、または -Subjectです。
| 必須 | true |
| 位置 | 1 |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-List <string>
構成する1つの既存のフィルター リストの名前です。必須です。フィルター名では、大文字と小文字が区別されます。文字列に英数字以外の文字やスペースを含める場合は、引用符で囲んでください。フィルター名は種類内で一意です。
フィルター リストは、New-FseFilterListを使用して作成されます。
| 必須 | true |
| 位置 | named |
| 既定値 | |
| パイプライン入力を許可する | true (ByPropertyName) |
| ワイルドカード文字を許可する | false |
-Order <int>
FPEサーバーの前回更新時の稼動状態を返します。省略可能です。このデータはFPEヘルス システム キャッシュから取得され、最後に更新された日付と時刻が含まれます。
-Cachedが指定されていない場合、このコマンドレットは、サーバーの稼動状態を再スキャンし、現在の稼動状態を返すように要求を開始します。このため、-Cachedを使用した方が迅速にデータを取得できます。
| 必須 | false |
| 位置 | named |
| 既定値 | (1 greater than highest existing position) |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-Quarantine <Boolean>
フィルター リストが一致したときにファイルを検疫するかどうかを示します。省略可能です。指定可能な値は $false および$trueです。値$trueは、フィルター リストが作成されたときに既定で割り当てられ、フィルター リストが一致したときにファイルを検疫する必要があることを示します。値を指定しなかった場合、現在の設定が維持されます。
| 必須 | false |
| 位置 | named |
| 既定値 | true |
| パイプライン入力を許可する | true (ByValue, ByPropertyName) |
| ワイルドカード文字を許可する | false |
-SenderDomain [<SwitchParameter>]
構成中の送信者ドメイン フィルター リストであることを示すパラメーター セットです。必須です。いずれか1つのパラメーター セットを選択する必要があります。-File、-SenderDomain、または -Subjectです。この種類のフィルターは、メッセージ ヘッダー内の指定した送信者またはドメインをスキャンします。
| 必須 | true |
| 位置 | 1 |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-Subject [<SwitchParameter>]
構成中の件名フィルター リストであることを示すパラメーター セットです。必須です。いずれか1つのパラメーター セットを選択する必要があります。-File、-SenderDomain、または -Subjectです。この種類のフィルターは、メッセージ ヘッダー内の指定した件名の内容をスキャンします。
| 必須 | true |
| 位置 | 1 |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
-SuppressFilterNotifications <Boolean>
このスキャン ジョブによってこのフィルターと一致したときに通知を送信するかどうかを示します。省略可能です。指定可能な値は$falseおよび$trueです。既定値の $false は、フィルター通知が有効な場合は、それらが送信されることを示します。Set-FseNotificationで無効にされている場合、このパラメーターは効力を持ちません。
| 必須 | false |
| 位置 | named |
| 既定値 | $false |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。
■入力
■出力
■メモ
■例
例1
Set-FseOnDemandFilter -File -List "List1" -Enabled $true
例1:出力結果
| There is no output if the command completes successfully. |
例1:説明
“List1″というファイル フィルター リストを有効にします。既定の”Delete”アクションと検出されたファイルの検疫は維持されます。
例2
Set-FseOnDemandFilter -File -List "List1" -Enabled $false
例2:出力結果
| There is no output if the command completes successfully. |
例2:説明
“List1″というファイル フィルター リストを無効にします。新しいフィルター リストが既定で無効になっているため、このフィルター リストが以前に有効になっていたことが想定されます。
例3
Set-FseOnDemandFilter -Subject -List "List2" -Enabled $true
例3:出力結果
| There is no output if the command completes successfully. |
例3:説明
アクションおよび検疫の既定の設定を使用して、件名フィルター リスト”List2″を有効にします。
例4
Set-FseOnDemandFilter -SenderDomain -List "BadSenders" -Enabled $true -Quarantine $false
例4:出力結果
| There is no output if the command completes successfully. |
例4:説明
“BadSenders”という送信者ドメイン フィルター リストを有効にします。フィルター条件に一致したファイルは検疫されません。
■関連するリンク
- Get-FseOnDemandFilter
[参考]
- Forefront Protection 2010 for Exchange Server : ホーム
http://www.microsoft.com/japan/forefront/protection-for-exchange/default.mspx - Microsoft Forefront Protection 2010 for Exchange Server
http://technet.microsoft.com/ja-jp/library/cc482977.aspx - Forefront Protection 2010 for Exchange Server : ホワイト ペーパー
http://www.microsoft.com/japan/forefront/protection-for-exchange/white-papers.mspx - Updates for Microsoft Forefront and Related Technologies
http://technet.microsoft.com/en-us/forefront/ff899332
コメント
[…] Set-FseOnDemandFilter […]