你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Set-AzureVMMicrosoftAntimalwareExtension

模块:

Azure

为虚拟机配置Microsoft反恶意软件扩展。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。 有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

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

说明

Set-AzureVMMicrosoftAntimalwareExtension cmdlet 为虚拟机配置Microsoft反恶意软件扩展。 可以启用、禁用或卸载扩展。

示例

示例 1：使用配置文件启用扩展

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

此命令使用配置文件启用Microsoft反恶意软件扩展。 该命令使用 Get-AzureVM cmdlet 获取指定的虚拟机对象，然后使用管道运算符将该对象传递给当前 cmdlet。

示例 2：启用扩展并启用监视

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

第一个命令使用 New-AzureStorageContext cmdlet 创建 AzureStorageContext 对象，然后将其存储在$StorageContext变量中。

示例 3：通过指定配置对象启用扩展

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

第一个命令通过读取 Microsoft 反恶意软件扩展的 JSON 配置并将其存储在 $config_string 变量中来创建字符串对象。

示例 4：禁用扩展

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

此命令禁用扩展，而不将其删除。 该命令使用 Get-AzureVM 获取指定的虚拟机对象，然后将该对象传递给当前 cmdlet。

示例 5：删除扩展

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

此命令从虚拟机中删除Microsoft反恶意软件扩展。 该命令使用 Get-AzureVM 获取指定的虚拟机对象，然后将该对象传递给当前 cmdlet。

参数

-AntimalwareConfigFile

指定Microsoft反恶意软件配置文件的绝对路径。 如果指定反恶意软件配置参数，请不要指定此参数。 配置文件必须至少包括以下内容才能启用Microsoft反恶意软件扩展：

{ "AntimalwareEnabled": true }

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-AntimalwareConfiguration

指定包含Microsoft反恶意软件配置的字符串对象。 此对象不得$Null或为空。 如果指定 AntimalwareConfigFile 参数，请不要指定此参数。 配置对象必须至少包括以下内容才能启用Microsoft反恶意软件扩展：****{ “AntimalwareEnabled”： true }

Microsoft Antimalware JSON 配置示例：

{ “AntimalwareEnabled”： true， “RealtimeProtectionEnabled”： true， “ScheduledScanSettings”： { “isEnabled”： true， “day”： 1， “time”： 120， “scanType”： “Full” }，

“Exclusions”： { “Extensions”： “.ext1;.ext2“、”Path“： ”c：\excluded-path-1;c：\excluded-path-2“， ”Process“： ”excludedproc1.exe;excludedproc2.exe“ }

}

注意：反恶意软件Enabled 是必需参数。 值：true= 启用。 false= 错误出为 false 不是受支持的值

RealtimeProtectionEnabled：true/false。 true = 启用。 false = 禁用。 默认值为 true

ScheduledScanSettings：
isEnabled=true/false day=0-8 （0-daily， 1-Sunday， 2-Monday， ....， 7-Saturday， 8-Disabled） time=0-1440 （以午夜后的分钟为单位 - 60-1AM>， 120 -> 2AM， ... ） scanType=“Quick” 或 “Full” （默认值为快速）注意：如果 isEnabled=true 是唯一提供的设置，则设置以下默认值：day=7（星期六），time=120 （2 AM），scanType=“Quick” 排除项： 同一列表中的多个排除项是使用分号分隔符指定的。

如果未指定排除项，则系统上的现有排除项（如果有）将被空白覆盖。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Disable

指示 cmdlet 禁用Microsoft反恶意软件扩展。 若要在同一虚拟机上重新启用扩展，请在不使用 Disable 参数的情况下运行 Set-AzureVMMicrosoftAntimalwareExtension。

类型:	SwitchParameter
Position:	2
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为：

• 继续
• 忽略
• 询问
• SilentlyContinue
• 停止
• Suspend

类型:	ActionPreference
别名:	infa
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InformationVariable

指定信息变量。

类型:	String
别名:	iv
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Monitoring

指定是否收集Microsoft反恶意软件事件。

此参数的可接受值为：

• 上。 将Microsoft反恶意软件事件收集到存储上下文。
• 关闭。 不要收集Microsoft反恶意软件事件。

类型:	String
Position:	3
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-NoConfig

指示此 cmdlet 指定 NoConfig 选项。

类型:	SwitchParameter
Position:	3
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

类型:	AzureSMProfile
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StorageContext

指定用于Microsoft反恶意软件监视的 Azure 存储上下文。

类型:	AzureStorageContext
Position:	4
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Uninstall

指示此 cmdlet 从虚拟机卸载 Microsoft 反恶意软件扩展。 如果启用了监视，该 cmdlet 还会删除Microsoft反恶意软件事件的集合。

类型:	SwitchParameter
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Version

将扩展版本指定为字符串。 注意：支持的版本为 1.5。 Microsoft不支持旧版本。

类型:	String
Position:	2
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-VM

将虚拟机指定为 IPersistentVM 对象。

类型:	IPersistentVM
别名:	InputObject
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

相关链接

• Get-AzureVMMicrosoftAntimalwareExtension
• Remove-AzureVMMicrosoftAntimalwareExtension
• Get-AzureVM