Test-ImapConnectivity
适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题： 2010-08-18
使用 Test-ImapConnectivity cmdlet 可验证 IMAP4 服务是否按照预期方式运行。Test-ImapConnectivity cmdlet 可用于测试同一 Active Directory 站点中 Exchange 2007 服务器上所有邮箱的指定客户端访问服务器的 IMAP4 功能。
语法
Test-ImapConnectivity [-ClientAccessServer <ServerIdParameter>] [-Confirm [<SwitchParameter>]] [-ConnectionType <Plaintext | Tls | Ssl>] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-PerConnectionTimeout <Int32>] [-PortClientAccessServer <Int32>] [-ResetTestAccountCredentials <SwitchParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
使用 Test-ImapConnectivity cmdlet 可验证 IMAP4 服务是否按照预期方式运行。Test-ImapConnectivity cmdlet 可用于测试指定客户端访问服务器的 IMAP4 功能。
若要运行 Test-PopConnectivity cmdlet 来测试客户端访问服务器上的 IMAP4 功能，必须为您使用的帐户委派 Exchange Server Administrator 角色以及目标服务器的本地 Administrators 组成员身份。
有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
参数
| 参数 | 必需 | 类型 | 说明 | ||
|---|---|---|---|---|---|
ClientAccessServer |
可选 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
此参数指定要测试的客户端访问服务器的名称。请不要将此参数与 URL 参数一起使用。 |
||
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
Confirm 参数将导致命令暂停处理，并且需要您在继续处理之前确认该命令将执行的操作。您不必使用 Confirm 参数指定值。 |
||
ConnectionType |
可选 |
Microsoft.Exchange.Monitoring.ProtocolConnectionType |
此参数指定用于连接到客户端访问服务器的连接类型。 |
||
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定从 Active Directory 目录服务检索数据域控制器的完全限定的域名 (FQDN)，请在 cmdlet 中包含 DomainController 参数。 |
||
LightMode |
可选 |
System.Management.Automation.SwitchParameter |
Test-ImapConnectivity cmdlet 未实现此参数。使用此参数不会更改该 cmdlet 的行为。
|
||
MailboxCredential |
可选 |
System.Management.Automation.PSCredential |
此参数包含用于单个 URL 测试的邮箱凭据。 |
||
MailboxServer |
可选 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
此参数指定要测试的邮箱服务器的名称。如果未指定，将测试本地 Active Directory 站点中的所有邮箱服务器。 |
||
MonitoringContext |
可选 |
System.Management.Automation.SwitchParameter |
如果包含此参数，将按照 Microsoft Operations Manager (MOM) 日程安排运行任务。如果没有 MOM，使用此参数运行任务时，将会导致任务失败。如果不包含此参数，则必须由管理员交互式运行任务。 |
||
PerConnectionTimeout |
可选 |
System.Int32 |
此参数指定每个连接等待测试操作完成的时间长度（秒）。PerConnectionTimeout 的默认值是 24 秒。必须为 Timeout 指定一个大于 0 秒并且小于 120 秒的值。建议始终将此参数配置为大于或等于 5 秒的值。 |
||
PortClientAccessServer |
可选 |
System.Int32 |
此参数指定用于连接到对其使用 Test-ImapConnectivity cmdlet 的客户端访问服务器的端口。 |
||
ResetTestAccountCredentials |
可选 |
System.Management.Automation.SwitchParameter |
ResetTestAccountCredentials 参数重置用于执行此命令的测试帐户的密码。如果使用 Microsoft System Center Operations Manager 管理 Exchange 环境，则测试帐户的密码通常每 7 天重置一次。如果为安全原因所需，则可以随时使用此标志强制重置密码。 |
||
Timeout |
可选 |
System.UInt32 |
此参数指定等待测试操作完成的时间长度（秒）。Timeout 的默认值是 30 秒。必须为 Timeout 指定一个大于 0 秒并且小于 1 小时（3600 秒）的值。建议始终将此参数配置为大于或等于 5 秒的值。 |
||
TrustAnySSLCertificate |
可选 |
System.Management.Automation.SwitchParameter |
如果使用此参数，则将不会报告安全套接字层 (SSL) 证书验证失败。使用此参数可以在证书与客户端访问服务器的 URL 不匹配时，使 Test-ImapConnectivity cmdlet 检查 IMAP4 服务而不会生成错误。 |
||
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。 |
.gif "note")
注意：输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
|
示例
第一个代码示例使用用户 contoso\kweku 的凭据测试客户端访问服务器 Contoso12 的 IMAP4 连接性。
第二个代码示例测试名为 Contoso12 的特定客户端访问服务器的 IMAP4 连接性，并测试所有 Exchange 2007 邮箱。
Test-ImapConnectivity -ClientAccessServer:Contoso12 -MailboxCredential:(get-credential contoso\kweku)
Test-ImapConnectivity -ClientAccessServer:Contoso12