通过

Test-MapiConnectivity (RTM)

  • 项目

 

适用于： Exchange Server 2007

上一次修改主题： 2007-06-05

使用 Test-MapiConnectivity cmdlet 可以通过登录到指定的邮箱来验证服务器是否可以正常工作。如果未指定邮箱，该 cmdlet 将登录到指定数据库上的 SystemMailbox。

语法

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

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

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

详细说明

若要运行 Test-MapiConnectivity cmdlet，必须为您使用的帐户委派以下角色：

  • Exchange Server 管理员角色和目标服务器的本地 Administrators 组

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

使用 Test-MapiConnectivity cmdlet 可以验证服务器是否可以正常工作。此 cmdlet 将登录到指定的邮箱，如果未指定 Identity 参数，则登录到 SystemMailbox，然后检索收件箱中的项目列表。通过登录到邮箱，可以测试当客户端连接到邮箱服务器时所使用的两个关键协议：MAPI 和 LDAP。在身份验证期间，Test-MapiConnectivity cmdlet 将间接验证 MAPI 服务器、Exchange 存储和目录服务访问 (DSAccess) 是否正常工作。

该 cmdlet 将使用登录到本地计算机所使用的帐户的凭据登录到指定的邮箱。成功进行身份验证之后，Test-MapiConnectivity cmdlet 将访问邮箱，以验证数据库是否正在工作。如果能够与邮箱成功建立连接，则 cmdlet 还会确定发生登录尝试的时间。

有三个明显不同的参数可以与该命令一起使用：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)

  • 域\帐户

  • User principal name (UPN)

  • Legacy Exchange DN

  • 简单邮件传输协议 (SMTP) 地址

  • Alias

  • 此参数接受来自 Get-Mailbox 或 Get-Recipient cmdlet 的管道输入。如果对象是从 Get-Mailbox cmdlet 或 Get-Recipient cmdlet 通过管道操作传输过来的，则不需要此参数。

  • 如果未指定此参数，该 cmdlet 将测试指定数据库上的 SystemMailbox。

ActiveDirectoryTimeout

可选

System.Int32

ActiveDirectoryTimeout 参数指定在操作超时之前允许完成每个 Active Directory 操作所使用的时间（秒）。默认值为 15 秒。

AllConnectionsTimeout

可选

System.Int32

AllConnectionsTimeout 参数指定在 cmdlet 超时之前允许所有连接完成的时间量（秒）。只有从 Active Directory 收集到执行连接所需的所有信息后，才会开始超时倒计时。默认值为 90 秒。

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 连接。

如果未指定此参数，则该命令将测试本地服务器上的邮箱。

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

第一个示例测试与服务器 Server01 的连接。

第二个示例测试与按域名和用户名所指定邮箱的连接。

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