Freigeben über


Set-AzureServiceAntimalwareExtension

Konfiguriert die Microsoft-Antischadsoftwareerweiterung für Clouddienste.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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\>

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

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortfahren
  • Ignorieren
  • Fragen
  • SilentlyContinue
  • Beenden
  • Angehalten
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Gibt eine Informationsvariable an.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Profile

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

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

-Role

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

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

-ServiceName

Gibt den Namen des Clouddiensts an.

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

-Slot

Gibt einen Bereitstellungsplatz an. Gültige Werte sind:

  • Bereitstellung

  • Staging

Der Standardwert ist Production.

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

-StorageContext

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

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