Set-VBRMalwareDetectionOptions

Short Description

Modifies malware detection settings.

Note

This cmdlet is available starting from Veeam Backup & Replication 12.1 (build 12.1.0.2131).

Applies to

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

Set-VBRMalwareDetectionOptions [-EnableGuestIndexScan] [-EnableInlineMalwareScan] [-EnableQuickBackupOnExternalEvent] [-IgnoredPaths <String[]>] [-NonSuspiciousExtensions <String[]>] [-NotificationOptions <VBRNotificationOptions>] [-Sensitivity {Low | BetweenLowAndNormal | Normal | BetweenNormalAndExtreme | Extreme}] [-SuspiciousExtensions <String[]>] [-UpdateExtensionsListPeriodically]  [<CommonParameters>]

Detailed Description

This cmdlet modifies malware detection settings.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

EnableGuestIndexScan

Enables guest indexing data scan. If you provide this parameter, the cmdlet will scan guest indexing data for the following malware activity:

  • Known suspicious files and extensions
  • Renamed files
  • Deleted files

Note: You must also enable the guest file indexing option for a job. To do this, run the Enable-VBRJobGuestFSIndexing cmdlet.

Default: False.

SwitchParameter

False

Named

False

EnableInlineMalwareScan

Enables inline scan. If you provide this parameter, the cmdlet will scan data blocks for the following malware activity:

  • Encrypted files
  • Onion links
  • Ransom notes

Use the Sensitivity parameter to specify the level of scan sensitivity.

Default: False.

SwitchParameter

False

Named

False

EnableQuickBackupOnExternalEvent

Enables a Quick Backup. If you provide this parameter, the cmdlet will initiate a Quick Backup of machines when the system gets notification of the infection threat.

Default: False.

SwitchParameter

False

Named

False

IgnoredPaths

Defines a path to the trusted file or folder. The cmdlet will not check these files or folders.

Note: This parameter is available starting from Veeam Backup & Replication 12.1.2 (build 12.1.2.179). It is applied only to guest indexing data scan when detecting known suspicious files and extensions, deleted files, and renamed files.

String[]

False

Named

False

NonSuspiciousExtensions

Defines a file mask for trusted file extensions. The cmdlet will not check files with these extensions.

Note: This parameter is applied only to guest indexing data scan when detecting known suspicious files and extensions, deleted files, and renamed files.

String[]

False

Named

False

NotificationOptions

Specifies notification options. The cmdlet will set malware detection settings with these notification options.

Accepts the VBRNotificationOptions object. To create this object, run the New-VBRNotificationOptions cmdlet.

False

Named

False

Sensitivity

Specifies the level of inline scan sensitivity:

  • Low
  • BetweenLowAndNormal
  • Normal
  • BetweenNormalAndExtreme
  • Extreme

Default: Normal.

VBRRansomwareScanningSensitivity

False

Named

False

SuspiciousExtensions

Defines a file mask for suspicious file extensions. The cmdlet will trigger a malware detection event when this type of the file appears in backups.

String[]

False

Named

False

UpdateExtensionsListPeriodically

Defines that Veeam Backup & Replication will update a list of suspicious file extensions automatically.

Default: False.

SwitchParameter

False

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

VBRMalwareDetectionOptions

Examples

Modifying Malware Detection Settings

This command enables the following malware detection settings:

  • Guest indexing data scan for guest OS files and folders.
  • Inline scan with the BetweenNormalAndExtreme sensitivity level.

Set-VBRMalwareDetectionOptions -EnableGuestIndexScan -EnableInlineMalwareScan -Sensitivity BetweenNormalAndExtreme

Page updated 5/20/2024

Page content applies to build 12.1.2.172