Test-OwaConnectivity

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2010-08-18

使用 Test-OwaConnectivity cmdlet 可验证 Microsoft Office Outlook Web Access 是否按照预期方式运行。Test-OwaConnectivity cmdlet 可用于测试同一 Active Directory 站点内 Exchange 2007 服务器上所有邮箱的某个指定客户端访问服务器上所有 Microsoft Exchange 2007 虚拟目录的 Outlook Web Access 连接情况。Test-OwaConnectivity 还可用于测试单个 Exchange 2007 Outlook Web Access URL 的连接情况。

语法

Test-OwaConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-TestType <Internal | External>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-VirtualDirectoryName <String>] [-WhatIf [<SwitchParameter>]]

Test-OwaConnectivity [-URL <String>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

详细说明

Test-OwaConnectivity cmdlet 可用于测试客户端访问服务器上所有 Exchange 2007 Outlook Web Access 虚拟目录的连接情况，也可用于测试单个 Exchange 2007 Outlook Web Access URL 的连接情况。

若要测试客户端访问服务器上的所有 Exchange 2007 Outlook Web Access 虚拟目录，必须拥有测试 Active Directory 帐户。此外，每台已安装邮箱服务器角色的 Exchange 2007 服务器上必须拥有测试邮箱，该邮箱可以通过要测试的虚拟目录进行访问。可以在邮箱服务器安装期间的某个步骤中创建测试帐户和测试邮箱。如果在邮箱服务器安装期间未创建测试环境，则运行 Test-OwaConnectivity cmdlet 时，系统将提示您运行用于创建测试邮箱和测试用户的脚本。

如果托管测试邮箱的服务器不可用，Test-OWAConnectivity cmdlet 将返回一条错误消息，该消息可能无法清楚地确定问题所在。为了避免出现这种情况，在运行 Test-OWAConnectivity cmdlet 之前，请检查托管测试邮箱的服务器是否正在运行，并检查该邮箱是否可用。

如果在未使用 ClientAccessServer 参数或 URL 参数的情况下，在客户端访问服务器上运行 Test-OwaConnectivity cmdlet，则 cmdlet 会测试运行该 cmdlet 的服务器。若要测试特定客户端访问服务器，请使用 ClientAccessServer 参数。

若要运行 Test-OwaConnectivity cmdlet 来测试某个客户端访问服务器上所有 Exchange 2007 虚拟目录的 Outlook Web Access 连接情况，必须为您使用的帐户委派 Exchange Server 管理员角色以及目标服务器的本地 Administrators 组成员身份。

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

若要测试单个 URL，请使用现有 Exchange 2007 邮箱的 URL 参数和凭据运行 Test-OwaConnectivity。如果 URL 在某个负载平衡器后面，则无法预测 cmdlet 将测试哪个客户端访问服务器。因为使用 URL 参数时需要使用凭据作为参数的一部分，所以，使用 URL 参数时，可以使用任何帐户来运行 Test-OwaConnectivity。

如果 cmdlet 遇到一个不需要安全套接字层 (SSL) 的虚拟目录，除非使用了 AllowUnsecureAccess 参数，否则将跳过该目录。如果使用了 AllowUnsecureAccess 参数，则服务器之间的通信将以明文形式发送，以便进行测试。

可以将 Test-OwaConnectivity cmdlet 作为一次性交互式任务运行，也可以将其作为 Microsoft Operations Manager (MOM) 控制下的计划任务运行。若要将 Test-OwaConnectivity 作为 MOM 任务运行，在 cmdlet 将测试的邮箱服务器上必须存在客户端访问测试环境。

参数

参数	必需	类型	说明
AllowUnsecureAccess	可选	System.Management.Automation.SwitchParameter	如果包含此参数，则此参数会启用不需要测试 SSL 的虚拟目录。如果不包含此参数，该任务将跳过不需要 SSL 的虚拟目录，并将生成错误。
ClientAccessServer	可选	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	此参数指定要测试的客户端访问服务器的名称。如果包含此参数，则会针对本地 Active Directory 站点中的所有 Exchange 2007 邮箱服务器测试客户端访问服务器上的所有 Exchange 2007 Outlook Web Access 虚拟目录。而不会测试 Microsoft Exchange 2000 Server 和 Microsoft Exchange Server 2003 虚拟目录。也不会测试不是 Exchange 2007 邮箱服务器上的邮箱。请不要将此参数与 URL 参数一起使用。
Confirm	可选	System.Management.Automation.SwitchParameter	Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。
DomainController	可选	Microsoft.Exchange.Data.Fqdn	若要指定用于从 Active Directory 目录服务检索数据的域控制器的完全限定的域名 (FQDN)，请在 cmdlet 中包含 DomainController 参数。
LightMode	可选	System.Management.Automation.SwitchParameter	Test-OwaConnectivity 诊断 cmdlet 未实现此参数。使用此参数不会更改该 cmdlet 的行为。 注意： 其他 Exchange 2007 诊断 cmdlet 实现了此参数。具体来说，希望运行某个 cmdlet 占用资源较少的版本时，可以使用此参数。
MailboxCredential	可选	System.Management.Automation.PSCredential	此参数包含用于单个 URL 测试的邮箱凭据。
MailboxServer	可选	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	此参数指定要测试的邮箱服务器的名称。如果未指定，将测试本地 Active Directory 站点中的所有邮箱服务器。
MonitoringContext	可选	System.Management.Automation.SwitchParameter	如果包含此参数，将按照 MOM 日程安排运行任务。如果没有 MOM，使用此参数运行任务时，将会导致任务失败。如果不包含此参数，则必须由管理员交互式运行任务。
ResetTestAccountCredentials	可选	System.Management.Automation.SwitchParameter	ResetTestAccountCredentials 参数重置用于执行此命令的测试帐户的密码。如果使用 Microsoft System Center Operations Manager 管理 Exchange 环境，则测试帐户的密码通常每 7 天重置一次。如果为安全原因所需，则可以随时使用此标志强制重置密码。
Site	可选	Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter	Site 参数用于指定 Active Directory 站点。
TestType	可选	Microsoft.Exchange.Monitoring.OwaConnectivityTestType	此参数确定 cmdlet 将测试的是内部 URL 还是外部 URL。其值为 Internal 和 External。此参数不能与 URL 参数一起使用。如果 TestType 参数和 URL 参数都未指定，则默认值为 TestType:Internal。
Timeout	可选	System.UInt32	此参数指定等待测试操作完成的时间长度（秒）。Timeout 的默认值是 30 秒。必须为 Timeout 指定一个大于 0 秒并且小于 1 小时（3600 秒）的值。建议始终将此参数配置为大于或等于 5 秒的值。
TrustAnySSLCertificate	可选	System.Management.Automation.SwitchParameter	如果使用此参数，则将不会报告 SSL 证书验证失败。这对于测试内部 URL 很有用，因为 Internet 信息服务 (IIS) 不支持为单个虚拟目录分配多个证书。如果一个目录有不同的 URL 供内部和外部访问，并且有一个证书，则该证书通常将用于外部 URL。使用此参数可以在证书与 URL 不匹配时，使该任务检查内部 URL 而不生成错误。
URL	可选	System.String	此参数指定要测试的 Outlook Web Access URL。如果使用此参数，将仅测试指定的 URL。请不要将 URL 参数与 ClientAccessServer 参数一起使用。URL 参数不能与 TestType 参数一起使用。
VirtualDirectoryName	可选	System.String	此参数指定特定客户端访问服务器上要测试的虚拟目录的名称。如果不包含此参数，则将测试支持 Exchange 2007 邮箱的所有 Outlook Web Access 虚拟目录。
WhatIf	可选	System.Management.Automation.SwitchParameter	WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

异常

示例

第一个代码示例使用用户 contoso\kweku 的凭据测试 URL https://mail.contoso.com/owa 的连接情况。

第二个代码示例测试名为 Contoso12 的特定客户端访问服务器的连接情况，并将测试支持 Exchange 2007 邮箱的所有 Outlook Web Access 虚拟目录，包括不需要 SSL 的虚拟目录。

Test-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)
Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess