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

スポンサーリンク

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

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

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

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

■名前

New-FsspFilterList

■概要

新しいフィルタ リストを作成します。

■構文

New-FsspFilterList [-File] [-List] <string> [[-Item] <string[]>]
     [-FileType <FileTypeEnum[]>] [<CommonParameters>]

New-FsspFilterList [-Keyword] [-List] <string> [[-Item] <string[]>]
     [<CommonParameters>]

New-FsspFilterList [-User] [-List] <string> [[-Item] <string[]>] [<CommonParameters>]

■説明

ファイルのフィルタリングで使用する単語と式のリストを作成できるようにします。リストの種類と名前を指定する必要があります。

注意: システム内のリストの名前は、フィルタ リストの種類内で一意にする必要があります (大文字と小文字が区別されます)。したがって、ファイル フィルタ リスト内で”List1″というリストと”list1″というリストを使用できます。”List1″というリストは、ファイル フィルタとしても、キーワード フィルタとしても使用できます。New-FsspFilterListを使用すると、一度に1つのリストが作成されます。

注意: フィルタ リストは64,000エントリまでに制限され、各エントリは最大8,192文字です。フィルタ リスト名は256文字までに制限されます。

フィルタ リストが作成されると、そのリストが、該当するすべてのスキャン ジョブに自動的に関連付けられますが、リストの状態は無効になります (つまり、-Enabledパラメータが $false に設定されます)。すべてのForefront Protection 2010 for SharePoint (FPSP) フィルタ リストには、次の共通の既定値が割り当てられます。

  • -Enabled $false
  • -Quarantine $true
  • -Action SkipDetect

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

  • -File – ファイル フィルタ リストを示します。
  • -Keyword – キーワード フィルタ リストを示します。
  • -User – ユーザー ファイル リスト (リアルタイム スキャンのみを表す内部パラメータ) を示します。

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

リストを作成する際に、リストのエントリを指定することもできます。Add-FsspFilterListEntryコマンドレットを使用すると、後でエントリを追加できます。 エントリは、Set-FsspFilterListEntryを使用して変更できます。

■パラメーター

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

必須true
位置1
既定値
パイプライン入力を許可する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)
  • TIFF: Tagged Imageファイル形式
  • 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 パラメータを入力した場合、空のフィルタ リストが作成されます。後でAdd-FsspFilterListEntryコマンドレットを使用して、エントリを追加できます。フィルタ リストは64,000エントリまでに制限され、各エントリの最大長は8,192文字です。

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

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

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

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

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

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

-List <string>
新しいフィルタ リストの名前です。必須です。-Listパラメータは、1つのフィルタ リスト名を受け取ります。リスト名では、大文字と小文字が区別されます。システム内のリストの名前は、フィルタ リストの種類内で一意にする必要があります。したがって、ファイル フィルタ リスト内で”List1″というリストと”list1″というリストを使用できます。”List1″というリストは、ファイル フィルタとしても、キーワード フィルタとしても使用できます。フィルタ リストの名前は256文字までに制限されます。文字列に英数字以外の文字やスペースを含める場合は、引用符で囲んでください。

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

-User [<SwitchParameter>]
Forefront Protection 2010 for SharePointリアルタイム スキャンに関連付けられていて、有効なユーザー フィルタ リストであることを示します。この種類のフィルタ リストは、ユーザー禁止一覧を作成してSharePointポータルへのユーザー アクセスを防ぐ目的でESASによって使用されます。これは、Windows PowerShellで管理者が直接使用するためのものではありません。

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

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

■入力

■出力

■メモ

■例

例1

 New-FsspFilterList -File -List List1 

例1:説明

“List1″という新規のファイル フィルタ リストを作成します。-Itemパラメータを使用していないため、リストは空で、ファイルに一致することはありません。リストにエントリを登録するには、Add-FsspFileFilterListEntryコマンドレットを使用します。

コマンドが正常に完了した場合は、何も出力されません。

例2

 New-FsspFilterList -File -List List2 -Item &quot;*&quot; -FileType EXE 

例2:説明

ファイルの種類がEXEであるすべてのファイルに一致するList2という新規のファイル フィルタ リストを作成します (ファイルの種類は、実際の拡張子に関係なく、検査によって判別されます)。

コマンドが正常に完了した場合は、何も出力されません。

例3

 New-FsspFilterList -File -List &quot;Bad Files&quot; -Item &quot;*.mp3&quot;, &quot;*.jpg&quot;, &quot;*.mpg&quot; -FileType MP3,JPEG,MPEG1 

例3:説明

“Bad Files”というファイル フィルタ リストを作成します。拡張子と実際のファイルの種類の両方を参照することによって、.mp3、.jpg、および.mpgファイルをすべてフィルタリングします。

コマンドが正常に完了した場合は、何も出力されません。

例4

 New-FsspFilterList -File -List List3 -Item &quot;readme.txt&quot; 

例4:説明

List3という新規のファイル フィルタ リストを作成します。このフィルタは、実際のファイルの種類に関係なく、”readme.txt”という名前のすべてのファイルに一致します。

コマンドが正常に完了した場合は、何も出力されません。

例5

 New-FsspFilterList -Keyword -List List1 -Item &quot;Hello&quot; 

例5:説明

List1という新規のキーワード フィルタ リストを作成し、1つのアイテム”Hello”を登録します。

注意: フィルタ リスト名は、フィルタ リストの種類ごとに一意です。そのため、種類ごとに、”List1″というフィルタ リストを作成できます。

コマンドが正常に完了した場合は、何も出力されません。

例6

 New-FsspFilterList -Keyword -List List2 -Item &quot;Hello&quot;,&quot;World&quot; 

例6:説明

List2という新規のキーワード フィルタ リストを作成し、2つのアイテム”Hello”と”World”を登録します。

コマンドが正常に完了した場合は、何も出力されません。

例7

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

例7:説明

“FilterExample.txt”というファイルの内容を”List2″というキーワード フィルタ リストにインポートします。このファイル内のアイテムは、コンマ区切りにすることも、それぞれ別の行に入力することもできます。

コマンドが正常に完了した場合は、何も出力されません。

■関連するリンク

  • Get-FsspFilterList
  • Set-FsspFilterList
  • Remove-FsspFilterList
  • Clear-FsspFilterList
  • Add-FsspFilterListEntry
  • Remove-FsspFilterListEntry

[参考]