Codevoorbeelden voor het inschakelen en configureren van Microsoft Antimalware voor Azure

Dit artikel bevat PowerShell-codevoorbeelden voor het inschakelen en configureren van Microsoft Antimalware voor verschillende Azure-services, waaronder:

  • Azure Resource Manager-VMs
  • Azure Service Fabric-clusters
  • Azure Cloud Services (uitgebreide ondersteuning)
  • Azure Arc-ingeschakelde servers

Gebruik deze voorbeelden om de Microsoft Antimalware-extensie te implementeren en te configureren in je Azure-omgevingen.

Microsoft Antimalware implementeren op Azure Resource Manager VM's

Opmerking

Voordat je dit codevoorbeeld uitvoert, verwijder je de commentaar op de variabelen en geef je de juiste waarden op.

Waarschuwing

Als u deze extensie implementeert of bijwerkt, worden bestaande Microsoft Defender Antivirus-instellingen, inclusief uitsluitingen, vervangen. Als u uw instellingen wilt behouden, geeft u deze op in de extensieconfiguratie. Zie De standaard- en aangepaste antimalwareconfiguratie voor meer informatie.

# Script to add Microsoft Antimalware extension to Azure Resource Manager VMs
# Specify your subscription ID
$subscriptionId= " SUBSCRIPTION ID HERE "
# Specify location, resource group, and VM for the extension
$location = " LOCATION HERE " # For example, "Southeast Asia" or "Central US"
$resourceGroupName = " RESOURCE GROUP NAME HERE "
$vmName = " VM NAME HERE "

# Enable Antimalware with default policies
$settingString = '{"AntimalwareEnabled": true}'
# Enable Antimalware with custom policies
# $settingString = '{
# "AntimalwareEnabled": true,
# "RealtimeProtectionEnabled": true,
# "ScheduledScanSettings": {
#                             "isEnabled": true,
#                             "day": 0,
#                             "time": 120,
#                             "scanType": "Quick"
#                             },
# "Exclusions": {
#            "Extensions": ".ext1,.ext2",
#                  "Paths":"",
#                  "Processes":"sampl1e1.exe, sample2.exe"
#             },
# "SignatureUpdates": {
#                               "FileSharesSources": "",
#                               "FallbackOrder": "",
#                               "ScheduleDay": 0,
#                               "UpdateInterval": 0,
#                       },
# "CloudProtection": true
#
# }'
# Sign in to Azure and select the subscription to use
Connect-AzAccount

Set-AzContext -SubscriptionId $subscriptionId
# Retrieve the most recent version number of the extension
$allVersions = (Get-AzVMExtensionImage -Location $location -PublisherName "Microsoft.Azure.Security" -Type "IaaSAntimalware").Version
$versionString = $allVersions[($allVersions.Count)-1].Split(".")[0] + "." + $allVersions[($allVersions.Count)-1].Split(".")[1]
# Set the extension by using prepared values
Set-AzVMExtension -ResourceGroupName $resourceGroupName -Location $location -VMName $vmName -Name "IaaSAntimalware" -Publisher "Microsoft.Azure.Security" -ExtensionType "IaaSAntimalware" -TypeHandlerVersion $versionString -SettingString $settingString

Voeg Microsoft Antimalware toe aan Azure Service Fabric-clusters

Azure Service Fabric gebruikt Azure virtual machine scale sets om Service Fabric-clusters te creëren. De template voor virtual machine scale sets die Service Fabric-clusters aanmaakt, is niet ingeschakeld met de Antimalware-extensie. Schakel Antimalware afzonderlijk in op de schaalsets. Wanneer je dit inschakelt voor virtuele-machineschaalsets, nemen alle knooppunten die binnen de virtuele-machineschaalsets worden gemaakt deze instelling over en krijgen ze automatisch de extensie.

