Set-MalwareFilterPolicy

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。一些参数和设置可能只适用于某个特定的环境。

使用 Set-MalwareFilterPolicy cmdlet 修改贵组织中的恶意软件筛选器策略。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Set-MalwareFilterPolicy
   [-Identity] <MalwareFilterPolicyIdParameter>
   [-Action <MalwareFilteringAction>]
   [-AdminDisplayName <String>]
   [-BypassInboundMessages <Boolean>]
   [-BypassOutboundMessages <Boolean>]
   [-Confirm]
   [-CustomAlertText <String>]
   [-CustomExternalBody <String>]
   [-CustomExternalSubject <String>]
   [-CustomFromAddress <SmtpAddress>]
   [-CustomFromName <String>]
   [-CustomInternalBody <String>]
   [-CustomInternalSubject <String>]
   [-CustomNotifications <Boolean>]
   [-DomainController <Fqdn>]
   [-EnableExternalSenderAdminNotifications <Boolean>]
   [-EnableExternalSenderNotifications <Boolean>]
   [-EnableFileFilter <Boolean>]
   [-EnableInternalSenderAdminNotifications <Boolean>]
   [-EnableInternalSenderNotifications <Boolean>]
   [-ExternalSenderAdminAddress <SmtpAddress>]
   [-FileTypeAction <FileTypeFilteringAction>]
   [-FileTypes <String[]>]
   [-InternalSenderAdminAddress <SmtpAddress>]
   [-MakeDefault]
   [-QuarantineTag <String>]
   [-WhatIf]
   [-ZapEnabled <Boolean>]
   [<CommonParameters>]

说明

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Set-MalwareFilterPolicy -Identity "Contoso Malware Filter Policy" -Action DeleteMessage -EnableInternalSenderAdminNotifications $true -InternalSenderAdminAddress admin@contoso.com

在本地 Exchange 中，此示例使用以下设置修改名为 Contoso 恶意软件筛选策略的恶意软件筛选器策略：

删除包含恶意软件的邮件。
在邮件中检测到恶意软件时不通知邮件发件人。
在内部发件人发送的邮件中检测到恶意软件时通知管理员 admin@contoso.com。

示例 2

$FileTypesAdd = Get-MalwareFilterPolicy -Identity Default | select -Expand FileTypes

$FileTypesAdd += "dgz","mde"

Set-MalwareFilterPolicy -Identity Default -EnableFileFilter $true -FileTypes $FileTypesAdd

本示例在名为 Default 的恶意软件筛选器策略中启用常见附件筛选器，并添加文件类型“dgz”和“mde”，而不会影响其他文件类型条目。

示例 3

$ft = Get-MalwareFilterPolicy -Identity Default

$a = [System.Collections.ArrayList]($ft.FileTypes)

$a

$a.RemoveAt(6)

Set-MalwareFilterPolicy -Identity Default -FileTypes $a

此示例修改名为 Default 的恶意软件筛选器策略，方法是从常见附件筛选器中删除现有文件类型，而不会影响已指定的其他文件类型。

前三个命令返回现有的文件类型列表。该列表中的第一个文件类型的索引号为 0，第二个文件类型的索引号为 1，以此类推。使用索引号指定要删除的文件类型。

最后两个命令将删除列表中显示的第七个文件类型。

参数

-Action

此参数只在本地 Exchange 中可用。

Action 参数指定在邮件中检测到恶意软件时要采取的操作。有效值包含:

DeleteMessage：在不通知收件人的情况下处理邮件。此值为默认值。
DeleteAttachmentAndUseDefaultAlert：传递邮件，但将所有附件替换为包含默认警报文本的名为 Malware Alert Text.txt 的文件。
DeleteAttachmentAndUseCustomAlert：传递邮件，但将所有附件替换为名为 Malware Alert Text.txt 的文件，该文件包含 CustomAlertText 参数指定的自定义警报文本。

Type:	MalwareFilteringAction
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-AdminDisplayName

AdminDisplayName 参数指定策略的说明。如果值中有空格，请使用双引号 (") 将此值括起来。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-BypassInboundMessages

此参数只在本地 Exchange 中可用。

BypassInboundMessages 参数启用或禁用对传入邮件 (进入组织) 邮件的恶意软件筛选。有效值包含:

$true：对入站邮件禁用恶意软件筛选。
$false：对入站邮件启用恶意软件筛选。此值为默认值。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BypassOutboundMessages

此参数只在本地 Exchange 中可用。

BypassOutboundMessages 参数启用或禁用对传出邮件 (离开组织) 的邮件的恶意软件筛选。有效值包含:

$true：对出站邮件禁用恶意软件筛选。
$false：对出站邮件启用恶意软件筛选。此值为默认值。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAlertText

此参数只在本地 Exchange 中可用。

CustomAlertText 参数指定要在名为 Malware Alert Text.txt 的替换附件中使用的自定义文本。如果值中有空格，请使用双引号 (") 将此值括起来。

仅当 Action 参数的值为 DeleteAttachmentAndUseCustomAlert 时，此参数才有意义。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019