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

スポンサーリンク

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>
このコマンドレットは、次の共通パラメーターをサポートします: VerboseDebugErrorActionErrorVariableWarningActionWarningVariableOutBuffer、および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

[参考]