Het volgende codevoorbeeld laat zien hoe je de IaaS Antimalware-extensie kunt inschakelen met behulp van de Az.Compute PowerShell-cmdlets.

Opmerking

Voordat je dit codevoorbeeld uitvoert, verwijder je de commentaar op de variabelen en geef je de juiste waarden op.

Waarschuwing

Als u deze extensie implementeert of bijwerkt, worden bestaande Microsoft Defender Antivirus-instellingen, inclusief uitsluitingen, vervangen. Als u uw instellingen wilt behouden, geeft u deze op in de extensieconfiguratie. Zie De standaard- en aangepaste antimalwareconfiguratie voor meer informatie.

# Script to add Microsoft Antimalware extension to a virtual machine scale set (VMSS) and Service Fabric cluster
# Sign in to Azure and select the subscription to use
Connect-AzAccount
# Specify your subscription ID
$subscriptionId="SUBSCRIPTION ID HERE"
Set-AzContext -SubscriptionId $subscriptionId
# Specify location, resource group, and VMSS for the extension
$location = "LOCATION HERE" # For example, "West US", "Southeast Asia", or "Central US"
$resourceGroupName = "RESOURCE GROUP NAME HERE"
$vmScaleSetName = "YOUR VM SCALE SET NAME"

# Customize the configuration.json configuration file according to the documentation: https://msdn.microsoft.com/library/dn771716.aspx
$settingString = '{"AntimalwareEnabled": true}'
# Enable Antimalware with custom policies
# $settingString = '{
# "AntimalwareEnabled": true,
# "RealtimeProtectionEnabled": true,
# "ScheduledScanSettings": {
#                             "isEnabled": true,
#                             "day": 0,
#                             "time": 120,
#                             "scanType": "Quick"
#                             },
# "Exclusions": {
#            "Extensions": ".ext1,.ext2",
#                  "Paths":"",
#                  "Processes":"sampl1e1.exe, sample2.exe"
#             } ,
# "SignatureUpdates": {
#                               "FileSharesSources": "",
#                               "FallbackOrder": "",
#                               "ScheduleDay": 0,
#                               "UpdateInterval": 0,
#                       },
# "CloudProtection": true
# }'

# Retrieve the most recent version number of the extension
$allVersions = (Get-AzVMExtensionImage -Location $location -PublisherName "Microsoft.Azure.Security" -Type "IaaSAntimalware").Version
$versionString = $allVersions[($allVersions.Count)-1].Split(".")[0] + "." + $allVersions[($allVersions.Count)-1].Split(".")[1]
$vmss = Get-AzVmss -ResourceGroupName $resourceGroupName -VMScaleSetName $vmScaleSetName
Add-AzVmssExtension -VirtualMachineScaleSet $vmss -Name "IaaSAntimalware" -Publisher "Microsoft.Azure.Security" -Type "IaaSAntimalware" -TypeHandlerVersion $versionString -Setting $settingString
Update-AzVmss -ResourceGroupName $resourceGroupName -VMScaleSetName $vmScaleSetName -VirtualMachineScaleSet $vmss

Voeg Microsoft Antimalware toe aan Azure Cloud Services door uitgebreide ondersteuning te gebruiken

Het volgende codevoorbeeld laat zien hoe je Microsoft Antimalware kunt toevoegen of configureren aan Azure Cloud Services door uitgebreide ondersteuning via PowerShell-cmdlets.

Opmerking

Voordat je dit codevoorbeeld uitvoert, verwijder je de commentaar op de variabelen en geef je de juiste waarden op.

Waarschuwing

Als u deze extensie implementeert of bijwerkt, worden bestaande Microsoft Defender Antivirus-instellingen, inclusief uitsluitingen, vervangen. Als u uw instellingen wilt behouden, geeft u deze op in de extensieconfiguratie. Zie De standaard- en aangepaste antimalwareconfiguratie voor meer informatie.

