Set-MailboxJunkEmailConfiguration
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Set-MailboxJunkEmailConfiguration cmdlet 在邮箱上配置垃圾邮件设置。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Set-MailboxJunkEmailConfiguration
[-Identity] <MailboxIdParameter>
[-BlockedSendersAndDomains <MultiValuedProperty>]
[-Confirm]
[-ContactsTrusted <Boolean>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-IgnoreDefaultScope]
[-TrustedListsOnly <Boolean>]
[-TrustedRecipientsAndDomains <MultiValuedProperty>]
[-TrustedSendersAndDomains <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] 说明
此 cmdlet 控制邮箱上的以下垃圾邮件设置：
启用或禁用垃圾邮件规则：在本地 Exchange 中，垃圾邮件规则 (名为“垃圾邮件规则”的隐藏收件箱规则，) 根据组织或邮箱) 的安全列表集合的 SCL 垃圾邮件Email文件夹阈值 (控制邮件传递到垃圾邮件Email文件夹或收件箱。
在基于云的服务中，垃圾邮件规则对邮件流没有影响。 Exchange Online Protection根据反垃圾邮件策略中设置的操作将邮件传递到“垃圾邮件Email”文件夹。 邮箱上的垃圾邮件规则仍根据邮箱的安全列表集合控制邮件传递后发生的情况。
用户可以使用Outlook 网页版在其自己的邮箱中启用或禁用垃圾邮件规则。
配置安全列表集合：安全列表集合是“安全发件人”列表、“安全收件人”列表和“阻止的发件人”列表。 用户可以使用 Microsoft Outlook 或 Outlook 网页版在自己的邮箱上配置安全列表集合。
有关详细信息，请参阅 在邮箱上配置 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
BlockedSendersAndDomains 参数指定“阻止发件人”列表，该列表包含发件人电子邮件地址和域，其邮件会自动发送到“垃圾邮件Email”文件夹。 此参数对应于Outlook 网页版设置：将电子邮件从这些发件人或域移动到我的垃圾邮件Email文件夹。
若要输入多个值并覆盖任何现有条目，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ContactsTrusted
ContactsTrusted 参数指定是否将“联系人”文件夹中的联系人视为受信任的发件人。 此参数对应于Outlook 网页版设置：信任来自我的联系人的电子邮件。 有效值包含:
- $true：来自“联系人”文件夹中到达邮箱的联系人的邮件永远不会传递到“垃圾邮件Email”文件夹，无论内容如何。
- $false：来自“联系人”文件夹中的联系人的邮件不会被视为受信任的发件人。 只有在“安全发件人”列表中定义了电子邮件地址时，该电子邮件地址才为受信任的发件人。 此值为默认值。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
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筛选器概述。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Identity 参数指定要修改的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IgnoreDefaultScope
IgnoreDefaultScope 开关指示命令忽略 Exchange PowerShell 会话的默认收件人范围设置，并将整个林用作范围。 不必为此开关指定值。
此开关使命令能够访问当前在默认范围中不可用的 Active Directory 对象，但也引入了以下限制：
- 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
- 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TrustedListsOnly
TrustedListsOnly 参数指定只有来自安全发件人列表中的发件人的邮件才会传递到收件箱。 所有其他邮件都被视为垃圾邮件。 此参数对应于Outlook 网页版设置：除非电子邮件来自我的安全发件人和收件人列表中的某人，否则不要信任电子邮件。 有效值包含:
- $true：只有来自“安全发件人”列表和“安全收件人”列表中电子邮件地址或域条目的邮件才会传递到收件箱。 所有其他邮件都会自动传递到“垃圾邮件Email”文件夹。
- $false：来自其他发件人、收件人和域的邮件不会自动被视为垃圾邮件，并单独进行评估。 此值为默认值。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TrustedRecipientsAndDomains
保留此参数以供 Microsoft 内部使用。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TrustedSendersAndDomains
TrustedSendersAndDomains 参数指定安全发件人列表和安全收件人列表，它们是电子邮件地址和域的列表。 从这些发件人到达邮箱的邮件永远不会传递到垃圾邮件Email文件夹，无论内容如何。 此参数对应于Outlook 网页版设置：不要将电子邮件从这些发件人或域移动到“垃圾邮件Email”文件夹。
若要输入多个值并覆盖任何现有条目，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
若要清空电子邮件地址和域列表，请使用值 $null。
注意：
- 不能从收件人的电子邮件地址所在的同一域添加发件人电子邮件地址。 全局地址列表中所有邮箱 (GAL) 自动被视为受信任的发件人。
- 不能使用此 cmdlet 直接修改“安全收件人”列表。 使用此参数修改“安全发件人”列表，电子邮件地址和域将同步到“安全收件人”列表。
- 在具有目录同步的独立 EOP 中，默认情况下不会同步域条目，但你可以为域启用同步。 有关详细信息，请参阅配置内容筛选以使用安全域数据。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。