Test-OwaConnectivity

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2010

此 cmdlet 仅在 2010 Exchange Server可用。

使用 Test-OwaConnectivity cmdlet 验证Microsoft Office Outlook Web App是否按预期运行。 Test-OwaConnectivity cmdlet 可用于测试指定客户端访问服务器上的所有Microsoft Exchange Server 2010 虚拟目录Outlook Web App连接，这些邮箱位于同一 Active Directory 站点中运行 Exchange 的服务器。 Test-OwaConnectivity cmdlet 还可用于测试单个 Exchange Outlook Web App URL 的连接。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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

Test-OwaConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-RSTEndpoint <String>]
    [-TestType <OwaConnectivityTestType>]
    [-VirtualDirectoryName <String>]
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

说明

Test-OwaConnectivity cmdlet 测试客户端访问服务器上所有 Exchange Outlook Web App虚拟目录的连接，或测试单个 Exchange Outlook Web App URL 的连接。

若要在客户端访问服务器上测试所有 Exchange Outlook Web App虚拟目录，必须有一个测试 Active Directory 帐户。每个 Active Directory 站点中还必须有一个测试邮箱，用于托管可通过要测试的虚拟目录访问的邮箱。如果在邮箱服务器设置期间未创建测试环境，则运行 Test-OwaConnectivity cmdlet 时，系统会提示你运行创建测试邮箱的脚本并测试用户。

如果托管测试邮箱的服务器不可用，Test-OwaConnectivity cmdlet 将返回一个错误，该错误可能无法清楚地识别问题。若要避免这种情况，请在运行 Test-OwaConnectivity cmdlet 之前检查托管测试邮箱的服务器是否正在运行，以及邮箱是否可用。可以使用 Test-MapiConnectivity cmdlet 执行此操作。

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

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

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

Test-OwaConnectivity cmdlet 可以作为一次性交互式任务运行，也可以作为Microsoft System Center Operations Manager 2007 控件下的计划任务运行。若要将 Test-OwaConnectivity cmdlet 作为 System Center Operations Manager 2007 任务运行，客户端访问测试邮箱必须在 cmdlet 所针对的邮箱服务器上可用。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

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

此示例使用用户 contoso\kweku 的凭据测试 URL https://mail.contoso.com/owa 的连接性。

示例 2

Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess

此示例测试特定客户端访问服务器 Contoso12 的连接性，并测试支持 Exchange 邮箱的所有 Exchange Outlook Web App虚拟目录。这些目录包括不需要 SSL 的虚拟目录。

参数

-AllowUnsecureAccess

AllowUnsecureAccess 开关指定是否测试不需要 SSL 的虚拟目录。不必为此开关指定值。

如果不使用此开关，该命令将跳过不需要 SSL 的虚拟目录，并生成错误。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ClientAccessServer

此参数仅在 Exchange Server 2010 中可用

ClientAccessServer 参数指定要测试的客户端访问服务器的名称。如果包含此参数，则会针对本地 Active Directory 站点中的所有 Exchange 邮箱服务器测试客户端访问服务器上的所有 Exchange Outlook Web App虚拟目录。

不要将此参数与 URL 参数一起使用。

Type:	ServerIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Confirm

Confirm 开关指定是否显示确认提示。此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DomainController

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LightMode

未为此诊断命令实现 LightMode 参数。使用此参数不会更改命令的行为。

此参数是针对其他 Exchange 诊断命令实现的，该命令用于运行命令的不太密集的版本。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxCredential

MailboxCredential 参数指定单个 URL 测试的邮箱凭据。

此参数的值需要 Get-Credential cmdlet。要暂停此命令并接收凭据提示，请使用值 (Get-Credential)。或者，在运行此命令之前，请将凭据存储在变量（例如，$cred = Get-Credential）中，然后将变量名称 ($cred) 用作此参数。有关详细信息，请参阅 Get-Credential。

仅当使用 URL 参数时，才需要 MailboxCredential 参数。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxServer

MailboxServer 参数指定要测试的邮箱服务器的名称。如果未指定，将测试本地 Active Directory 站点中的所有邮箱服务器。

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MonitoringContext

MonitoringContext 开关在结果中添加相关的监视事件和性能计数器。不必为此开关指定值。

通常，在将输出传递到 Microsoft System Center Operations Manager (SCOM) 时，可以在结果中包含监视事件和性能计数器。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ResetTestAccountCredentials

ResetTestAccountCredentials 开关重置用于运行此命令的测试帐户的密码。不必为此开关指定值。

测试帐户的密码通常每七天重置一次。出于安全考虑，请使用此开关根据需要随时强制重置密码。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RSTEndpoint

保留此参数以供 Microsoft 内部使用。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TestType

TestType 参数指定命令测试的是内部 URL 还是外部 URL。值为 Internal 和 External。不能将此参数与 URL 参数一起使用。如果未指定 TestType 参数和 URL 参数，则默认值为 TestType：Internal。

Type:	OwaConnectivityTestType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Timeout

Timeout 参数指定等待测试操作完成的时间，以秒为单位。 Timeout 参数的默认值为 30 秒。必须为超时指定一个大于 0 秒并且小于 1 小时（3,600 秒）的值。建议始终将此参数配置为大于或等于 5 秒的值。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TrustAnySSLCertificate

TrustAnySSLCertificate 开关允许 Exchange 接受来自不受信任的证书颁发机构的证书， (CA) 。不必为此开关指定值。

TrustAnySSLCertificate 开关指定是否忽略安全套接字层 (SSL) 证书验证失败。您无需使用此开关指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-URL

URL 参数指定要测试的 URL。仅当想要测试单个Outlook Web App URL 时，此参数才是必需的。

如果使用此参数，还需要 MailboxCredential 参数。

不能将 URL 参数与 TestType 或 ClientAccessServer 参数一起使用。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-VirtualDirectoryName

VirtualDirectoryName 参数指定要在特定客户端访问服务器上测试的虚拟目录的名称。如果未包含此参数，则会测试支持 Exchange 邮箱的所有 Exchange Outlook Web App虚拟目录。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-WhatIf

WhatIf 开关模拟命令操作。可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。不必为此开关指定值。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。