Update-SafeList

  • 项目

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2008-07-18

使用 Update-SafeList cmdlet 可以在 Active Directory 目录服务中更新安全列表聚合数据。安全列表聚合数据在 Microsoft Exchange Server 2007 中用于反垃圾邮件筛选。EdgeSync 将安全列表聚合数据复制到安装了边缘传输服务器角色的计算机上。

Update-SafeList cmdlet 读取存储在 Microsoft Office Outlook 用户邮箱中的安全列表聚合数据，然后用散列算法处理数据并将数据写入到 Active Directory 中相应的用户对象。安全列表聚合数据包含 Outlook 用户的安全发件人列表和安全收件人列表。

使用 Type 参数可以指定是否更新 Outlook 用户的安全发件人列表和/或更新安全收件人列表。但是，安全列表聚合功能只使用安全发件人列表数据；安全列表聚合功能不处理安全收件人列表数据。因此，为了减少 Active Directory 中多余的存储和复制，建议不要在 Exchange 2007 中运行带有 SafeRecipients 或 Both 值的 Type 参数。Type 参数的默认值是 SafeSenders。

有关安全列表聚合如何工作的详细信息，请参阅安全列表聚合。

语法

Update-SafeList -Identity <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IncludeDomains <SwitchParameter>] [-Type <SafeSenders | SafeRecipients | Both>] [-WhatIf [<SwitchParameter>]]

详细说明

若要运行 Update-SafeList cmdlet，必须为您使用的帐户委派下列角色：

  • Exchange 仅查看管理员角色

  • Exchange 收件人管理员角色

有关管理 Exchange 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

参数

参数 必需 Type 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

使用此参数可以指定希望收集安全列表聚合数据的 Outlook 用户邮箱。此参数的有效输入包括以下值：

  • GUID

  • 可分辨名称 (DN)

  • 域\帐户

  • UPN

  • 旧版 Exchange DN

  • Smtp 地址

  • 别名

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理，并且需要您在继续处理之前确认该命令将执行的操作。您不必使用 Confirm 参数指定值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定将此配置更改写入 Active Directory 的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。已安装边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只会写入本地 Active Directory 应用程序模式 (ADAM) 实例。

IncludeDomains

可选

System.Management.Automation.SwitchParameter

如果希望将用户在 Outlook 中指定的发件人域包含在聚合安全列表中，可使用此参数。默认情况下，此列表中不包含由发件人指定的域。

大多数情况下，建议您不要包含域，因为用户可能包括大型 Internet 服务提供商 (ISP) 的域，这样可能会在无意中提供地址，这些地址可能会被垃圾邮件发送者利用或欺骗。

Type

可选

Microsoft.Exchange.Management.RecipientTasks.UpdateType

使用此参数指定将用户生成的哪个列表更新为用户对象。此参数的有效值为 SafeSenders、SafeRecipients 和 Both。默认值为 SafeSenders。

important要点：
在 Exchange 2007 中，安全列表聚合功能对安全收件人列表数据不起作用。建议不要运行值为 SafeRecipients 或 Both 的 Type 参数。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

  

 

异常

异常 说明

 

 

示例

第一个示例显示如何通过使用 Update-SafeList cmdlet 更新单个用户 KimA 的安全发件人列表数据。

第二个示例说明了如何为 Exchange 组织中的所有邮箱用户更新所有安全列表数据。默认情况下，Exchange 命令行管理程序配置为检索或修改驻留在 Exchange 服务器所在的域中的对象。因此，若要检索 Exchange 组织内的所有邮箱，必须将 $AdminSessionAdSettings.ViewEntireForest 的值设置为 $True。然后就可以运行 Get-Mailbox cmdlet 并将输出结果通过管道传输到 Update-Safelist cmdlet，以更新 Exchange 组织中所有邮箱用户的所有安全列表数据。

Caution警告：
修改 $AdminSessionAdSettings.ViewEntireForest 的值时，新值在关闭当前 Exchange 命令行管理程序会话之前保持不变。建议在执行避免意外修改或检索超过预期范围的对象的任务后，立即将 $AdminSessionAdSettings.ViewEntireForest 设置为 $False。 
Update-Safelist -Identity KimA

AdminSessionAdSettings.ViewEntireForest = $True
get-mailbox -ResultSize Unlimited | where {$_.RecipientType -eq [Microsoft.Exchange.Data.Directory.Recipient.RecipientType]::UserMailbox } | update-safelist