Test-Mailflow (RTM)

 

適用版本: Exchange Server 2007

上次修改主題的時間: 2007-06-11

使用 Test-Mailflow 指令程式,可診斷郵件是否可順利地往返傳送於已安裝 Mailbox server role 之電腦上的「系統信箱」信箱。您也可以使用這個指令程式,確認電子郵件已在定義的延遲閾值內,於 Mailbox Server 之間傳送。

語法

Test-Mailflow [-Identity <ServerIdParameter>] [-ActiveDirectoryTimeout <Int32>] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>]

Test-Mailflow [-Identity <ServerIdParameter>] -TargetEmailAddress <String> [-ActiveDirectoryTimeout <Int32>] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>] [-TargetEmailAddressDisplayName <String>]

Test-Mailflow [-Identity <ServerIdParameter>] -TargetMailboxServer <ServerIdParameter> [-ActiveDirectoryTimeout <Int32>] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>]

Test-Mailflow [-Identity <ServerIdParameter>] -AutoDiscoverTargetMailboxServer <SwitchParameter> [-ActiveDirectoryTimeout <Int32>] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>]

Test-Mailflow [-ActiveDirectoryTimeout <Int32>] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>]

詳細描述

Test-Mailflow 指令程式可測試郵件的提交、傳輸及傳遞。此指令程式會確認每台 Mailbox Server 都可順利地將郵件傳送至其本身。您也可以使用這個指令程式,來確認某一台 Mailbox Server 上的「系統信箱」信箱,可順利地將郵件傳送至另一台 Mailbox Server 上的「系統信箱」信箱。

這個工作可以在手動執行時,為系統管理員提供有用的資訊,也可以由 Microsoft Operations Manager (MOM)、Exchange Best Practices Analyzer 及 Exchange 疑難排解助理員等監視工具呼叫。若這個工作是由 MOM 呼叫,則會產生警示,以代表失敗或效能降低。

Test-Mailflow 指令程式可執行本機測試或遠端測試。如果您未指定任何參數,則會執行本機測試,且伺服器會傳送測試電子郵件給自己。如果您未指定任何參數,即會執行本機測試,而伺服器會將測試電子郵件傳送至其本身。如果指定 TargetEmailAddressTargetMailboxServerAutoDiscoverTargetMailboxServer 參數,則會執行遠端測試。TargetEmailAddressTargetMailboxServerAutoDiscoverTargetMailboxServer 參數是互斥的。

若要針對跨樹系案例測試電子郵件傳遞,可使用 TargetEmailAddress 參數。若要在相同 Active Directory 樹系中的不同 Mailbox Server 之間測試電子郵件傳遞,可使用 TargetMailboxServer 參數。若要自動填入測試郵件流程的目標伺服器清單,則使用 AutoDiscoverTargetMailboxServer 參數。

如果指定了一個以上的上述參數,AutoDiscoverTargetMailboxServer 參數的優先順序會高於 TargetEmailAddressTargetMailboxServer 參數。TargetMailboxServer 參數的優先順序會高於 TargetEmailAddress 參數。如果執行的是本機測試,本機伺服器必須針對每個信箱資料庫各擁有一個「系統信箱」信箱。如果執行的是遠端測試,則來源及目的伺服器兩者都必須有一個「系統信箱」信箱,或者必須使用參數來提供特定的信箱。

若要執行 Test-Mailflow 指令程式,必須對您使用的帳戶委派下列項目:

  • 執行指令程式所在伺服器之 Exchange Server 系統管理員角色和本機 Administrators 群組。

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

參數

參數 必要 類型 描述

AutoDiscoverTargetMailboxServer

必要

System.Management.Automation.SwitchParameter

AutoDiscoverTargetMailboxServer 參數可自動填入要接收測試郵件的目標 Mailbox Server 的清單。此工作會查詢 Active Directory 目錄服務以探索所有的 Mailbox Server,然後對每部伺服器傳送測試郵件。

TargetEmailAddress

必要

System.String

TargetEmailAddress 參數可指定要接收測試郵件之信箱的簡易郵件傳送通訊協定 (SMTP) 位址。使用此參數可將測試郵件傳送至遠端樹系中的 Mailbox Server。如果使用了此參數,則此測試一律為遠端測試。

TargetMailboxServer

必要

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

TargetMailboxServer 參數可指定要接收測試郵件之本機 Exchange 組織中的一或多台 Mailbox Server。

ActiveDirectoryTimeout

選用

System.Int32

ActiveDirectoryTimeout 參數可指定在此工作將有關延遲的資訊性郵件提供給系統管理員之前,所要經過的秒數。預設值為 15 秒。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

使用 DomainController 參數可指定此命令所要繫結,且會將此變更寫入至 Active Directory 之網域控制站的網域全名 (FQDN)。

ErrorLatency

選用

System.Int32

ErrorLatency 參數可指定在 MOM 中記錄錯誤事件之前,要傳遞測試郵件前所必須等待的時間。測試郵件傳送至同本機 Mailbox Server 的預設值是 15 秒,而傳送至遠端 Mailbox Server 的預設值則是 180 秒。

ExecutionTimeout

選用

System.Int32

ExecutionTimeout 參數可指定在判定測試失敗之前,此工作可執行的最長時間。如果在此時間到期之前沒有任何測試郵件或傳遞回報送達,此工作即會結束並回報錯誤。若工作是在 Exchange 管理命令介面中執行,預設設定為 240 秒。若使用了 MonitoringContext 參數,則預設設定為 15 秒。

Identity

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Identity 參數可指定傳送測試郵件的來源 Mailbox Server 名稱或來源信箱 SMTP 位址。預設值為本機 Mailbox Server。

MonitoringContext

選用

System.Boolean

只有將 MOM 用於監視伺服器時,才能使用 MonitoringContext 參數。如果將值設為 $true,指令程式就會將 MOM 所使用的事件及效能計數器填入 MonitoringContext 物件。此參數的預設值是 $false

TargetEmailAddressDisplayName

選用

System.String

TargetEmailAddressDisplayName 參數可指定要接收測試郵件之信箱的顯示名稱。

輸入類型

傳回類型

Test-Mailflow 指令程式會傳回下列內容,以協助您進行郵件流程問題的疑難排解:

  • MailFlowResult   這個內容會顯示「成功」或「失敗」。

  • MessageLatencyTime   這個內容會顯示將測試郵件傳送至負責接收之 Mailbox Server 所花費的時間 (以秒為單位)。

  • IsRemoteTest   這個內容會指出測試郵件是否已傳送至本機 Mailbox Server 以外的伺服器,或者測試郵件是否已傳送至某個電子郵件地址。

錯誤

錯誤 描述

 

例外狀況

例外狀況 描述

 

範例

第一個範例會顯示如何將測試郵件從伺服器 Mailbox1 傳送至伺服器 Mailbox2。

第二個範例會顯示如何將測試郵件從伺服器 Mailbox1 傳送至電子郵件地址 john@contoso.com。在此範例中,測試郵件會傳送至遠端樹系中的 Mailbox Server。

Test-Mailflow Mailbox1 -TargetMailboxServer Mailbox2
Test-Mailflow Mailbox1 -TargetEmailAddress john@contoso.com