# Create an Antimalware extension object, where file is AntimalwareSettings
$xmlconfig = [IO.File]::ReadAllText("C:\path\to\file.xml")
$extension = New-AzCloudServiceExtensionObject -Name "AntimalwareExtension" -Type "PaaSAntimalware" -Publisher "Microsoft.Azure.Security" -Setting $xmlconfig -TypeHandlerVersion "1.5" -AutoUpgradeMinorVersion $true

# Get existing Cloud Service
$cloudService = Get-AzCloudService -ResourceGroup "ContosOrg" -CloudServiceName "ContosoCS"

# Add Antimalware extension to existing Cloud Service extension object
$cloudService.ExtensionProfile.Extension = $cloudService.ExtensionProfile.Extension + $extension

# Update Cloud Service
$cloudService | Update-AzCloudService

Hier is een voorbeeld van het private configuratie-XML-bestand:

<?xml version="1.0" encoding="utf-8"?>
<AntimalwareConfig
    xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AntimalwareEnabled>true</AntimalwareEnabled>
    <RealtimeProtectionEnabled>true</RealtimeProtectionEnabled>
    <ScheduledScanSettings isEnabled="true" day="1" time="120" scanType="Full" />
    <Exclusions>
        <Extensions>
            <Extension>.ext1</Extension>
            <Extension>.ext2</Extension>
        </Extensions>
        <Paths>
            <Path>c:\excluded-path-1</Path>
            <Path>c:\excluded-path-2</Path>
        </Paths>
        <Processes>
            <Process>excludedproc1.exe</Process>
            <Process>excludedproc2.exe</Process>
        </Processes>
    </Exclusions>
</AntimalwareConfig>

Microsoft Antimalware toevoegen voor servers met Azure Arc

Het volgende codevoorbeeld laat zien hoe je Microsoft Antimalware toevoegt voor servers met Azure Arc via PowerShell-cmdlets.

Opmerking

Voordat je dit codevoorbeeld uitvoert, verwijder je de commentaar op de variabelen en geef je de juiste waarden op.

# Before you use Azure PowerShell to manage VM extensions on your hybrid server managed by Azure Arc-enabled servers, install the Az.ConnectedMachine module. Run the following command on your Azure Arc-enabled server:
# If Az.ConnectedMachine is installed, ensure the version is at least 0.4.0
Install-Module -Name Az.ConnectedMachine
Import-Module -Name Az.ConnectedMachine

# Specify location, resource group, and machine for the extension
$subscriptionid =" SUBSCRIPTION ID HERE "
$location = " LOCATION HERE " # For example, "Southeast Asia" or "Central US"
$resourceGroupName = " RESOURCE GROUP NAME HERE "
$machineName = "MACHINE NAME HERE "

# Enable Antimalware with default policies
$setting = @{"AntimalwareEnabled"=$true}
# Enable Antimalware with custom policies
$setting2 = @{
"AntimalwareEnabled"=$true;
"RealtimeProtectionEnabled"=$true;
"ScheduledScanSettings"= @{
                            "isEnabled"=$true;
                            "day"=0;
                            "time"=120;
                            "scanType"="Quick"
                            };
"Exclusions"= @{
           "Extensions"=".ext1, .ext2";
                 "Paths"="";
                 "Processes"="sampl1e1.exe, sample2.exe"
            };
"SignatureUpdates"= @{
                              "FileSharesSources"="";
                              "FallbackOrder"="";
                              "ScheduleDay"=0;
                              "UpdateInterval"=0;
                      };
"CloudProtection"=$true
}
# Sign in to Azure
Connect-AzAccount
# Enable Antimalware with the policies
New-AzConnectedMachineExtension -Name "IaaSAntimalware" -ResourceGroupName $resourceGroupName -MachineName $machineName -Location $location -SubscriptionId $subscriptionid -Publisher "Microsoft.Azure.Security" -Settings $setting -ExtensionType "IaaSAntimalware"

Volgende stappen