Set-AzureVMMicrosoftAntimalwareExtension

Modul:

Azure

Konfigurerar Microsoft Antimalware-tillägget för en virtuell dator.

Kommentar

De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.

Syntax

Set-AzureVMMicrosoftAntimalwareExtension
   [-AntimalwareConfigFile] <String>
   [[-Version] <String>]
   [[-Monitoring] <String>]
   [[-StorageContext] <AzureStorageContext>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Set-AzureVMMicrosoftAntimalwareExtension
   [-AntimalwareConfiguration] <String>
   [[-Version] <String>]
   [[-Monitoring] <String>]
   [[-StorageContext] <AzureStorageContext>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Set-AzureVMMicrosoftAntimalwareExtension
   [[-Version] <String>]
   [-Disable]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Set-AzureVMMicrosoftAntimalwareExtension
   [-Uninstall]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Set-AzureVMMicrosoftAntimalwareExtension
   [-Monitoring] <String>
   [[-StorageContext] <AzureStorageContext>]
   [-NoConfig]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Cmdleten Set-AzureVMMicrosoftAntimalwareExtension konfigurerar Microsoft Antimalware-tillägget för en virtuell dator. Du kan aktivera, inaktivera eller avinstallera tillägget.

Exempel

Exempel 1: Aktivera tillägget med hjälp av en konfigurationsfil

PS C:\> Get-AzureVM -ServiceName "ContosoService03" -Name "ContosoVM22" | Set-AzureVMMicrosoftAntimalwareExtension -AntimalwareConfigFile 'C:\configuration\contosoVM.json' | Update-AzureVM

Det här kommandot aktiverar Microsoft Antimalware-tillägget med hjälp av en konfigurationsfil. Kommandot använder cmdleten Get-AzureVM för att hämta det angivna objektet för virtuella datorer och skickar sedan objektet till den aktuella cmdleten med hjälp av pipelineoperatorn.

Exempel 2: Aktivera tillägget och aktivera övervakning

PS C:\> $StorageContext = New-AzureStorageContext -StorageAccountName "contosostoragemain" -StorageAccountKey (Get-AzureStorageKey -StorageAccountName "Contosostoragemain").PrimaryP
S C:\> Get-AzureVM -ServiceName "ContosoService03" -Name"ContosoVM22" | Set-AzureVMMicrosoftAntimalwareExtension -AntimalwareConfigFile 'C:\configuration\contosoVM.json" -Monitoring ON -StorageContext $StorageContext | Update-AzureVM

Det första kommandot skapar ett AzureStorageContext-objekt med hjälp av cmdleten New-AzureStorageContext och lagrar det sedan i variabeln $StorageContext.

Exempel 3: Aktivera tillägget genom att ange ett konfigurationsobjekt

PS C:\> $Config_String = [IO.File]::ReadAllText('C:\configuration\contosoVM.json')
PS C:\> Get-AzureVM -ServiceName "ContosoService03" -Name "ContosoVM22" | Set-AzureVMMicrosoftAntimalwareExtension -AntimalwareConfiguration $Config_String | Update-AzureVM

Det första kommandot skapar ett strängobjekt genom att läsa en JSON-konfiguration för Microsoft Antimalware-tillägget och sedan lagra det i variabeln $config_string.

Exempel 4: Inaktivera tillägget

PS C:\> Get-AzureVM -ServiceName "ContosoService03" -Name "ContosoVM22" | Set-AzureVMMicrosoftAntimalwareExtension -Disable | Update-AzureVM

Det här kommandot inaktiverar tillägget utan att ta bort det. Kommandot använder Get-AzureVM för att hämta det angivna objektet för virtuella datorer och skickar sedan objektet till den aktuella cmdleten.

Exempel 5: Ta bort tillägget

PS C:\> Get-AzureVM -ServiceName "ContosoService03" -Name"ContosoVM22" | Set-AzureVMMicrosoftAntimalwareExtension -Uninstall | Update-AzureVM

Det här kommandot tar bort Microsoft Antimalware-tillägget från den virtuella datorn. Kommandot använder Get-AzureVM för att hämta det angivna objektet för virtuella datorer och skickar sedan objektet till den aktuella cmdleten.

Parametrar

-AntimalwareConfigFile

Anger den absoluta sökvägen för Microsoft Antimalware-konfigurationsfilen. Ange inte den här parametern om du anger parametern AntimalwareConfiguration. Konfigurationsfilen måste minst innehålla följande innehåll för att aktivera Microsoft Antimalware-tillägget:

{ "AntimalwareEnabled": true }

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-AntimalwareConfiguration

Anger ett strängobjekt som innehåller Microsoft Antimalware-konfigurationen. Det här objektet får inte vara $Null eller tomt. Ange inte den här parametern om du anger parametern AntimalwareConfigFile. Konfigurationsobjektet måste minst innehålla följande innehåll för att aktivera Microsoft Antimalware-tillägget: ****{ "AntimalwareEnabled": true }

Microsoft Antimalware JSON-konfigurationsexempel:

{ "AntimalwareEnabled": true, "RealtimeProtectionEnabled": true, "ScheduledScanSettings": { "isEnabled": true, "day": 1, "time": 120, "scanType": "Full" },

"Exclusions": { "Extensions": ".ext1;. ext2", "Paths": "c:\excluded-path-1;c:\excluded-path-2", "Processes": "excludedproc1.exe;excludedproc2.exe" }

}

Anmärkningar: AntimalwareEnabled är en obligatorisk parameter. Värden: true= Enable. false= Fel ut som falskt är inte ett värde som stöds

RealtimeProtectionEnabled: true/false. true = Aktivera. false = Inaktivera. Standardvärdet är sant

ScheduledScanSettings:
isEnabled=true/false day=0-8 (0-daily, 1-Sunday, 2-Monday, ...., 7-Saturday, 8-Inaktiverad) tid =0-1440 (mätt i minuter efter midnatt - 60-1AM>, 120-> 02:00, ... ) scanType="Quick" eller "Full" (Standard är Snabb) Obs! Om isEnabled=true är den enda inställningen anges följande standardvärden: dag=7 (lördag), tid=120 (2 AM), scanType="Quick"-undantag: Flera undantag i samma lista anges med semikolonavgränsare.

Om inga undantag anges skrivs de befintliga undantagen, om några, över av tomma i systemet.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Disable

Anger att cmdleten inaktiverar Microsoft Antimalware-tillägget. Om du vill återaktivera tillägget på samma virtuella dator kör du Set-AzureVMMicrosoftAntimalwareExtension utan parametern Inaktivera.

Type:	SwitchParameter
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-InformationAction

Anger hur den här cmdleten svarar på en informationshändelse.

De godtagbara värdena för den här parametern är:

• Fortsätt
• Ignorera
• Fråga
• TystKontinuera
• Stoppa
• Suspend

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Anger en informationsvariabel.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Monitoring

Anger om microsoft antimalware-händelser ska samlas in.

De godtagbara värdena för den här parametern är:

• PÅ. Samla in Microsoft Antimalware-händelser till lagringskontexten.
• AV. Samla inte in Microsoft Antimalware-händelser.

Type:	String
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoConfig

Anger att den här cmdleten anger alternativet NoConfig.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageContext

Anger en Azure-lagringskontext för Microsoft Antimalware-övervakning.

Type:	AzureStorageContext
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Uninstall

Anger att den här cmdleten avinstallerar Microsoft Antimalware-tillägget från den virtuella datorn. Om övervakningen aktiverades tar cmdleten också bort samlingen med Microsoft Antimalware-händelser.

Type:	SwitchParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Version

Anger tilläggsversionen som en sträng. Obs! Den version som stöds är 1.5. De äldre versionerna stöds inte av Microsoft.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VM

Anger den virtuella datorn som ett IPersistentVM-objekt.

Type:	IPersistentVM
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Relaterade länkar

• Get-AzureVMMicrosoftAntimalwareExtension
• Remove-AzureVMMicrosoftAntimalwareExtension
• Get-AzureVM