Configuring the on-demand scan


Applies to: Forefront Protection 2010 for SharePoint

Topic Last Modified: 2010-01-27

There are several configuration settings that you can adjust for the Microsoft Forefront Protection 2010 for SharePoint (FPSP) on-demand scan in order to meet the needs of your environment. All changes to on-demand scan settings take effect as soon as you begin the scan.

To configure the on-demand scan
  1. In the Forefront Protection 2010 for SharePoint Administrator Console, click Tasks, and then, in the Task Library, click On-Demand Scan.

  2. In the Task Library - On-Demand Scan pane, in the Scan targets and options section, configure the sites to scan. For information about selecting sites to scan, see Selecting the sites to scan with the on-demand scan.

  3. In the Task Library - On-Demand Scan pane, in the Scan engines and performance section, select the number of scan engines that should be used for each scan. For more information, see Configuring the number of scan engines used for each scan.

  4. In the Task Library - On-Demand Scan pane, in the Scan actions section, configure the following settings:

    1. Action—Select the action that you want performed when a virus is detected. For more information about actions, see Configuring the action when malware is detected.

    2. Quarantine Files—Using the drop-down list, enable (by selecting Yes) or disable (by selecting No) saving infected files detected by the file scanning engines. Quarantining is enabled by default. Enabling quarantine causes deleted files to be storedin a secure location, from which you can recover them. For more information about quarantine, see Viewing and managing quarantine.

    3. Edit Malware Deletion Text—You can specify deletion text, which is used to replace the contents of an infected file during a delete operation. The default deletion text informs you that an infected file was removed, along with the name of the file and the name of the malware found. To change the default deletion text, make the modifications to the deletion text in the Edit Malware Deletion Text dialog box, and then click OK to return to the Task Library - On-Demand Scan pane.

      FPSP provides keywords that can be used in the deletion text field to obtain information from the message in which the infection was found. To use them, in the Edit Malware Deletion Text dialog box, right click, select Insert Field, and then select the desired macro. For more information about keyword macros, see Keyword substitution macros.

Additional settings for the on-demand scan are not available in the Forefront Protection 2010 for SharePoint Administrator Console. You need to use the Forefront Management Shell to enter Windows PowerShell commands.

To access the Forefront Management Shell
  • Click Start, point to All Programs, point to Microsoft Forefront Server Protection, and then click Forefront Management Shell.

After accessing the Forefront Management Shell, you can issue the following configuration commands for the on-demand scan:

Set-FsspOnDemandScan -DocFilesAsContainers

Configures the on-demand scan to scan files that use structured storage and the OLE embedded data format (for example, ,doc, .xls, .ppt, and .shs) as container files. This ensures that any embedded files are scanned as potential malware carriers. The possible values are $false and $true. The default of $true means that files using structured storage are scanned as container files.

Set-FsspOnDemandScan -MaxContainerScanTime

Configures the number of seconds that the on-demand scan scans a compressed file before reporting it as a ScanTimeExceeded virus. This option is intended to prevent the risk of denial of service due to zip-of-death attacks. The default value is 600 seconds (10 minutes).

Set-FsspOnDemandScan -Priority

Indicates the CPU priority of the on-demand scan. The possible values are Normal (the default), BelowNormal, and Low. Changing the setting to BelowNormal or Low enables more important jobs to take precedence when demands on server resources are high.

Set-FsspOnDemandScan -SuppressMalwareNotifications

Indicates whether virus notifications should be sent when malware is detected. The possible values are $false and $true. The default of $false indicates that if virus notifications are enabled, they are sent. If they are disabled, this parameter has no effect.