Set-AzureVMMicrosoftAntimalwareExtension

Référence

Module:: Azure

Configure l’extension Microsoft Antimalware pour une machine virtuelle.

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.

Syntax

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

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

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

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

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

Description

L’applet de commande Set-AzureVMMicrosoftAntimalwareExtension configure l’extension Microsoft Antimalware pour une machine virtuelle. Vous pouvez activer, désactiver ou désinstaller l’extension.

Exemples

Exemple 1 : Activer l’extension à l’aide d’un fichier de configuration

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

Cette commande active l’extension Microsoft Antimalware à l’aide d’un fichier de configuration. La commande utilise l’applet de commande Get-AzureVM pour obtenir l’objet de machine virtuelle spécifiée, puis transmet l’objet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline.

Exemple 2 : Activer l’extension et activer la surveillance

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

La première commande crée un objet AzureStorageContext à l’aide de l’applet de commande New-AzureStorageContext , puis la stocke dans la variable $StorageContext.

Exemple 3 : Activer l’extension en spécifiant un objet de configuration

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

La première commande crée un objet de chaîne en lisant une configuration JSON pour l’extension Microsoft Antimalware, puis en la stockant dans la variable $config_string.

Exemple 4 : Désactiver l’extension

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

Cette commande désactive l’extension sans la supprimer. La commande utilise Get-AzureVM pour obtenir l’objet de machine virtuelle spécifié, puis transmet l’objet à l’applet de commande actuelle.

Exemple 5 : Supprimer l’extension

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

Cette commande supprime l’extension Microsoft Antimalware de la machine virtuelle. La commande utilise Get-AzureVM pour obtenir l’objet de machine virtuelle spécifié, puis transmet l’objet à l’applet de commande actuelle.

Paramètres

-AntimalwareConfigFile

Spécifie le chemin absolu du fichier de configuration Microsoft Antimalware. Ne spécifiez pas ce paramètre si vous spécifiez le paramètre AntimalwareConfiguration. Le fichier de configuration doit inclure, au minimum, le contenu suivant pour activer l’extension Microsoft Antimalware :

{ "AntimalwareEnabled": true }

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

-AntimalwareConfiguration

Spécifie un objet de chaîne qui contient la configuration microsoft Antimalware. Cet objet ne doit pas être $Null ou vide. Ne spécifiez pas ce paramètre si vous spécifiez le paramètre AntimalwareConfigFile. L’objet de configuration doit inclure, au minimum, le contenu suivant pour activer l’extension Microsoft Antimalware : ***{ « AntimalwareEnabled »: true }

Exemple de configuration JSON de Microsoft Antimalware :

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

« Exclusions »: { « Extensions »: « .ext1;. ext2 », « Paths »: « c:\excluded-path-1;c:\excluded-path-2 », « Process »: « excludedproc1.exe;excludedproc2.exe » }

}

Remarques : AntimalwareEnabled est un paramètre obligatoire. Valeurs : true= Enable. false= Erreur indiquant que false n’est pas une valeur prise en charge

RealtimeProtectionEnabled : true/false. true = Activer. false = Désactiver. La valeur par défaut est true

ScheduledScanSettings :
isEnabled=true/false day=0-8 (0-daily, 1-Sunday, 2-Monday, ...., 7-Saturday, 8-Désactivé) time=0-1440 (mesuré en minutes après minuit - 60-1AM>, 120 -> 2AM, ... ) scanType="Quick » ou « Full » (Valeur par défaut est Rapide) Remarque : Si isEnabled=true est le seul paramètre fourni, les valeurs par défaut suivantes sont définies : day=7 (samedi), time=120 (2 AM), scanType="Quick » Exclusions : Plusieurs exclusions dans la même liste sont spécifiées à l’aide de délimiteurs de point-virgule.

Si aucune exclusion n’est spécifiée, les exclusions existantes, le cas échéant, sont remplacées par vides sur le système.

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

-Disable

Indique que l’applet de commande désactive l’extension Microsoft Antimalware. Pour réactiver l’extension sur la même machine virtuelle, exécutez Set-AzureVMMicrosoftAntimalwareExtension sans le paramètre Disable.

Type:	SwitchParameter
Position:	2
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 valides pour ce paramètre 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:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoConfig

Indique que cette applet de commande spécifie l’option NoConfig.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
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

-StorageContext

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

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

-Uninstall

Indique que cette applet de commande désinstalle l’extension Microsoft Antimalware de la machine virtuelle. Si la surveillance a été activée, l’applet de commande supprime également la collection d’événements Microsoft Antimalware.

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

-Version

Spécifie la version de l’extension sous forme de chaîne. Remarque : La version prise en charge est 1.5. Les versions antérieures ne sont pas prises en charge par Microsoft.

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

-VM

Spécifie la machine virtuelle en tant qu’objet IPersistentVM.

Type:	IPersistentVM
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False