Freigeben über

Set-AzureServiceAntimalwareExtension

  • Referenz
Modul:
Azure

Konfiguriert die Microsoft-Antischadsoftwareerweiterung für Clouddienste.

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.

Wichtig

Cloud Services (klassisch) wurde für neue Kunden nun als veraltet gekennzeichnet und wird am 31. August 2024 für alle Kunden ausgemustert. In neuen Bereitstellungen sollte das neue auf Azure Resource Manager basierende Bereitstellungsmodell für Azure Cloud Services (erweiterter Support) verwendet werden.

Syntax

Set-AzureServiceAntimalwareExtension
   [-ServiceName] <String>
   [[-Slot] <String>]
   [[-Role] <String[]>]
   [[-AntimalwareConfiguration] <XmlDocument>]
   [[-Monitoring] <String>]
   [[-StorageContext] <AzureStorageContext>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureServiceAntimalwareExtension
   [-ServiceName] <String>
   [[-Slot] <String>]
   [[-Role] <String[]>]
   [[-AntimalwareConfiguration] <XmlDocument>]
   [[-Monitoring] <String>]
   [[-StorageContext] <AzureStorageContext>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureServiceAntimalwareExtension konfiguriert die Microsoft-Antischadsoftwareerweiterung für einen Clouddienst. Sie können Werte angeben, die Werte in der XML-Konfiguration außer Kraft setzen und ergänzen, z. B. den Speicherkontokontext.

Beispiele

Beispiel 1: Aktivieren der Erweiterung

PS C:\> [System.Xml.XmlDocument] $XmlConfig = New-Object System.Xml.XmlDocument 
PS C:\> $XmlConfig.load('C:\configuration\contosoVM.xml')
PS C:\> Set-AzureServiceAntimalwareExtension -ServiceName "ContosoService03" -AntimalwareConfiguration $XmlConfig
Operation succeeded

Die ersten beiden Befehle erstellen ein XmlDocument-Objekt, das eine Konfiguration für die Microsoft Antimalware-Erweiterung enthält, und speichert es dann in der $XmlConfig Variablen.

Beispiel 2: Aktivieren der Erweiterung für den Staging-Slot

PS C:\> [System.Xml.XmlDocument] $XmlConfig = New-Object System.Xml.XmlDocument 
PS C:\> $XmlConfig.load('C:\configuration\contosoVM.xml')
PS C:\> Set-AzureServiceAntimalwareExtension -ServiceName "ContosoService03" -Slot "Staging" -AntimalwareConfiguration $XmlConfig 
Operation succeeded

Die ersten beiden Befehle erstellen ein XmlDocument-Objekt, das eine Konfiguration für die Microsoft Antimalware-Erweiterung enthält, und speichert es dann in der $XmlConfig Variablen.

Beispiel 3: Aktivieren der Erweiterung mit Überwachung

PS C:\> System.Xml.XmlDocument] $XmlConfig = New-Object System.Xml.XmlDocument 
PS C:\> $XmlConfig.load('C:\configuration\contosoVM.xml')
PS C:\> $StorageContext = New-AzureStorageContext -StorageAccountName "contosostoragemain" -StorageAccountKey (Get-AzureStorageKey -StorageAccountName "Contosostoragemain").Primary
PS C:\> Set-AzureServiceAntimalwareExtension -ServiceName "ContosoService03" -AntimalwareConfiguration $XmlConfig -Monitoring ON -StorageContext $StorageContext

Die ersten beiden Befehle erstellen ein XmlDocument-Objekt, das eine Konfiguration für die Microsoft Antimalware-Erweiterung enthält, und speichert es dann in der $XmlConfig Variablen.

Parameter

-AntimalwareConfiguration

Gibt ein XmlDocument-Objekt an, das die Microsoft-Antischadsoftwarekonfiguration enthält. Dieses Objekt darf nicht $Null oder leer sein. Das Konfigurationsobjekt muss mindestens den folgenden Inhalt enthalten, um die Microsoft Antimalware-Erweiterung zu aktivieren:

\<AntimalwareConfig\>\<AntimalwareEnabled\>true\</AntimalwareEnabled\>\</AntimalwareConfig\>

Typ:XmlDocument
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Monitoring

Gibt an, ob Microsoft Antimalware-Ereignisse erfasst werden sollen. Gültige Werte sind:

  • AUF. Sammeln Sie Microsoft-Antischadsoftwareereignisse im Speicherkontext.

  • AUS. Sammeln Sie keine Microsoft Antimalware-Ereignisse.

Typ:String
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

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

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Role

Gibt ein Array von Rollen an. Der Standardwert ist alle Rollen.

Typ:String[]
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServiceName

Gibt den Namen des Clouddiensts an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Slot

Gibt einen Bereitstellungsplatz an. Gültige Werte sind:

  • Produktion

  • Staging

Der Standardwert ist Production.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StorageContext

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

Typ:AzureStorageContext
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False