FPE 2010のForefront管理シェルで使用できるコマンドレット (Set-FseFilterList) について

スポンサーリンク

Forefront Protection 2010 for Exchange Server (FPE 2010) のForefront管理シェルは、PowerShellを用いたコマンドラインインタフェースです。

Forefront管理シェルは、FPE 2010の管理を目的として様々なコマンドレットが用意されていますが、 オンライン上では説明のみで詳細なコマンド オプション情報については公開されていないようです。

このヘルプ情報について、オンライン上で日本語として確認したいと思い、本ブログ上で纏めたいと思います (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集したものとなります)。

この記事では、「Set-FseFilterList」コマンドレットについて記載します (他のコマンドレットについては、「FPE 2010のForefront管理シェルで使用できるコマンドレットについて」を参照)。

■名前

Set-FseFilterList

■概要

フィルター リスト内のすべての値を置換します。

■構文

Set-FseFilterList -AllowedSender -List <string> [-Item <string[]>]
     [<CommonParameters>]

Set-FseFilterList -File -List <string> [-FileType <FileTypeEnum[]>] [-Item <string[]>]
     [<CommonParameters>]

Set-FseFilterList -Keyword -List <string> [-Item <string[]>] [<CommonParameters>]

Set-FseFilterList -List <string> -SenderDomain [-Item <string[]>]
     [<CommonParameters>]

Set-FseFilterList -List <string> -Subject [-Item <string[]>] [<CommonParameters>]

■説明

フィルター リスト内の既存の値をすべて置換します。フィルター リストは、New-FseFilterListを使用して作成されます。

複数のパラメーター セットがあり、それぞれが異なる種類のフィルター リストを表します。パラメーター セットを1つだけ選択する必要があります。パラメーター セットは次のとおりです。

  • -File – ファイル フィルター リストを示します。
  • -Subject – 件名フィルター リストを示します。
  • -SenderDomain – 送信者ドメイン フィルター リストを示します。
  • -Keyword – キーワード フィルター リストを示します。
  • -AllowedSender – 許可された送信者フィルター リストを示します。

各パラメーター セットには、次の2つのパラメーターがあります。-List (フィルター リストの名前) と -Item (値)。また、-Fileパラメーター セットには -FileTypeパラメーターがあります。このパラメーターでは、選択したファイル名に関連付けることができるファイルの種類の一覧を指定します。

■パラメーター

-AllowedSender [<SwitchParameter>]
許可された送信者フィルター リストを示すパラメーター セットです。必須 (1つのパラメーター セットを指定する必要があります)。

必須true
位置named
既定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-File [<SwitchParameter>]
ファイル フィルター リストを示すパラメーター セットです。必須 (1つのパラメーター セットを指定する必要があります)。

必須true
位置named
既定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-FileType <FileTypeEnum[]>
現存するファイル フィルターのファイルの種類で置換するファイルの種類のリストを指定します。省略可能です。複数のファイルの種類は配列として入力します。すべてのファイルの種類が選択されることを示すには、”All”を使用します (種類を特定できないファイルのみを一致させる目的で、UNKNOWNを指定することはできません)。選択したファイル名に関連付けるファイルの種類がリストにない場合は、”ALL”を選択します。これにより、ファイルの種類に関係なく、ファイル名とファイル拡張子に基づいてフィルタリングが実行されます。これにより、ファイルの拡張子を変更するだけではフィルターをすり抜けることができなくなります。

ファイルの種類は、拡張子ではなく検査によって判別されます。たとえば、このパラメーターに”EXE”のみを指定した場合、種類がEXEのファイルのみがこのフィルター リストに一致することになります。このパラメーターは -Itemパラメーターと共に適用します。-Itemパラメーターのエントリはファイルの名前の一致に使用されます。たとえば、-Itemパラメーターにエントリ”foo*”を指定し、-FileTypeパラメーターにエントリ”EXE”を指定した場合、このフィルター リストには”foo”で始まり、種類がEXEのファイルが一致することになります。ファイルの種類は (拡張子ではなく) 検査によって判別されるため、”foobar.exe”、”foolyou.txt”などの名前のファイルが一致として検出される場合があります。-FileTypeパラメーターに”EXE”を指定し、-Itemパラメーターに”*.exe”を指定することで、拡張子が”.exe”で実際の種類が”EXE”のすべてのファイルを一致として扱うファイル フィルターを作成できます。

