Test-MapiConnectivity
适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题: 2007-07-05
使用 Test-MapiConnectivity cmdlet 可以通过登录到指定的邮箱来验证服务器是否可以正常工作。如果未指定邮箱,该 cmdlet 将登录到指定数据库上的 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 cmdlet,必须为您使用的帐户委派以下角色:
- Exchange Server 管理员角色和目标服务器的本地 Administrators 组
有关管理 Microsoft 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 参数指定要测试的邮箱。可以使用下列值:
|
ActiveDirectoryTimeout |
可选 |
System.Int32 |
ActiveDirectoryTimeout 参数指定在操作超时之前允许完成每个 Active Directory 操作所使用的时间(秒)。默认值为 15 秒。 |
AllConnectionsTimeout |
可选 |
System.Int32 |
AllConnectionsTimeout 参数指定在 cmdlet 超时之前允许所有连接完成的时间量(秒)。只有从 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"