Forefront Protection 2010 for SharePoint (FPSP 2010) のForefront管理シェルは、PowerShellを用いたコマンドラインインタフェースです。
Forefront管理シェルは、FPSP 2010の管理を目的として様々なコマンドレットが用意されていますが、 オンライン上では説明のみで詳細なコマンド オプション情報については公開されていないようです。
このヘルプ情報について、オンライン上で日本語として確認したいと思い、本ブログ上で纏めたいと思います (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集したものとなります)。
この記事では、「Set-FsspEngineManagement」コマンドレットについて記載します (他のコマンドレットについては、「FPSP 2010のForefront管理シェルで使用できるコマンドレットについて」を参照)。
■名前
Set-FsspEngineManagement
■概要
エンジン固有の設定を構成します。
■構文
Set-FsspEngineManagement [-OnDemandEngines <ScanJobEngineEnum>] [-OverrideAutomaticManagement <Boolean>] [-RealtimeEngines <ScanJobEngineEnum>] [-ScheduledEngines <ScanJobEngineEnum>] [<CommonParameters>] |
■説明
自動エンジン管理や特定のスキャン ジョブに割り当てられるエンジンなど、エンジンに固有の設定を構成します。
■パラメーター
-OnDemandEngines <ScanJobEngineEnum>
オンデマンド スキャンで使用するエンジンを示します。省略可能です。OverrideAutomaticManagementを$trueに設定している場合のみエンジンを変更できます。それ以外の場合は、エラーが発生します。
必須 | false |
位置 | named |
既定値 | |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-OverrideAutomaticManagement <Boolean>
自動エンジン管理を無効にします。省略可能です。自動エンジン管理とは、Forefront Protection 2010 for SharePointが、スキャン ジョブごとにすべてのスキャン エンジンを選択し、エンジンと定義の更新をスケジューリングすることを指します。指定可能な値は$falseおよび$trueです。既定値の$falseは、自動エンジン管理が有効であることを意味します。$trueに設定すると、自動エンジン管理が上書きされ、エンジンの選択と更新をスケジュールをユーザーが変更できるようになります。
注意: このパラメータでは、Set-FseSignatureUpdateによって管理されている設定 (プライマリ更新パスとセカンダリ更新パスを除く) を変更する機能も制御します。$falseを指定すると、シグネチャ更新の変更試行が失敗します。
$falseが入力されるまで$trueの値は有効なまま保たれるため、これらのパラメータは異なる時刻に入力できます。
Set-FsspEngineManagement -OverrideAutomaticManagement $true -RealtimeEngines engine1, engine2, engine3, engine4 Set-FsspEngineManagement -OndemandEngines engine5, engine1, engine2
2番目の例では、上書きをしても $true のままで、再入力は不要でした。
-OverrideAutomaticManagementが$false (既定値) に設定されている場合は、Set-FsspManagementの他のパラメーターを設定できません。
注意: この値を$trueに設定すると、いずれかのスキャン ジョブまたはすべてのスキャン ジョブで使用するエンジンの一覧を指定できます。指定していないジョブでは、既定のエンジン セットが維持されます。この値を$falseに戻すと、各スキャン ジョブで、元の既定のエンジンがすべて復元されます。
必須 | false |
位置 | named |
既定値 | $false |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-RealtimeEngines <ScanJobEngineEnum>
リアルタイム スキャンで使用するエンジンを示します。省略可能です。OverrideAutomaticManagementを$trueに設定している場合のみエンジンを変更できます。それ以外の場合は、エラーが発生します。
必須 | false |
位置 | named |
既定値 | |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-ScheduledEngines <ScanJobEngineEnum>
定期スキャンで使用するエンジンを示します。省略可能です。OverrideAutomaticManagementを$trueに設定している場合のみエンジンを変更できます。それ以外の場合は、エラーが発生します。
必須 | false |
位置 | named |
既定値 | |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。
■入力
■出力
■メモ
■例
例1
Set-FsspEngineManagement -OverrideAutomaticManagement $true -RealtimeEngines Engine1, Engine2, Engine3, Engine4
例1:説明
自動エンジン管理を上書きし、リアルタイム スキャンの既定のエンジン セットの代わりに”Engine1″、”Engine2″、”Engine3″、および”Engine4″を使用します。Set-FsspEngineManagementの前後でGet-FsspEngineManagementを使用すると、違いがわかります。
コマンドが正常に完了した場合は、何も出力されません。
例2
Set-FsspEngineManagement -ScheduledEngines Engine3, Engine4, Engine5
例2:説明
定期スキャンの既定のエンジン セットの代わりに Engine3、Engine4、およびEngine5を使用します。Set-FsspEngineManagementの前後でGet-FsspEngineManagementを使用すると、違いがわかります。
注意: ここでは、自動管理の上書きがまだ有効であると仮定しているため、-OverrideAutomaticManagementパラメータを再度指定する必要はありません。
コマンドが正常に完了した場合は、何も出力されません。
■関連するリンク
- Get-FsspEngineManagement
- Set-FsspSignatureUpdate
- Get-FsspSignatureUpdate
[参考]
- 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-FsspEngineManagement […]