Microsoft Antimalware for Azure Cloud Services and Virtual Machines
Microsoft Antimalware for Azure is a free real-time protection that helps identify and remove viruses, spyware, and other malicious software. It generates alerts when known malicious or unwanted software tries to install itself or run on your Azure systems.
The solution is built on the same antimalware platform as Microsoft Security Essentials (MSE), Microsoft Forefront Endpoint Protection, Microsoft System Center Endpoint Protection, Microsoft Intune, and Microsoft Defender for Cloud. Microsoft Antimalware for Azure is a single-agent solution for applications and tenant environments, designed to run in the background without human intervention. Protection may be deployed based on the needs of application workloads, with either basic secure-by-default or advanced custom configuration, including antimalware monitoring.
When you deploy and enable Microsoft Antimalware for Azure for your applications, the following core features are available:
- Real-time protection - monitors activity in Cloud Services and on Virtual Machines to detect and block malware execution.
- Scheduled scanning - Scans periodically to detect malware, including actively running programs.
- Malware remediation - automatically takes action on detected malware, such as deleting or quarantining malicious files and cleaning up malicious registry entries.
- Signature updates - automatically installs the latest protection signatures (virus definitions) to ensure protection is up-to-date on a predetermined frequency.
- Antimalware Engine updates - automatically updates the Microsoft Antimalware engine.
- Antimalware Platform updates - automatically updates the Microsoft Antimalware platform.
- Active protection - reports telemetry metadata about detected threats and suspicious resources to Azure to ensure rapid response to the evolving threat landscape and enables real-time synchronous signature delivery through the Microsoft Active Protection System (MAPS).
- Samples reporting - provides and reports samples to the Microsoft Antimalware service to help refine the service and enable troubleshooting.
- Exclusions - allows application and service administrators to configure exclusions for files, processes, and drives.
- Antimalware event collection - records the antimalware service health, suspicious activities, and remediation actions taken in the operating system event log and collects them into the customer's Azure Storage account.
Note
Microsoft Antimalware can also be deployed using Microsoft Defender for Cloud.
Architecture
Microsoft Antimalware for Azure includes the Microsoft Antimalware Client and Service, Antimalware classic deployment model, Antimalware PowerShell cmdlets, and Azure Diagnostics Extension. Microsoft Antimalware is supported on Windows Server 2008 R2, Windows Server 2012, and Windows Server 2012 R2 operating system families. It isn't supported on the Windows Server 2008 operating system, and also isn't supported in Linux.
The Microsoft Antimalware Client and Service is installed by default in a disabled state in all supported Azure guest operating system families in the Cloud Services platform. The Microsoft Antimalware Client and Service isn't installed by default in the Virtual Machines platform and is available as an optional feature through the Azure portal and Visual Studio Virtual Machine configuration under Security Extensions.
When using Azure App Service on Windows, the underlying service that hosts the web app has Microsoft Antimalware enabled on it. This is used to protect Azure App Service infrastructure and does not run on customer content.
Note
Microsoft Defender Antivirus is the built-in Antimalware enabled in Windows Server 2016 and above. The Azure VM Antimalware extension can still be added to a Windows Server 2016 and above Azure VM with Microsoft Defender Antivirus. In this scenario, the extension applies any optional configuration policies to be used by Microsoft Defender Antivirus The extension does not deploy any other antimalware services. For more information, see the Samples section of this article for more details.
Microsoft antimalware workflow
The Azure service administrator can enable Antimalware for Azure with a default or custom configuration for your Virtual Machines and Cloud Services using the following options:
- Virtual Machines - In the Azure portal, under Security Extensions
- Virtual Machines - Using the Visual Studio virtual machines configuration in Server Explorer
- Virtual Machines and Cloud Services - Using the Antimalware classic deployment model
- Virtual Machines and Cloud Services - Using Antimalware PowerShell cmdlets
The Azure portal or PowerShell cmdlets push the Antimalware extension package file to the Azure system at a predetermined fixed location. The Azure Guest Agent (or the Fabric Agent) launches the Antimalware Extension, applying the Antimalware configuration settings supplied as input. This step enables the Antimalware service with either default or custom configuration settings. If no custom configuration is provided, then the antimalware service is enabled with the default configuration settings. For more information, see the Samples section of this article for more details..
Once running, the Microsoft Antimalware client downloads the latest protection engine and signature definitions from the Internet and loads them on the Azure system. The Microsoft Antimalware service writes service-related events to the system OS events log under the "Microsoft Antimalware" event source. Events include the Antimalware client health state, protection and remediation status, new and old configuration settings, engine updates and signature definitions, and others.
You can enable Antimalware monitoring for your Cloud Service or Virtual Machine to have the Antimalware event log events written as they're produced to your Azure storage account. The Antimalware Service uses the Azure Diagnostics extension to collect Antimalware events from the Azure system into tables in the customer's Azure Storage account.
The deployment workflow including configuration steps and options supported for the above scenarios are documented in Antimalware deployment scenarios section of this document.
Note
You can however use PowerShell/APIs and Azure Resource Manager templates to deploy Virtual Machine Scale Sets with the Microsoft Anti-Malware extension. For installing an extension on an already running Virtual Machine, you can use the sample Python script vmssextn.py. This script gets the existing extension config on the Scale Set and adds an extension to the list of existing extensions on the VM Scale Sets.
Default and Custom Antimalware Configuration
The default configuration settings are applied to enable Antimalware for Azure Cloud Services or Virtual Machines when you don't provide custom configuration settings. The default configuration settings have been pre-optimized for running in the Azure environment. Optionally, you can customize these default configuration settings as required for your Azure application or service deployment and apply them for other deployment scenarios.
The following table summarizes the configuration settings available for the Antimalware service. The default configuration settings are marked under the column labeled "Default."
Antimalware Deployment Scenarios
The scenarios to enable and configure antimalware, including monitoring for Azure Cloud Services and Virtual Machines, are discussed in this section.
Virtual machines - enable and configure antimalware
Deployment While creating a VM using the Azure portal
Follow these steps to enable and configure Microsoft Antimalware for Azure Virtual Machines using the Azure portal while provisioning a Virtual Machine:
- Sign in to the Azure portal.
- To create a new virtual machine, navigate to Virtual machines, select Add, and choose Windows Server.
- Select the version of Windows server that you would like to use.
- Select Create.
- Provide a Name, Username, Password, and create a new resource group or choose an existing resource group.
- Select Ok.
- Choose a vm size.
- In the next section, make the appropriate choices for your needs select the Extensions section.
- Select Add extension
- Under New resource, choose Microsoft Antimalware.
- Select Create
- In the Install extension section file, locations, and process exclusions can be configured as well as other scan options. Choose Ok.
- Choose Ok.
- Back in the Settings section, choose Ok.
- In the Create screen, choose Ok.
See this Azure Resource Manager template for deployment of Antimalware VM extension for Windows.
Deployment using the Visual Studio virtual machine configuration
To enable and configure the Microsoft Antimalware service using Visual Studio:
Connect to Azure in Visual Studio.
Choose your Virtual Machine in the Virtual Machines node in Server Explorer
Right-click configure to view the Virtual Machine configuration page
Select Microsoft Antimalware extension from the dropdown list under Installed Extensions and click Add to configure with default antimalware configuration.
To customize the default Antimalware configuration, select (highlight) the Antimalware extension in the installed extensions list and click Configure.
Replace the default Antimalware configuration with your custom configuration in supported JSON format in the public configuration textbox and click OK.
Click the Update button to push the configuration updates to your Virtual Machine.
Note
The Visual Studio Virtual Machines configuration for Antimalware supports only JSON format configuration. For more information, see the Samples section of this article for more details.
Deployment Using PowerShell cmdlets
An Azure application or service can enable and configure Microsoft Antimalware for Azure Virtual Machines using PowerShell cmdlets.
To enable and configure Microsoft Antimalware using PowerShell cmdlets:
- Set up your PowerShell environment - Refer to the documentation at https://github.com/Azure/azure-powershell
- Use the Set-AzureVMMicrosoftAntimalwareExtension cmdlet to enable and configure Microsoft Antimalware for your Virtual Machine.
Note
The Azure Virtual Machines configuration for Antimalware supports only JSON format configuration. For more information, see the Samples section of this article for more details.
Enable and Configure Antimalware Using PowerShell cmdlets
An Azure application or service can enable and configure Microsoft Antimalware for Azure Cloud Services using PowerShell cmdlets. Microsoft Antimalware is installed in a disabled state in the Cloud Services platform and requires an action by an Azure application to enable it.
To enable and configure Microsoft Antimalware using PowerShell cmdlets:
- Set up your PowerShell environment - Refer to the documentation at https://github.com/Azure/azure-powershell
- Use the Set-AzureServiceExtension cmdlet to enable and configure Microsoft Antimalware for your Cloud Service.
For more information, see the Samples section of this article for more details.
Cloud Services and Virtual Machines - Configuration Using PowerShell cmdlets
An Azure application or service can retrieve the Microsoft Antimalware configuration for Cloud Services and Virtual Machines using PowerShell cmdlets.
To retrieve the Microsoft Antimalware configuration using PowerShell cmdlets:
- Set up your PowerShell environment - Refer to the documentation at https://github.com/Azure/azure-powershell
- For Virtual Machines: Use the Get-AzureVMMicrosoftAntimalwareExtension cmdlet to get the antimalware configuration.
- For Cloud Services: Use the Get-AzureServiceExtension cmdlet to get the Antimalware configuration.
Samples
Remove Antimalware Configuration Using PowerShell cmdlets
An Azure application or service can remove the Antimalware configuration and any associated Antimalware monitoring configuration from the relevant Azure Antimalware and diagnostics service extensions associated with the Cloud Service or Virtual Machine.
To remove Microsoft Antimalware using PowerShell cmdlets:
- Set up your PowerShell environment - Refer to the documentation at https://github.com/Azure/azure-powershell
- For Virtual Machines: Use the Remove-AzureVMMicrosoftAntimalwareExtension cmdlet.
- For Cloud Services: Use the Remove-AzureServiceExtension cmdlet.
To enable antimalware event collection for a virtual machine using the Azure Preview Portal:
- Click any part of the Monitoring lens in the Virtual Machine blade
- Click the Diagnostics command on Metric blade
- Select Status ON and check the option for Windows event system
- . You can choose to uncheck all other options in the list, or leave them enabled per your application service needs.
- The Antimalware event categories "Error", "Warning", "Informational", etc., are captured in your Azure Storage account.
Antimalware events are collected from the Windows event system logs to your Azure Storage account. You can configure the Storage Account for your Virtual Machine to collect Antimalware events by selecting the appropriate storage account.
Enable and configure Antimalware using PowerShell cmdlets for Azure Resource Manager VMs
To enable and configure Microsoft Antimalware for Azure Resource Manager VMs using PowerShell cmdlets:
- Set up your PowerShell environment using this documentation on GitHub.
- Use the Set-AzureRmVMExtension cmdlet to enable and configure Microsoft Antimalware for your VM.
The following code samples are available:
Enable and configure Antimalware to Azure Cloud Service Extended Support (CS-ES) using PowerShell cmdlets
To enable and configure Microsoft Antimalware using PowerShell cmdlets:
- Set up your PowerShell environment - Refer to the documentation at https://github.com/Azure/azure-powershell
- Use the New-AzCloudServiceExtensionObject cmdlet to enable and configure Microsoft Antimalware for your Cloud Service VM.
The following code sample is available:
Enable and configure Antimalware using PowerShell cmdlets for Azure Arc-enabled servers
To enable and configure Microsoft Antimalware for Azure Arc-enabled servers using PowerShell cmdlets:
- Set up your PowerShell environment using this documentation on GitHub.
- Use the New-AzConnectedMachineExtension cmdlet to enable and configure Microsoft Antimalware for your Arc-enabled servers.
The following code samples are available:
Next steps
See code samples to enable and configure Microsoft Antimalware for Azure Resource Manager (ARM) virtual machines.