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 使用者信箱,而您想要從中收集安全清單彙總資料。此參數的有效輸入包括下列的值:
|
||
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 |
使用此參數可指定會更新為使用者物件的使用者產生的清單。此參數的有效值為
|
||
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數,則不需要套用任何變更,就能檢視變更。您不需要為 WhatIf 參數指定任何值。 |
輸入類型
傳回類型
錯誤
錯誤 | 描述 |
---|---|
|
|
例外狀況
例外狀況 | 描述 |
---|---|
|
|
範例
第一個範例顯示如何使用 Update-SafeList 指令程式,更新單一使用者 KimA 的安全寄件者清單資料。
第二個範例顯示如何更新 Exchange 組織中所有信箱使用者的所有安全清單資料。依預設,Exchange 管理命令介面設定為針對 Exchange 伺服器所在網域,擷取或修改位於該網域的物件。因此,若要擷取 Exchange 組織內的所有信箱,必須將 $AdminSessionAdSettings.ViewEntireForest 的值設為 $True
。接著,可以執行 Get-Mailbox 指令程式,並將其輸出透過管線傳到 Update-Safelist 指令程式,以更新 Exchange 組織中所有信箱使用者的所有安全清單資料。
請注意: |
---|
當您修改 $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