New-MalwareFilterPolicy

参考

模块:: ExchangePowerShell

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

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

使用 New-MalwareFilterPolicy cmdlet 创建组织中的恶意软件筛选器策略。

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

语法

New-MalwareFilterPolicy
   [-Name] <String>
   [-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>]
   [-QuarantineTag <String>]
   [-RecommendedPolicyType <RecommendedPolicyType>]
   [-WhatIf]
   [-ZapEnabled <Boolean>]
   [<CommonParameters>]

说明

使用此 cmdlet 创建的新策略不会应用于用户，也不会在管理中心内显示。需要使用 New-MalwareFilterRule 或 Set-MalwareFilterRule cmdlet 上的 MalwareFilterPolicy 参数将策略与规则相关联。

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

示例

示例 1

New-MalwareFilterPolicy -Name "Contoso Malware Filter Policy" -EnableInternalSenderAdminNotifications $true -InternalSenderAdminAddress admin@contoso.com

本示例将使用以下设置创建名为 Contoso Malware Filter Policy 的全新恶意软件筛选器策略：

在本地 Exchange 中阻止包含恶意软件的邮件，或在 Exchange Online 中隔离邮件。
在内部发件人发送的邮件中检测到恶意软件时通知管理员 admin@contoso.com。

参数

-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