Freigeben über


Set-AzureVMMicrosoftAntimalwareExtension

Konfiguriert die Microsoft-Antischadsoftwareerweiterung für einen virtuellen Computer.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

EnableMicrosoftAntimalwareExtensionJsonConfigFilePath (Standardwert)

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

EnableMicrosoftAntimalwareExtensionJsonConfig

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

DisableMicrosoftAntimalwareExtension

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

UninstallMicrosoftAntimalwareExtension

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

ConfigureMicrosoftAntimalwareMonitoring

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

Beschreibung

Das Cmdlet Set-AzureVMMicrosoftAntimalwareExtension konfiguriert die Microsoft Antimalware-Erweiterung für einen virtuellen Computer. Sie können die Erweiterung aktivieren, deaktivieren oder deinstallieren.

Beispiele

Beispiel 1: Aktivieren der Erweiterung mithilfe einer Konfigurationsdatei

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

Mit diesem Befehl wird die Microsoft Antimalware-Erweiterung mithilfe einer Konfigurationsdatei aktiviert. Der Befehl verwendet das Cmdlet "Get-AzureVM ", um das angegebene Objekt des virtuellen Computers abzurufen, und übergibt das Objekt dann mithilfe des Pipelineoperators an das aktuelle Cmdlet.

Beispiel 2: Aktivieren der Erweiterung und Aktivieren der Überwachung

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

Der erste Befehl erstellt ein AzureStorageContext-Objekt mithilfe des Cmdlets New-AzureStorageContext und speichert es dann in der $StorageContext Variablen.

Beispiel 3: Aktivieren der Erweiterung durch Angeben eines Konfigurationsobjekts

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

Der erste Befehl erstellt ein Zeichenfolgenobjekt, indem eine JSON-Konfiguration für die Microsoft Antimalware-Erweiterung gelesen und dann in der variablen $config_Zeichenfolge gespeichert wird.

Beispiel 4: Deaktivieren der Erweiterung

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

Mit diesem Befehl wird die Erweiterung deaktiviert, ohne sie zu entfernen. Der Befehl verwendet Get-AzureVM, um das angegebene Objekt des virtuellen Computers abzurufen, und übergibt das Objekt dann an das aktuelle Cmdlet.

Beispiel 5: Entfernen der Erweiterung

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

Mit diesem Befehl wird die Microsoft Antimalware-Erweiterung vom virtuellen Computer entfernt. Der Befehl verwendet Get-AzureVM, um das angegebene Objekt des virtuellen Computers abzurufen, und übergibt das Objekt dann an das aktuelle Cmdlet.

Parameter

-AntimalwareConfigFile

Gibt den absoluten Pfad der Microsoft Antimalware-Konfigurationsdatei an. Geben Sie diesen Parameter nicht an, wenn Sie den Parameter AntimalwareConfiguration angeben. Die Konfigurationsdatei muss mindestens den folgenden Inhalt enthalten, um die Microsoft Antimalware-Erweiterung zu aktivieren:

{ "AntimalwareEnabled": true }

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

EnableMicrosoftAntimalwareExtensionJsonConfigFilePath
Position:1
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-AntimalwareConfiguration

Gibt ein Zeichenfolgenobjekt an, das die Microsoft Antimalware-Konfiguration enthält. Dieses Objekt darf nicht $Null oder leer sein. Geben Sie diesen Parameter nicht an, wenn Sie den Parameter AntimalwareConfigFile angeben. Das Konfigurationsobjekt muss mindestens den folgenden Inhalt enthalten, um die Microsoft-Antischadsoftwareerweiterung zu aktivieren: **{ "AntimalwareEnabled": true }

JSON-Konfigurationsbeispiel für die Microsoft Antimalware:

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

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

}

Hinweise: AntischadsoftwareEnabled ist ein erforderlicher Parameter. Werte: true= Enable. false= Fehler als falsch ist kein unterstützter Wert.

RealtimeProtectionEnabled: true/false. true = Aktivieren. false = Deaktivieren. Die Standardeinstellung ist „true“.

ScheduledScanSettings: isEnabled=true/false day=0-8 (0-täglich, 1-Sonntag, 2-Montag, ...., 7-Samstag, 8-Disabled) time=0-1440 (gemessen in Minuten nach Mitternacht - 60-1AM>, 120 -> 2AM, ... ) scanType="Quick" oder "Full" (Standard ist Schnell) Hinweis: Wenn isEnabled=true die einzige angegebene Einstellung ist, werden die folgenden Standardwerte festgelegt: day=7 (Samstag), time=120 (2 AM), scanType="Quick" Ausschlüsse: Mehrere Ausschlüsse in derselben Liste werden mithilfe von Semikolonstrennzeichen angegeben.

Wenn keine Ausschlüsse angegeben werden, werden die vorhandenen Ausschlüsse (falls vorhanden) im System von leerem Text überschrieben.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

EnableMicrosoftAntimalwareExtensionJsonConfig
Position:1
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Disable

Gibt an, dass das Cmdlet die Microsoft-Antischadsoftwareerweiterung deaktiviert. Um die Erweiterung auf demselben virtuellen Computer erneut zu aktivieren, führen Sie Set-AzureVMMicrosoftAntimalwareExtension ohne den Parameter Disable aus.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

DisableMicrosoftAntimalwareExtension
Position:2
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten

Parametereigenschaften

Typ:ActionPreference
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:infa

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InformationVariable

Gibt eine Informationsvariable an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Iv

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Monitoring

Gibt an, ob Microsoft Antimalware-Ereignisse erfasst werden sollen.

Zulässige Werte für diesen Parameter:

  • AUF. Sammeln Sie Microsoft-Antischadsoftwareereignisse im Speicherkontext.
  • AUS. Sammeln Sie keine Microsoft Antimalware-Ereignisse.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

EnableMicrosoftAntimalwareExtensionJsonConfigFilePath
Position:3
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
EnableMicrosoftAntimalwareExtensionJsonConfig
Position:3
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-NoConfig

Gibt an, dass dieses Cmdlet die NoConfig-Option angibt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ConfigureMicrosoftAntimalwareMonitoring
Position:3
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Parametereigenschaften

Typ:AzureSMProfile
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StorageContext

Gibt einen Azure-Speicherkontext für die Microsoft-Antischadsoftwareüberwachung an.

Parametereigenschaften

Typ:AzureStorageContext
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

EnableMicrosoftAntimalwareExtensionJsonConfigFilePath
Position:4
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
EnableMicrosoftAntimalwareExtensionJsonConfig
Position:4
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
ConfigureMicrosoftAntimalwareMonitoring
Position:4
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Uninstall

Gibt an, dass dieses Cmdlet die Microsoft Antimalware-Erweiterung vom virtuellen Computer deinstalliert. Wenn die Überwachung aktiviert wurde, entfernt das Cmdlet auch die Sammlung von Microsoft Antimalware-Ereignissen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

UninstallMicrosoftAntimalwareExtension
Position:1
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Version

Gibt die Erweiterungsversion als Zeichenfolge an. Hinweis: Die unterstützte Version ist 1.5. Die älteren Versionen werden von Microsoft nicht unterstützt.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

EnableMicrosoftAntimalwareExtensionJsonConfigFilePath
Position:2
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
EnableMicrosoftAntimalwareExtensionJsonConfig
Position:2
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
DisableMicrosoftAntimalwareExtension
Position:2
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-VM

Gibt den virtuellen Computer als IPersistentVM-Objekt an.

Parametereigenschaften

Typ:IPersistentVM
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:InputObject

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.