Delen via

Set-AzureVMMicrosoftAntimalwareExtension

  • Referentie
Module:
Azure

Hiermee configureert u de Microsoft Antimalware-extensie voor een virtuele machine.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

De cmdlet Set-AzureVMMicrosoftAntimalwareExtension configureert de Microsoft Antimalware-extensie voor een virtuele machine. U kunt de extensie inschakelen, uitschakelen of verwijderen.

Voorbeelden

Voorbeeld 1: De extensie inschakelen met behulp van een configuratiebestand

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

Met deze opdracht wordt de Extensie Microsoft Antimalware ingeschakeld met behulp van een configuratiebestand. De opdracht maakt gebruik van de Get-AzureVM-cmdlet om het opgegeven virtuele-machineobject op te halen en geeft het object vervolgens door aan de huidige cmdlet met behulp van de pijplijnoperator.

Voorbeeld 2: De extensie inschakelen en bewaking inschakelen

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

Met de eerste opdracht maakt u een AzureStorageContext-object met behulp van de cmdlet New-AzureStorageContext en slaat u het vervolgens op in de $StorageContext variabele.

Voorbeeld 3: De extensie inschakelen door een configuratieobject op te geven

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

Met de eerste opdracht maakt u een tekenreeksobject door een JSON-configuratie voor de Extensie Microsoft Antimalware te lezen en vervolgens op te slaan in de variabele $config_string.

Voorbeeld 4: De extensie uitschakelen

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

Met deze opdracht wordt de extensie uitgeschakeld zonder deze te verwijderen. De opdracht maakt gebruik van Get-AzureVM om het opgegeven virtuele-machineobject op te halen en geeft het object vervolgens door aan de huidige cmdlet.

Voorbeeld 5: De extensie verwijderen

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

Met deze opdracht verwijdert u de Microsoft Antimalware-extensie van de virtuele machine. De opdracht maakt gebruik van Get-AzureVM om het opgegeven virtuele-machineobject op te halen en geeft het object vervolgens door aan de huidige cmdlet.

Parameters

-AntimalwareConfigFile

Hiermee geeft u het absolute pad van het Microsoft Antimalware-configuratiebestand. Geef deze parameter niet op als u de parameter AntimalwareConfiguration opgeeft. Het configuratiebestand moet minimaal de volgende inhoud bevatten om de extensie Microsoft Antimalware in te schakelen:

{ "AntimalwareEnabled": true }

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-AntimalwareConfiguration

Hiermee geeft u een tekenreeksobject op dat de Configuratie van Microsoft Antimalware bevat. Dit object mag niet $Null of leeg zijn. Geef deze parameter niet op als u de parameter AntimalwareConfigFile opgeeft. Het configuratieobject moet minimaal de volgende inhoud bevatten om de Microsoft Antimalware-extensie in te schakelen: ^{ "AntimalwareEnabled": true }

Voorbeeld van JSON-configuratie van Microsoft Antimalware:

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

"Uitsluitingen": { "Extensions": ".ext1;. ext2, "Paden": "c:\excluded-path-1; c:\excluded-path-2", "Processen": "excludedproc1.exe; excludedproc2.exe" }

}

Opmerkingen: AntimalwareEnabled is een vereiste parameter. Waarden: true = Inschakelen. false= Fout als onwaar is geen ondersteunde waarde

RealtimeProtectionEnabled: true/false. true = Enable. false = Uitschakelen. De standaardwaarde is waar

ScheduledScanSettings:
isEnabled=true/false day=0-8 (0-daily, 1-Sunday, 2-Monday, ...., 7-Saturday, 8-Disabled) time=0-1440 (gemeten in minuten na middernacht - 60-1AM>, 120 -> 2AM, ... ) scanType="Quick" of "Full" (Standaard is Quick) Opmerking: If isEnabled=true is de enige opgegeven instelling, de volgende standaardwaarden zijn ingesteld: day=7 (zaterdag), time=120 (2:00), scanType="Quick" Uitsluitingen: Meerdere uitsluitingen in dezelfde lijst worden opgegeven met behulp van puntkommascheidingstekens.

Als er geen uitsluitingen zijn opgegeven, worden de bestaande uitsluitingen, indien aanwezig, overschreven door leeg op het systeem.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Disable

Geeft aan dat de cmdlet de Microsoft Antimalware-extensie uitschakelt. Als u de extensie opnieuw wilt inschakelen op dezelfde virtuele machine, voert u Set-AzureVMMicrosoftAntimalwareExtension uit zonder de parameter Disable.

Type:SwitchParameter
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

  • Verdergaan
  • Negeren
  • Vragen
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliassen:infa
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:String
Aliassen:iv
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Monitoring

Hiermee geeft u op of Microsoft Antimalware-gebeurtenissen moeten worden verzameld.

De aanvaardbare waarden voor deze parameter zijn:

  • OP. Verzamel Microsoft Antimalware-gebeurtenissen voor opslagcontext.
  • AF. Verzamel geen Microsoft Antimalware-gebeurtenissen.
Type:String
Position:3
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NoConfig

Geeft aan dat deze cmdlet de optie NoConfig opgeeft.

Type:SwitchParameter
Position:3
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StorageContext

Hiermee geeft u een Azure-opslagcontext op voor Microsoft Antimalware-bewaking.

Type:AzureStorageContext
Position:4
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Uninstall

Geeft aan dat met deze cmdlet de Microsoft Antimalware-extensie van de virtuele machine wordt verwijderd. Als bewaking is ingeschakeld, verwijdert de cmdlet ook de verzameling Microsoft Antimalware-gebeurtenissen.

Type:SwitchParameter
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Version

Hiermee geeft u de extensieversie als een tekenreeks. Opmerking: de ondersteunde versie is 1.5. De oudere versies worden niet ondersteund door Microsoft.

Type:String
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VM

Hiermee geeft u de virtuele machine als een IPersistentVM-object.

Type:IPersistentVM
Aliassen:InputObject
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False