Windows Defender Antivirus policy

Windows Defender Antivirus policy is a security policy that enables management of Windows Defender Antivirus settings to protect your workload.

For more information on the Windows Defender Antivirus functionality, refer to https://www.acronis.com/en-us/support/documentation/CyberProtectionService/index.html#44150

The following example can be used when creating a protection plan with this protection policy:

Policy example

  1{
  2    # Put a unique ID of the policy here.
  3    'id': '',
  4    # Windows Defender policy type is 'policy.security.windows_defender'
  5    'type': 'policy.security.windows_defender',
  6    'parent_ids': [
  7        # Put the ID of total protection policy here.
  8    ],
  9    'origin': 'upstream',
 10    'enabled': True,
 11    'settings_schema': '2.0',
 12    'settings': {
 13        # Set to true to check for the latest virus and spyware definitions before running a scheduled scan.
 14        'check_for_signatures_before_running_scan': True,
 15        # Set to true to disable scanning of archive files.
 16        'disable_archive_scanning': False,
 17        # Set to true to enable automatic exclusions provided by the Windows Defender.
 18        # For the list of automatic exclusions, refer to https://docs.microsoft.com/en-us/windows/security/threat-protection/microsoft-defender-antivirus/configure-server-exclusions-microsoft-defender-antivirus#list-of-automatic-exclusions
 19        'disable_auto_exclusions': False,
 20        # Set to true to disable behavior monitoring.
 21        'disable_behavior_monitoring': False,
 22        # Set to true to disable full scan catch-up.
 23        'disable_catchup_full_scan': True,
 24        # Set to true to disable quick scan catch-up.
 25        'disable_catchup_quick_scan': True,
 26        # Set to true to disable email scanning.
 27        'disable_email_scanning': False,
 28        # Set to true to scan all downloaded files and attachments.
 29        'disable_io_antivirus_protection': False,
 30        # Set to true to disallow all users to view full history results.
 31        'disable_privacy_mode': True,
 32        # Set to true to disable real-time protection.
 33        'disable_realtime_monitoring': False,
 34        # Set to true to disable scanning of removable drive.
 35        'disable_removable_drive_scanning': False,
 36        # Set to true to disable creation of a system restore point.
 37        'disable_restore_point': True,
 38        # Set to true to disable the full scan mode on mapped network drives.
 39        'disable_scanning_mapped_network_drives_for_full_scan': True,
 40        # Set to true to disable scanning network files.
 41        'disable_scanning_network_files': True,
 42        # Set to true to disable the scanning of scripts during scans.
 43        'disable_script_scanning': False,
 44        # A list of file extensions to exclude from a scan.
 45        'exclusion_extension': [],
 46        # A list of paths to exclude from a scan.
 47        'exclusion_path': [],
 48        # A list of processes to exclude from a scan.
 49        'exclusion_process': [],
 50        # An action to execute when high level alert is triggered.
 51        'high_threat_default_action': 'QUARANTINE',
 52        # An action to execute when low level alert is triggered.
 53        'low_threat_default_action': 'QUARANTINE',
 54        # An option to participate in Microsoft Active Protection Service.
 55        'maps_reporting': 'DISABLED',
 56        # An action to execute when medium level alert is triggered.
 57        'moderate_threat_default_action': 'QUARANTINE',
 58        # Remove quarantined files after provided number of days.
 59        'quarantine_purge_items_after_delay': 30,
 60        # Set to true to select a random time for the scheduled start and scheduled update for definitions.
 61        'randomize_schedule_task_times': True,
 62        # Specifies scanning configuration for incoming and outgoing files on NTFS volumes. '0' means scan both incoming and outgoing files.
 63        'real_time_scan_direction': 0,
 64        # A day of week when Windows Defender Antivirus will remediate the threats.
 65        'remediation_schedule_day': 'never',
 66        # A time in RFC3339 format when Windows Defender Antivirus will remediate the threats.
 67        'remediation_schedule_time': '02:00:00',
 68        # A number of minutes of minutes before a detection in the additional action state changes to the cleared state.
 69        'reporting_additional_action_time_out': 0,
 70        # A number of minutes before a detection in the critically failed state changes to either the additional action state or the cleared state.
 71        'reporting_critical_failure_time_out': 0,
 72        # A number of minutes before a detection in the non-critically failed state changes to the cleared state.
 73        'reporting_non_critical_time_out': 0,
 74        # An option to limit CPU usage during the scan.
 75        'scan_avg_cpuload_factor': 30,
 76        # Set to true if scheduled scan should be started only when machine is on but not in use.
 77        'scan_only_if_idle_enabled': True,
 78        # A scan mode option.
 79        'scan_parameters': 'FULL_SCAN',
 80        # A number of days to keep items in the scan history folder.
 81        'scan_purge_items_after_delay': 0,
 82        # A day of week when to run a scheduled scan.
 83        'scan_schedule_day': 'fri',
 84        # A time in RFC3339 format when to run a scheduled quick scan.
 85        'scan_schedule_quick_scan_time': '10:00:00',
 86        # A time in RFC3339 format when to run a scheduled scan.
 87        'scan_schedule_time': '12:00:00',
 88        # An action to execute when severe level alert is triggered.
 89        'severe_threat_default_action': 'QUARANTINE',
 90        # A number of minutes that specifies a grace period for the definition update.
 91        'signature_au_grace_period': 0,
 92        # Set to true to initiate definition updates if no antimalware engine is present. If set to false, and if not antimalware engine is present, Windows Defender initiates definition updates on startup.
 93        'signature_disable_update_on_startup_without_engine': False,
 94        # An option to manage the sources for virus and spyware definition updates. Values must be pipe-separated.
 95        'signature_fallback_order': 'MicrosoftUpdateServer|MMPC',
 96        # A day of week when to check virus and spyware definition updates.
 97        'signature_schedule_day': 'everyday',
 98        # A time in RFC3339 format when to check virus and spyware definition updates.
 99        'signature_schedule_time': '12:00:00',
100        # A number of days after which Windows Defender requires a catch-up definition update.
101        'signature_update_catchup_interval': 1,
102        # An interval in hours at which to check for definition updates.
103        'signature_update_interval': 3,
104        # An option to send file samples when a further analysis is required.
105        'submit_samples_consent': 'NEVER_SEND',
106        # A list of actions to execute for the IDs specified in the 'threat_id_default_action_ids' field. Acceptable values: 1 - Clean, 2 - Quarantine, 3 - Remove, 6 - Allow, 8 - UserDefined, 9 - NoAction, 10 - Block.
107        'threat_id_default_action_actions': [],
108        # A list of threat IDs for which the default action will be modified in the 'threat_id_default_action_actions' field.
109        'threat_id_default_action_ids': [],
110        # Set to true to disable Window Defender Antivirus GUI.
111        'ui_lockdown': False,
112        # An action to execute when an unknown threat was found.
113        'unknown_threat_default_action': 'ANY'
114    }
115}