Test-UMConnectivity

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

此 cmdlet 仅适用于本地 Exchange。

使用 Test-UMConnectivity cmdlet 测试统一消息 (UM) 服务器的操作。

注意：此 cmdlet 在 Exchange 2010 中效果最佳。在 Exchange 的更高版本中，此 cmdlet 的功能已替换为托管可用性。为了获得最佳结果，请使用 Invoke-MonitoringProbe cmdlet 并指定相关的活动监视器探测，而不是使用此 cmdlet。

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

语法

Test-UMConnectivity
    -Phone <String>
    -PIN <String>
    -TUILogon <Boolean>
    -UMDialPlan <UMDialPlanIdParameter>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -Phone <String>
    -UMIPGateway <UMIPGatewayIdParameter>
    [-DiagDtmfDurationInMilisecs <Int32>]
    [-DiagDtmfSequence <String>]
    [-DiagInitialSilenceInMilisecs <Int32>]
    [-DiagInterDtmfDiffGapInMilisecs <String>]
    [-DiagInterDtmfGapInMilisecs <Int32>]
    [-From <String>]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -ResetPIN <Boolean>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -TUILogonAll <Boolean>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    [-CallRouter]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

说明

设计两个诊断测试用于测试邮箱服务器软件（模式 1）的运行情况以及包括连接的电话组件在内的整个系统（模式 2）的运行情况。

Test-UMConnectivity cmdlet 可以用于测试邮箱服务器的运行情况以及相关的连接电话设备。运行此 cmdlet 并且包括 UMIPGateway 参数时，邮箱服务器将测试统一消息系统完整的端到端运行情况。此测试包括连接到邮箱服务器的电话组件，例如 IP 网关、专用分支 eXchanges (PBX) 和布线。如果未指定 UMIPGateway 参数，则邮箱服务器仅测试在服务器上安装和配置的统一消息组件的运行情况。

在内部部署统一消息部署中运行此 cmdlet 时，需要为此 cmdlet 测试的计算机或服务器创建 UM IP 网关对象。创建 UM IP 网关对象时，必须为其配置完全限定域名 (FQDN)，并且该 FQDN 必须与运行此 cmdlet 的计算机的名称相匹配。

完成此任务后，该 cmdlet 将测试邮箱服务器和相关电话组件的运行情况。

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

示例

示例 1

Test-UMConnectivity

本示例对本地邮箱服务器执行连接测试和运行测试，然后显示 IP 语音 (VoIP) 连接信息。

示例 2

Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false

本示例测试本地邮箱服务器是否可以使用不安全的 TCP 连接（而不是安全的相互 TLS 连接），使用电话号码 56780 通过 UM IP 网关 MyUMIPGateway 发出呼叫。

示例 3

Test-UMConnectivity -Phone sip:sipdp.contoso.com@contoso.com -UMIPGateway MyUMIPGateway -Secured $true -From sip:user1@contoso.com -MediaSecured $true

此示例使用 SIP URI 测试 SIP 拨号计划。此示例可在包含 Lync Server 或 Skype for Business Server 的环境中使用。

参数

-CallRouter

CallRouter 开关指定是否 (前端) 测试 Microsoft Exchange 统一消息呼叫路由器服务。不必为此开关指定值。

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

-CertificateThumbprint

CertificateThumbprint 参数指定用于 SIP 安全和安全模式的证书指纹。

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

-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, Exchange Server 2013, Exchange Server 2016

-DiagDtmfDurationInMilisecs

DiagDtmfDurationInMilisecs 参数指定所发送的每个位的持续时间。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DiagDtmfSequence

DiagDtmfSequence 参数指定所发送的位序列。

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

-DiagInitialSilenceInMilisecs

DiagInitialSilenceInMilisecs 参数指定 cmdlet 在发送位序列之前将暂停的时间段（毫秒）。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DiagInterDtmfDiffGapInMilisecs

DiagInterDtmfDiffGapInMilisecs 参数指定是否自定义诊断序列中各位之间的间隔时间。这是一个逗号分隔的列表，可以接受空条目。此参数应包含多个值。

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

-DiagInterDtmfGapInMilisecs

DiagInterDtmfGapInMilisecs 参数指定位序列中发送的每个位之间的间隔时间（毫秒）。此参数包含单个值。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-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, Exchange Server 2013, Exchange Server 2016

-From

From 参数指定发出呼叫的 SIP URI 或 SIP 地址。仅当使用 Phone 参数时，才会使用它。默认设置是在使用 Phone 参数时指定的 SIP URI。

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

-ListenPort

ListenPort 参数指定要侦听的 IP 端口号。如果未指定，则将使用 IP 端口 9000。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-MediaSecured

MediaSecured 参数指定使用安全 RTP 模式还是 RTP（不安全）模式。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-MonitoringContext

MonitoringContext 参数指定是否在结果中添加相关的监视事件和性能计数器。有效值包含:

$true：监视事件和性能计数器包含在命令结果中。通常，在将输出传递到 Microsoft System Center Operations Manager (SCOM) 时，可以在结果中包含监视事件和性能计数器。
$false：监视事件和性能计数器不包括在命令结果中。此值为默认值。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Phone

Phone 参数指定在重定向测试呼叫时使用的电话号码或会话初始协议 (SIP) 统一资源标识符 (URI)。应当在 PBX 中配置分机号码，才能向 UM 智能寻线转移呼叫。

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

-PIN

PIN 参数指定与启用 UM 的邮箱关联的 PIN。

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

-RemotePort

RemotePort 参数指定用于呼叫的端口。如果未指定，则默认情况下端口 5060 用于传输控制协议 (TCP)，5061 用于相互传输层安全 (TLS)。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-ResetPIN

ResetPIN 参数指定是否为当前站点中的所有测试邮箱生成或重新生成新 PIN。

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

-Secured

Secured 参数指定是否在 SIP 安全模式下运行测试。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Timeout

Timeout 参数指定等待测试操作完成的时间长度（秒）。默认为 600 秒。不能将此参数的值设置为小于 60 秒。但是，建议始终将此参数的值配置为大于或等于 60 秒。此参数的最大值为 1800 秒。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-TUILogon

TUILogon 参数指定 cmdlet 是否尝试登录到一个或多个启用 UM 的邮箱。邮箱必须已启用 UM，并与运行 Microsoft Exchange 统一消息服务的邮箱服务器所属的 UM 拨号计划相关联。默认设置是 $false。

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

-TUILogonAll

TUILogonAll 参数指定是否尝试连接到当前 Active Directory 站点中的所有测试邮箱。默认设置是 $false。必须通过调用 New-TestCasConnectivityUser.ps1 脚本生成所测试的帐户，并且相应的邮箱必须启用 UM 功能。否则，不采取任何操作。

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

-UMDialPlan

UMDialPlan 参数指定要测试的 UM 拨号计划。该参数必须与 TUILogon 参数一起使用。

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

-UMIPGateway

UMIPGateway 参数指定用于进行传出测试呼叫的 UM IP 网关或 IP PBX 的名称。

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

-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, Exchange Server 2013, Exchange Server 2016

输入

Input types

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

输出

Output types

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