Set-MalwareFilteringServer
此 cmdlet 仅适用于本地 Exchange。
使用 Set-MalwareFilteringServer cmdlet 可配置邮箱服务器上传输服务中的恶意软件代理设置。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default （默认值）
Set-MalwareFilteringServer
[-Identity] <MalwareFilteringServerIdParameter>
[-BypassFiltering <Boolean>]
[-Confirm]
[-DeferAttempts <Int32>]
[-DeferWaitTime <Int32>]
[-DomainController <Fqdn>]
[-ForceRescan <Boolean>]
[-MinimumSuccessfulEngineScans <Int32>]
[-PrimaryUpdatePath <String>]
[-ScanErrorAction <MalwareScanErrorAction>]
[-ScanTimeout <Int32>]
[-SecondaryUpdatePath <String>]
[-UpdateFrequency <Int32>]
[-UpdateTimeout <Int32>]
[-WhatIf]
[<CommonParameters>]
说明
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-MalwareFilteringServer Mailbox01 -UpdateFrequency 120 -DeferWaitTime 10
本示例将在名为 Mailbox01 的邮箱服务器上设置以下恶意软件代理设置：
- 将更新频率间隔设置为 2 小时
- 将重新提交尝试之间的等待时间设置为 10 分钟
参数
-BypassFiltering
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
BypassFiltering 参数用于临时绕过恶意软件筛选而不禁用服务器上的恶意软件代理。 恶意软件代理仍处活动状态，并仍将为每封邮件调用该代理，但不实际执行任何恶意软件筛选。 这将使用您可以在服务器上临时禁用再启用恶意软件筛选，而不会因为重新启动 Microsoft Exchange 传输服务而中断邮件流。 此参数的有效输入为 $true 或 $false。 默认值为 $false。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DeferAttempts
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DeferAttempts 参数指定邮件无法被恶意软件代理扫描的延迟次数。 该参数的有效输入是在 1 和 5 之间的整数。 默认值是 3。
在达到最大延迟次数后，恶意软件代理执行何种操作取决于相关的错误。 对于扫描超时和引擎错误，操作是在最后一次延迟尝试后立即放弃邮件并向发件人返回未送达报告 (NDR)。 对于所有其他错误，会在 48 小时内重新尝试发送邮件，每次重新尝试距离上次重新尝试的时间间隔为上一个时间间隔加一小时。 例如，从上次延迟尝试之后开始，第一次重试尝试在 1 小时内进行，下一次重试尝试在 2 小时后进行，下一次重试尝试在第二次重试尝试后 3 小时进行，依此最长为 48 小时。 达到 48 小时后，操作是放弃邮件并向发件人返回未送达报告 (NDR)。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DeferWaitTime
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DeferWaitTime 指定重新提交邮件进行恶意邮件筛选以减少服务器上的工作负荷的时间间隔的递增时间段（分钟）。
例如，在最初扫描失败后的第一次重试发生在 DeferWaitTime 参数指定的时间间隔之后。 第一次重试之后的第二次重试发生的间隔是 DeferWaitTime 参数值的两倍。 第二次重试后的第三次重试发生在 DeferWaitTime 参数值的三倍之后，依此进行。 最大重试次数由 DeferAttempts 参数控制。
此参数的有效输入是在 0 和 15 之间的整数。 默认值是 5。 这意味着第一次重新提交发生在原始失败扫描后的 5 分钟后，第二次重试在第一次重试 10 分钟后发生，第三次重试在第二次重试 15 分钟后发生，依此类而行。 值 0 表示在任何一次扫描尝试失败后重新提交邮件进行恶意软件筛选，无任何延迟。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DomainController
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ForceRescan
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ForceRescan 参数指定邮件应由恶意软件代理扫描，即使邮件已通过基于云的保护进行扫描也是如此。 有效值包含:
- $true：来自基于云的组织的消息由恶意软件代理扫描。
- $false：恶意软件代理不会扫描来自基于云的组织的消息。 此值为默认值。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Identity
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Identity 参数指定要在其中配置反恶意软件设置的服务器。 可以使用唯一标识该服务器的任何值。 例如：
- 名称
- FQDN
- 可分辨名称 (DN)
- Exchange 旧版 DN
参数属性
| 类型: | MalwareFilteringServerIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-MinimumSuccessfulEngineScans
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PrimaryUpdatePath
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
PrimaryUpdatePath 参数指定下载恶意软件扫描引擎更新的地方。 默认值为 http://forefrontdl.microsoft.com/server/scanengineupdate。 始终首先尝试 PrimaryUpdatePath 参数指定的位置。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ScanErrorAction
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ScanErrorAction 参数指定恶意软件筛选器无法扫描邮件时要采取的操作。 此参数的有效值为 Block 或 Allow。 默认值为 Block。
参数属性
| 类型: | MalwareScanErrorAction |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ScanTimeout
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ScanTimeout 参数指定恶意软件筛选器无法扫描邮件的超时间隔（秒）。 此参数的有效输入是 10 和 900 之间的一个整数。 默认值是 300（5 分钟）。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SecondaryUpdatePath
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
SecondaryUpdatePath 参数指定恶意软件扫描引擎更新的备用下载位置。 默认值为空（$null）。 这意味着未指定备用下载位置。
当 PrimaryUpdatePath 参数指定的位置在 UpdateTimeout 参数指定的时间周期内不可用时使用备用下载位置。 在下一次恶意软件扫描引擎更新中，首先尝试 PrimaryUpdate 路径参数中指定的位置。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-UpdateFrequency
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
UpdateFrequency 参数指定检查恶意软件扫描引擎更新的频率间隔（分钟）。 该参数的有效输入为 1 和 38880（27 天）之间的整数。 默认值为 60（1 小时）。 检查更新的位置由 PrimaryUpdatePath 和 SecondaryUpdatePath 参数指定。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-UpdateTimeout
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
UpdateTimeout 参数指定检查恶意软件扫描引擎更新时的超时间隔（分钟）。 此参数的有效输入是 60 和 300 之间的一个整数。 默认值为 150 秒（2.5 分钟）。
如果 PrimaryUpdatePath 参数指定的位置在 UpdateTimeout 参数值指定的时间周期内不可用，使用 SecondaryUpdatePath 参数指定的位置。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。