Update-SafeList

  • 發行項

 

適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間： 2008-07-18

使用 Update-SafeList 指令程式，可以更新 Active Directory 目錄服務中的安全清單彙總資料。安全清單彙總資料是用於 Microsoft Exchange Server 2007 中的反垃圾郵件篩選。EdgeSync 會將安全清單彙總資料複寫至已安裝 Edge Transport server role 的電腦。

Update-SafeList 指令程式會讀取 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 指令程式，必須對您使用的帳戶委派下列項目：

  • Exchange 僅檢視管理角色

  • Exchange 收件者系統管理員角色

如需管理 Exchange 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

使用此參數來指定 Outlook 使用者信箱，而您想要從中收集安全清單彙總資料。此參數的有效輸入包括下列的值：

  • GUID

  • 辨別名稱 (DN)

  • 網域\帳戶

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • 別名

Confirm

選用

System.Management.Automation.SwitchParameter

Confirm 參數會使得命令暫停處理，並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定將此組態變更寫入至 Active Directory 之網域控制站的網域全名 (FQDN)，請在命令中加入 DomainController 參數。已安裝 Edge Transport server role 的電腦不支援 DomainController 參數。Edge Transport server role 只會寫入至本機 Active Directory 應用程式模式 (ADAM) 執行個體。

IncludeDomains

選用

System.Management.Automation.SwitchParameter

如果想要將 Outlook 中的使用者所指定的寄件者網域加入到彙總的安全清單，請使用此參數。預設不會加入寄件者所指定的網域。

在大部分情況下，不建議您將網域加入，因為使用者可能會將大型網際網路服務提供者 (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 指令程式，更新單一使用者 KimA 的安全寄件者清單資料。

第二個範例顯示如何更新 Exchange 組織中所有信箱使用者的所有安全清單資料。依預設，Exchange 管理命令介面設定為針對 Exchange 伺服器所在網域，擷取或修改位於該網域的物件。因此，若要擷取 Exchange 組織內的所有信箱，必須將 $AdminSessionAdSettings.ViewEntireForest 的值設為 $True。接著，可以執行 Get-Mailbox 指令程式，並將其輸出透過管線傳到 Update-Safelist 指令程式，以更新 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