許可されるファイルの種類は次のとおりです。

  • ALL – すべての種類の選択
  • ANI – Microsoft Windowsアニメーション ポインター
  • ARC – ARCアーカイブと圧縮形式
  • ARJ – ARJアーカイブと圧縮形式
  • ASF – Microsoft オーディオ/ビデオ (.asf、.wmv、および.wmaを含む)
  • AUTOCAD – AutoCAD 図面形式
  • AVI – オーディオ/ビデオ インターリーブ
  • BMP – Microsoft Windowsビットマップ イメージ
  • BZ2 – BZIP2ファイル形式
  • CHI – Microsoftヘルプ インデックス
  • CLASS – Javaバイトコード
  • DATAZ – InstallShield DataZ
  • DOC – Microsoft Office 97-2003ドキュメント (Word、Excel、およびPowerPointを含む)
  • EICAR – Eicarウイルス テスト ファイル
  • EPS – カプセル化されたPostScript
  • EXE – Microsoft Windows実行可能ファイル (.exe、.dll、.ocx、.sys、および.scrを含む)
  • FONT1 – Type1フォント (.pfa、.pfb、および.pfmを含む)
  • GIF – グラフィックス インターチェンジ形式
  • GZIP – .gzip圧縮形式
  • HELP – Microsoftヘルプ
  • HYPERARC – Hyperアーカイブ形式
  • ICO – Microsoft Windowsアイコン イメージ ファイル
  • IMCMIME – MIME With IMCバイナリ ヘッダー
  • ISCAB – Microsoftキャビネット アーカイブ形式
  • JAR – Javaアーカイブ形式
  • JPEG – JPEGグラフィック ファイル形式 (.jpgおよび.jpegを含む)
  • LHA – LHA/LHarc圧縮形式 (.lhaおよび.lzhを含む)
  • MACBIN – MacBinary形式
  • MDB – Microsoft Access 97-2003データベース
  • MP3 – MPEGレイヤー 3 オーディオ形式
  • MPEG1 – MPEGアニメーション ビデオ形式
  • MSCAB – Microsoft Windowsキャビネット アーカイブと圧縮形式
  • MSCOMPRESS – Microsoft圧縮形式
  • MSEXCEL1 – Microsoft Excel 1.x
  • MSLIBRARY – Microsoft オブジェクト コード ライブラリ
  • MSWORD12 – Microsoft Word 1.x および 2.x
  • NOTESDB – Lotus Notes データベース
  • OBJ – オブジェクト コード形式
  • OPENXML – Microsoft Office OpenXML
  • PAL – Adobe PageMakerパレット
  • PCX – PC Paintbrush Exchange形式
  • PDF – Portable Document Format
  • PIF – Microsoftプログラム情報ファイル
  • PKLITE – PKLite圧縮形式
  • PNG – Portable Network Graphics形
  • QTMOVIE – Quick Timeビデオ形式
  • RAR – .rarアーカイブと圧縮形式
  • RIF – Fractal Design Painterビットマップ
  • RTF – リッチ テキスト形式
  • SFXEXE – 自己解凍実行可能ファイル
  • SHORTCUT – Microsoftショートカット (.lnk)
  • TAR – .tarアーカイブ形式
  • TEXT – テキスト形式 (.txt)
  • TNEF – Microsoft Transport Neutral Encapsulation形式
  • TRUETYPE – Microsoft TrueTypeフォント
  • TYPELIB – Microsoftタイプ ライブラリ形式
  • UNICODE – Unicode ダブルバイト テキスト形式
  • UNINST – InstallShieldアンインストール
  • UNIXCOMPRESS – Unix圧縮形式
  • WAV – Waveformオーディオ形式
  • WMF – Microsoft Windowsメタファイル形式
  • WMFVISIO – Visioエクスポート メタファイル形式
  • WRITE – Microsoft Windows Writeファイル
  • XARA – XaraXグラフィック形式
  • ZIP – PKアーカイブと圧縮形式 (.zip)
  • ZOO – .zoo圧縮形式
