Set-AzureServiceAntimalwareExtension
Configure l’extension Microsoft Antimalware pour les services cloud.
Remarque
Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.
Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec 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) .
Syntaxe
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 succeededLes 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 succeededLes 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 $StorageContextLes 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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
- Demander
- SilentlyContinue
- Stop
- Suspendre
| Type: | ActionPreference |
| Alias: | infa |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InformationVariable
Spécifie une variable d’informations.
| Type: | String |
| Alias: | iv |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Monitoring
Spécifie s’il faut collecter les événements Microsoft Antimalware. Les valeurs valides sont :
SUR. Collectez les événements Microsoft Antimalware dans le contexte de stockage.
DE. Ne collectez pas les événements Microsoft Antimalware.
| Type: | String |
| Position: | 4 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Role
Spécifie un tableau de rôles. La valeur par défaut est tous les rôles.
| Type: | String[] |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-ServiceName
Spécifie le nom du service cloud.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Slot
Spécifie un emplacement de déploiement. Les valeurs valides sont :
Production
Staging
La valeur par défaut est Production.
| Type: | String |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-StorageContext
Spécifie un contexte de stockage Azure pour la surveillance de Microsoft Antimalware.
| Type: | AzureStorageContext |
| Position: | 5 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |