Forefront Protection 2010 for SharePoint (FPSP 2010) のForefront管理シェルは、PowerShellを用いたコマンドラインインタフェースです。
Forefront管理シェルは、FPSP 2010の管理を目的として様々なコマンドレットが用意されていますが、 オンライン上では説明のみで詳細なコマンド オプション情報については公開されていないようです。
このヘルプ情報について、オンライン上で日本語として確認したいと思い、本ブログ上で纏めたいと思います (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集したものとなります)。
この記事では、「Set-FsspFilterList」コマンドレットについて記載します (他のコマンドレットについては、「FPSP 2010のForefront管理シェルで使用できるコマンドレットについて」を参照)。
■名前
Set-FsspFilterList
■概要
フィルタ リスト内のすべての値を置換します。
■構文
| Set-FsspFilterList -File -List <string> [-FileType <FileTypeEnum[]>] [-Item <string[]>] [<CommonParameters>] Set-FsspFilterList -Keyword -List <string> [-Item <string[]>] [<CommonParameters>] Set-FsspFilterList -List <string> -User [-Item <string[]>] [<CommonParameters>] |
■説明
フィルタ リスト内の既存の値をすべて置換します。フィルタ リストは、New-FsspFilterListを使用して作成されます。
複数のパラメータ セットがあり、それぞれが異なる種類のフィルタ リストを表します。パラメータ セットを1つだけ選択する必要があります。パラメータ セットは次のとおりです。
- -File – ファイル フィルタ リストを示します。
- -Keyword – キーワード フィルタ リストを示します。
- -User – ユーザー ファイル リスト (リアルタイム スキャンのみを表す内部パラメータ) を示します。
■パラメーター
-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)
- 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 (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 |
-User [<SwitchParameter>]
ユーザー フィルタ リストであることを示すパラメータ セットです。この種類のフィルタ リストは、ユーザー禁止一覧を作成してSharePointポータルへのユーザー アクセスを防ぐ目的で ESAS によって使用されます。これは、PowerShellで管理者が直接使用するためのものではありません。これはリアルタイム スキャンのみを表す内部パラメータです。
| 必須 | true |
| 位置 | named |
| 既定値 | |
| パイプライン入力を許可する | false |
| ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。
■入力
■出力
■メモ
■例
例1
Set-FsspFilterList -File -List List1 -Item "*" -FileType EXE
例1:説明
List1ファイル フィルタ リストの -Itemと -FileTypeの既存の値をすべて置換します。ここで、ファイルの種類が”EXE”であるファイルをすべてチェックします。
コマンドが正常に完了した場合は、何も出力されません。
例2
Set-FsspFilterList -Keyword -List "I Lost My Keys" -Item "Hello","World"
例2:説明
“I Lost My Keys”キーワード フィルタ リスト内の既存のアイテムをすべて、”Hello”と”World”で置換します。
コマンドが正常に完了した場合は、何も出力されません。
例3
Set-FsspFilterList -Keyword -List List2 -Item (Get-Content "c:PSFilterExample.txt")
例3:説明
List2キーワード フィルタ リスト内の既存のエントリを、”FilterExample.txt”というファイルの内容で置換します。外部ファイル内の項目は、コンマ区切りにすることも、それぞれ別の行に入力することもできます。
コマンドが正常に完了した場合は、何も出力されません。
■関連するリンク
- New-FsspFilterList
- Get-FsspFilterList
- Remove-FsspFilterList
- Clear-FsspFilterList
- Add-FsspFilterListEntry
- Remove-FsspFilterListEntry
[参考]
- Forefront Protection 2010 for SharePoint : ホーム
http://www.microsoft.com/japan/forefront/protection-for-sharepoint/default.mspx - Microsoft Forefront Protection 2010 for SharePoint
http://technet.microsoft.com/ja-jp/library/cc482990.aspx - Forefront Protection 2010 for SharePoint : ホワイト ペーパー
http://www.microsoft.com/japan/forefront/protection-for-sharepoint/white-papers.mspx - Updates for Microsoft Forefront and Related Technologies
http://technet.microsoft.com/en-us/forefront/ff899332
コメント
[…] Set-FsspFilterList […]