必須false
位置named
既定値
パイプライン入力を許可するtrue (ByValue, ByPropertyName)
ワイルドカード文字を許可するfalse

-Item <string[]>
フィルター リストの現在の値を置き換える値です。省略可能です。複数のアイテムを配列として入力します。これらは、スキャン中にフィルターによって検索されるアイテム (単語、ファイル名、または式) です。-Itemパラメーターなしで -Listパラメーターを入力した場合、項目は変更されません。フィルター リストは64,000エントリまでに制限され、各エントリの最大長は8,192文字です。

ファイル フィルターの場合、リスト内のアイテムはファイル名に一致します。たとえば、エントリ”foo*”および”bar*”に一致するファイルには、”foo.exe”、”foobar.txt”、”barbell.bat”などがあります。このフィルターで選択されるファイルを制限するには、-FileTypeパラメーターを使用して、名前に加えてファイルの種類の一致も求めるように指定します。

値を入力する代わりに、-Itemの値として、Get-Contentコマンドレットを使用して外部テキスト ファイルから値をインポートできます。形式は次のとおりです。-Item (Get-Contentパスファイル)。コマンドが連携するしくみの詳細な説明については、例を参照してください。

注意: 外部ファイル内の項目は、コンマ区切りにすることも、それぞれ別の行に入力することもできます。

必須false
位置named
既定値
パイプライン入力を許可するtrue (ByValue, ByPropertyName)
ワイルドカード文字を許可するfalse

-Keyword [<SwitchParameter>]
キーワード フィルター リストを示すパラメーター セットです。必須 (1つのパラメーター セットを指定する必要があります)。

必須true
位置named
既定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-List <string>
変更する1つのフィルター リストの名前です。必須です。フィルター リスト名では、大文字と小文字が区別されます。文字列に英数字以外の文字やスペースを含める場合は、引用符で囲んでください。

必須true
位置named
既定値
パイプライン入力を許可するtrue (ByValue, ByPropertyName)
ワイルドカード文字を許可するfalse

-SenderDomain [<SwitchParameter>]
送信者ドメイン フィルター リストを示すパラメーター セットです。必須 (1つのパラメーター セットを指定する必要があります)。

必須true
位置named
既定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-Subject [<SwitchParameter>]
件名フィルター リストを示すパラメーター セットです。必須 (1つのパラメーター セットを指定する必要があります)。

必須true
位置named
既定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: VerboseDebugErrorActionErrorVariableWarningActionWarningVariableOutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。

■入力

■出力

■メモ

■例

例1

 Set-FseFilterList -File -List List1 -Item &quot;*&quot; -FileType EXE 

例1:出力結果

There is no output if the command completes successfully.

例1:説明

List1ファイル フィルター リストの -Itemと -FileTypeの既存の値をすべて置換します。ファイルの種類が”EXE”のファイルをすべてチェックします。

例2

 Set-FseFilterList -Keyword -List &quot;I Lost My Keys&quot; -Item &quot;Hello&quot;,&quot;World&quot; 

例2:出力結果

There is no output if the command completes successfully.

例2:説明

“I Lost My Keys”キーワード フィルター リスト内の既存のアイテムをすべて、”Hello”と”World”で置換します。

例3

 Set-FseFilterList -Keyword -List List2 -Item (Get-Content &quot;c:PSFilterExample.txt&quot;) 

例3:出力結果

There is no output if the command completes successfully.

例3:説明

List2キーワード フィルター リスト内の既存のエントリを、”FilterExample.txt”というファイルの内容で置換します。外部ファイル内の項目は、コンマ区切りにすることも、それぞれ別の行に入力することもできます。

■関連するリンク

  • New-FseFilterList
  • Get-FseFilterList
  • Remove-FseFilterList
  • Clear-FseFilterList
  • Add-FseFilterListEntry
  • Remove-FseFilterListEntry

[参考]