Test-MapiConnectivity

  • 發行項

 

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

上次修改主題的時間： 2007-07-05

使用 Test-MapiConnectivity 指令程式，可以登入所指定的信箱來驗證伺服器功能。如果未指定信箱，則指令程式會登入所指定資料庫上的 SystemMailbox。

語法

Test-MAPIConnectivity [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Database <DatabaseIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Identity <MailboxIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

詳細描述

若要執行 Test-MapiConnectivity 指令程式，您使用的帳戶必須已委派下列資格：

  • Exchange Server 系統管理員角色和目標伺服器的本機 Administrators 群組

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

使用 Test-MapiConnectivity 指令程式以驗證伺服器功能。此指令程式會登入所指定的信箱 (未指定 Identity 參數時則會登入 SystemMailbox)，然後擷取收件匣中的項目清單。登入信箱會測試用戶端在連接至信箱伺服器時所使用的兩個重要通訊協定：MAPI 與 LDAP。在驗證期間，Test-MapiConnectivity 指令程式間接驗證 MAPI 伺服器、Exchange 儲存區以及目錄服務存取 (DSAccess) 正在運作中。

指令程式會使用用來登入本機電腦帳戶的認證，來登入所指定的信箱。順利驗證之後，Test-MapiConnectivity 指令程式會存取信箱以驗證資料庫正在運作中。如果順利連接到信箱，指令程式也會決定嘗試進行登入的時間。

可與命令搭配使用的參數有三種：Database、 Identity 及 Server。

  • Database 參數可取得資料庫識別碼，還能在指定的資料庫上測試登入系統信箱的能力。

  • Identity 參數可取得信箱識別碼，還能測試登入特定信箱的能力。

  • Server 參數可取得伺服器識別碼，還能測試登入所指定的伺服器上每個系統信箱的能力。

參數

參數 必要 類型 描述

Database

必要

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Database 參數指定要測試系統信箱連線能力的資料庫。如果未指定此參數或 Identity 參數，則命令會測試所指定伺服器上每個資料庫中的 SystemMailbox，如果未指定 Server 參數，則會測試本機伺服器上每個資料庫中的 SystemMailbox。

Identity

必要

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Identity 參數指定要測試的信箱。您可以使用下列值：

  • GUID

  • 辨別名稱 (DN)

  • 網域\帳戶

  • 使用者主要名稱 (UPN)

  • Legacy Exchange DN

  • 簡易郵件傳送通訊協定 (SMTP) 位址

  • 別名

  • 此參數接受來自 Get-Mailbox 或 Get-Recipient 指令程式的管線輸入。如果物件來自 Get-Mailbox 指令程式或 Get-Recipient 指令程式，便不需要此參數。

  • 如果未指定此參數，則指令程式會測試所指定資料庫上的 SystemMailbox。

ActiveDirectoryTimeout

選用

System.Int32

ActiveDirectoryTimeout 參數指定在作業逾時之前，允許完成每個 Active Directory 作業的時間長度 (以秒為單位)。預設值為 15 秒。

AllConnectionsTimeout

選用

System.Int32

AllConnectionTimeout 參數指定在指令程式逾時之前，允許完成所有連線的時間長度 (以秒為單位)。除非已從 Active Directory 收集執行連線所需的所有資訊，否則不會開始進行逾時倒數。預設值為 90 秒。

Confirm

選用

System.Management.Automation.SwitchParameter

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

DomainController

選用

Microsoft.Exchange.Data.Fqdn

DomainController 參數指定要用以存取 Active Directory 目錄服務的網域控制站。請使用想要使用之網域控制站的網域全名 (FQDN)。

MonitoringContext

選用

System.Boolean

MonitoringContext 參數指定是否在命令結果中包含監視事件及效能計數器。此參數的兩個可能值是 $true 或 $false。如果指定 $true，則結果中除了包含 MAPI 交易的相關資訊之外，還會包含監視事件及效能計數器。

PerConnectionTimeout

選用

System.Int32

PerConnectionTimeout 參數指定在連線逾時之前，允許完成每個連線的時間長度 (以秒為單位)。預設值為 10 秒。

Server

選用

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server 參數指定將要測試 MAPI 連線能力的伺服器。此命令將測試所指定伺服器上每個系統信箱的 MAPI 連線能力。

如果未指定此參數，則命令會測試本機伺服器上的信箱。

WhatIf

選用

System.Management.Automation.SwitchParameter

WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤 描述

 

例外狀況

例外狀況 描述

 

範例

第一個範例會測試伺服器 Server01 的連線能力。

第二個範例會測試信箱的連線，信箱是以網域與使用者名稱來指定。

Test-MapiConnectivity -Server "Server01"
Test-MapiConnectivity -Identity "midwest\john"