Set-AzureServiceAntimalwareExtension

  • Référence
Module:
Azure

Configure l’extension Microsoft Antimalware pour les services cloud.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Important

Services Cloud (classique) est désormais déconseillé pour les nouveaux clients et sera supprimé le 31 août 2024 pour tous les clients. Les nouveaux déploiements doivent utiliser le nouveau modèle de déploiement basé sur Azure Resource Manager Azure Cloud Services (support étendu) .

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

Description

L’applet de commande Set-AzureServiceAntimalwareExtension configure l’extension Microsoft Antimalware pour un service cloud. Vous pouvez spécifier des valeurs qui remplacent et complètent les valeurs dans la configuration XML, telles que le contexte du compte de stockage.

Exemples

Exemple 1 : Activer l’extension

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

Les deux premières commandes créent un objet XmlDocument qui contient une configuration pour l’extension Microsoft Antimalware, puis les stockent dans la variable $XmlConfig.

Exemple 2 : Activer l’extension pour l’emplacement intermédiaire

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

Les deux premières commandes créent un objet XmlDocument qui contient une configuration pour l’extension Microsoft Antimalware, puis les stockent dans la variable $XmlConfig.

Exemple 3 : Activer l’extension avec surveillance

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

Les deux premières commandes créent un objet XmlDocument qui contient une configuration pour l’extension Microsoft Antimalware, puis les stockent dans la variable $XmlConfig.

Paramètres

-AntimalwareConfiguration

Spécifie un objet XmlDocument qui contient la configuration microsoft Antimalware. Cet objet ne doit pas être $Null ou vide. L’objet de configuration doit inclure au minimum le contenu suivant pour activer l’extension Microsoft Antimalware :

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

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

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Renseignez-vous
  • SilentlyContinue
  • Arrêter
  • Suspendre
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Spécifie une variable d’informations.

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

-Monitoring

Spécifie s’il faut collecter les événements Microsoft Antimalware. Les valeurs autorisées sont :

  • SUR. Collectez les événements Microsoft Antimalware dans le contexte de stockage.

  • OFF. Ne collectez pas les événements Microsoft Antimalware.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-Role

Spécifie un tableau de rôles. La valeur par défaut est tous les rôles.

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

-ServiceName

Spécifie le nom du service cloud.

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

-Slot

Spécifie un emplacement de déploiement. Les valeurs autorisées sont :

  • Production

  • Staging

La valeur par défaut est Production.

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

-StorageContext

Spécifie un contexte de stockage Azure pour la surveillance de Microsoft Antimalware.

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