通过

Set-MailboxJunkEmailConfiguration

模块:
Exchange PowerShell

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

使用 Set-MailboxJunkEmailConfiguration cmdlet 在邮箱上配置垃圾邮件设置。

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

语法

Default （默认值） 

Set-MailboxJunkEmailConfiguration
    [-Identity] <MailboxIdParameter>
    [-BlockedSendersAndDomains <MultiValuedProperty>]
    [-Confirm]
    [-ContactsTrusted <Boolean>]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-FailOnError <Boolean>]
    [-IgnoreDefaultScope]
    [-SenderScreeningEnabled <Boolean>]
    [-TrustedListsOnly <Boolean>]
    [-TrustedRecipientsAndDomains <MultiValuedProperty>]
    [-TrustedSendersAndDomains <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

说明

此 cmdlet 控制邮箱上的以下垃圾邮件设置：

  • 启用或禁用垃圾邮件规则：在本地 Exchange 中，垃圾邮件规则 (名为“垃圾邮件规则”的隐藏收件箱规则，) 根据组织或邮箱) 的安全列表集合的 SCL 垃圾邮件Email文件夹阈值 (控制邮件传递到垃圾邮件Email文件夹或收件箱。

    在基于云的服务中，垃圾邮件规则对邮件流没有影响。 邮件会根据反垃圾邮件策略中设置的作传递到“垃圾邮件Email”文件夹。 邮箱上的垃圾邮件规则仍根据邮箱的安全列表集合控制邮件传递后发生的情况。

    用户可以使用Outlook 网页版在其自己的邮箱中启用或禁用垃圾邮件规则。

  • 配置安全列表集合：安全列表集合是“安全发件人”列表、“安全收件人”列表和“阻止的发件人”列表。 用户可以使用 Outlook 或 Outlook 网页版 在自己的邮箱上配置安全列表集合Microsoft。

有关详细信息，请参阅 在邮箱上配置 Exchange 反垃圾邮件设置。

您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Set-MailboxJunkEmailConfiguration "David Pelton" -Enabled $false

此示例禁用名为 David Pelton 的用户的垃圾邮件规则。 在本地 Exchange 中，邮件不再根据 SCL 垃圾邮件Email文件夹阈值 (组织或邮箱) 或邮箱的安全列表集合在“收件箱”和“垃圾邮件Email”文件夹之间移动。 在 Exchange Online，邮箱的安全列表集合无法在“收件箱”和“垃圾邮件Email”文件夹之间移动邮件。 邮件仍会根据反垃圾邮件策略的判决和相应作传递到“垃圾邮件Email”文件夹。

示例 2

Set-MailboxJunkEmailConfiguration "Michele Martin" -TrustedSendersAndDomains @{Add="contoso.com","fabrikam.com"} -BlockedSendersAndDomains @{Add="jane@fourthcoffee.com"}

此示例对名为 Michele Martin 的用户的安全列表集合进行以下配置更改：

  • 将 contoso.com 和 fabrikam.com 添加到“安全发件人”列表，而不会影响其他现有条目。
  • 添加到 jane@fourthcoffee.com “阻止的发件人”列表，而不会影响其他现有条目。

示例 3

Get-MailboxJunkEmailConfiguration * | Where {$_.ContactsTrusted -eq $true} | Set-MailboxJunkEmailConfiguration -ContactsTrusted $false

此示例标识将联系人视为受信任发件人的邮箱，然后将垃圾邮件配置更改为不将联系人视为受信任的发件人。

参数

-BlockedSendersAndDomains

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

BlockedSendersAndDomains 参数指定“阻止发件人”列表，该列表包含发件人电子邮件地址和域，其邮件会自动发送到“垃圾邮件Email”文件夹。 此参数对应于Outlook 网页版设置：将电子邮件从这些发件人或域移动到我的垃圾邮件Email文件夹。

若要输入多个值并覆盖任何现有条目，请使用以下语法： Value1,Value2,...ValueN。 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

要添加或移除一个或多个值而不影响任何现有条目，可使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Confirm

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

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

-ContactsTrusted

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

ContactsTrusted 参数指定是否将“联系人”文件夹中的联系人视为受信任的发件人。 此参数对应于Outlook 网页版设置：信任来自我的联系人的电子邮件。 有效值包含:

  • $true：来自“联系人”文件夹中到达邮箱的联系人的邮件永远不会传递到“垃圾邮件Email”文件夹，无论内容如何。
  • $false：来自“联系人”文件夹中的联系人的邮件不会被视为受信任的发件人。 只有在“安全发件人”列表中定义了电子邮件地址时，该电子邮件地址才为受信任的发件人。 此值为默认值。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DomainController

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Enabled

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

Enabled 参数启用或禁用邮箱上的垃圾邮件规则， (名为“垃圾邮件规则”的隐藏收件箱规则) 。 有效值包含:

  • $true：邮箱中启用了垃圾邮件规则。 该值对应于 Web 上的 Outlook 设置： 自动筛选垃圾邮件。 此值为默认值。

    在本地 Exchange 中，邮箱的安全列表集合 (安全发件人列表、安全收件人列表和阻止发件人列表) ，组织或邮箱) 将邮件传递到“收件箱”或“垃圾邮件Email”文件夹的 SCL 垃圾邮件Email文件夹阈值 (。

    在基于云的服务中，邮箱的安全列表集合在“收件箱”或“垃圾邮件Email”文件夹之间移动传递的邮件。 邮件仅根据反垃圾邮件策略的判决和相应作传递到“垃圾邮件Email”文件夹。

  • $false：邮箱中禁用垃圾邮件规则。 该值对应于 Web 上的 Outlook 设置： 不将邮件移到我的"垃圾邮件"文件夹。

    在本地 Exchange 中，邮箱的安全列表集合或 SCL 垃圾邮件Email文件夹阈值无法将邮件传递到收件箱或垃圾邮件Email文件夹。

    在基于云的服务中，邮箱的安全列表集合无法在“收件箱”或“垃圾邮件Email”文件夹之间移动传递的邮件。 邮件仍会根据反垃圾邮件策略的判决和相应作传递到“垃圾邮件Email”文件夹。

可以通过运行以下命令之一来查找 Enabled 属性值来查看垃圾邮件规则的状态：

  • Get-MailboxJunkEmailConfiguration -Identity <MailboxIdentity>
  • 仅限本地 Exchange： Get-InboxRule "Junk E-mail Rule" -Mailbox <MailboxIdentity> -IncludeHidden

邮箱上的垃圾邮件规则状态不会影响 Outlook 垃圾邮件Email筛选器中提供的客户端垃圾邮件设置。 即使邮箱中禁用了垃圾邮件规则，Outlook 仍可以将邮件移动到“垃圾邮件Email”文件夹中。 例如，如果 Outlook 确定邮件是垃圾邮件，或者发件人在“阻止的发件人”列表中定义，则 Outlook 可以将邮件移动到“垃圾邮件Email”文件夹中。 有关详细信息，请参阅垃圾邮件Email筛选器概述。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-FailOnError

适用：Exchange Online

此参数仅在基于云的服务中可用。

{{ Fill FailOnError Description }}

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Identity

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

Identity 参数指定要修改的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如：

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)

