通过

Update-SafeList (RTM)

  • 项目

 

适用于： Exchange Server 2007

上一次修改主题： 2008-06-17

使用 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> [-DomainController <Fqdn>] [-Type <SafeSenders | SafeRecipients | Both>]

详细说明

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

  • Exchange 仅查看管理员角色

  • Exchange 收件人管理员角色

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

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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

  • GUID

  • 可分辨名称 (DN)

  • 域\帐户

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • 别名

DomainController

可选

Microsoft.Exchange.Data.Fqdn

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

类型

可选

Microsoft.Exchange.Management.RecipientTasks.UpdateType

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

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

输入类型

返回类型

错误

错误 说明

 

 

异常

异常 说明

 

 

示例

第一个示例显示如何通过使用 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