参数属性

类型:MailboxIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-IgnoreDefaultScope

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

IgnoreDefaultScope 开关指示命令忽略 Exchange PowerShell 会话的默认收件人范围设置，并将整个林用作范围。 不必为此开关指定值。

此开关使命令能够访问当前在默认范围中不可用的 Active Directory 对象，但也引入了以下限制：

  • 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
  • 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SenderScreeningEnabled

适用：Exchange Online

此参数仅在基于云的服务中可用。

{{ Fill SenderScreeningEnabled Description }}

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-TrustedListsOnly

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

TrustedListsOnly 参数指定只有来自安全发件人列表中的发件人的邮件才会传递到收件箱。 所有其他邮件都被视为垃圾邮件。 此参数对应于Outlook 网页版设置：除非电子邮件来自我的安全发件人和收件人列表中的某人，否则不要信任电子邮件。 有效值包含:

  • $true：只有来自“安全发件人”列表和“安全收件人”列表中电子邮件地址或域条目的邮件才会传递到收件箱。 所有其他邮件都会自动传递到“垃圾邮件Email”文件夹。
  • $false：来自其他发件人、收件人和域的邮件不会自动被视为垃圾邮件，并单独进行评估。 此值为默认值。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-TrustedRecipientsAndDomains

适用：Exchange Server 2016、Exchange Server 2019、Exchange Online

保留此参数以供 Microsoft 内部使用。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-TrustedSendersAndDomains

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

TrustedSendersAndDomains 参数指定安全发件人列表和安全收件人列表，它们是电子邮件地址和域的列表。 从这些发件人到达邮箱的邮件永远不会传递到垃圾邮件Email文件夹，无论内容如何。 此参数对应于Outlook 网页版设置：不要将电子邮件从这些发件人或域移动到“垃圾邮件Email”文件夹。

若要输入多个值并覆盖任何现有条目，请使用以下语法： Value1,Value2,...ValueN。 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

要添加或移除一个或多个值而不影响任何现有条目，可使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

若要清空电子邮件地址和域列表，请使用值 $null。

注意：

  • 不能从收件人的电子邮件地址所在的同一域添加发件人电子邮件地址。 全局地址列表中所有邮箱 (GAL) 自动被视为受信任的发件人。
  • 不能使用此 cmdlet 直接修改“安全收件人”列表。 使用此参数修改“安全发件人”列表，电子邮件地址和域将同步到“安全收件人”列表。
  • 在具有目录同步的独立 EOP 中，默认情况下不会同步域条目，但你可以为域启用同步。 有关详细信息，请参阅配置内容筛选以使用安全域数据。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

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 不返回任何数据。