Test-CsVoiceTestConfiguration
上一次修改主题： 2012-03-26
运行测试语音配置以确保语音路由和策略按预期方式工作。
语法
Test-CsVoiceTestConfiguration -TestCaseInputObject <TestConfiguration> [-Dialplan <LocationProfile>] [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>] [-VoicePolicy <VoicePolicy>]
Test-CsVoiceTestConfiguration -DialedNumber <PhoneNumber> -Dialplan <LocationProfile> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]
详细说明
在实现语音路由和语音策略之前，建议用各种电话号码测试这些路由和策略，以确保达到预期的效果。您可以通过运行此 cmdlet 并使用适当的参数设置来进行这些测试。
此 cmdlet 对照语音路由、使用情况、拨号计划和语音策略测试电话号码，使您可以验证预期的结果或将实际结果与预期结果进行比较。可以通过单独输入适当的参数或使用 New-CsVoiceTestConfiguration cmdlet 来定义要测试的语音配置。
如果为 DialedNumber、DialPlan 和 VoicePolicy 输入值，输出将包含转换后的号码、用于创建该转换的规范化规则、所使用的路由以及 PSTN 用法。如果为 TestCaseInputObject 参数输入值，则还可以在使用 New-CsVoiceTestConfiguration cmdlet 创建测试对象时，检索有关这些结果与为该对象提供的预期结果是否匹配的状态。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Test-CsVoiceTestConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsVoiceTestConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
DialedNumber |
必需 |
电话号码 |
要接受测试的电话号码。基于拨号计划、路由和策略，将对此号码进行规范化，并作为输出内容予以显示。 除非为参数 TestCaseInputObject 提供了值，否则此参数是必需的。您不能既提供 DialedNumber，又提供 TestCaseInputObject。（TestCaseInputObject 对象中已经含有 DialedNumber。） |
Dialplan |
必需 |
位置配置文件 |
对运行测试时所使用的拨号计划的拨号计划对象的引用。您可以调用 Get-CsDialPlan cmdlet 来检索拨号计划对象。 如果指定了 DialedNumber 参数，则此参数也是必需的。但如果使用了 TestCaseInputObject 参数，则不要使用此参数。如果使用此参数，参数中的对象必须匹配 TestCaseInputObject 中指定的拨号计划，这样使用此参数就显得多此一举。 |
TestCaseInputObject |
必需 |
测试配置 |
一个对象，其中包含对要测试的语音配置的引用。您可以调用 Get-CsVoiceTestConfiguration cmdlet 来检索此对象引用。 如果调用该 cmdlet 时使用此参数，则不能指定 DialedNumber。也不应指定 Dialplan 或 VoicePolicy，因为在语音测试配置对象中，为这些参数指定值是多余的。 |
VoicePolicy |
必需 |
VoicePolicy |
对运行测试时所使用的语音策略的语音策略对象的引用。您可以调用 Get-CsVoicePolicy cmdlet 来检索语音策略对象。 如果指定了 DialedNumber 参数，则此参数也是必需的。但如果使用了 TestCaseInputObject 参数，则不要使用此参数。如果使用此参数，参数中的对象必须匹配 TestCaseInputObject 中指定的语音策略，这样使用此参数就显得多此一举。 |
RouteSettings |
可选 |
Pstn 路由设置 |
对包含 Microsoft Lync Server 2010 安装中所有可用语音路由的对象的引用。您可以调用 Get-CsRoutingConfiguration cmdlet 来检索此对象。 此参数可以与 DialedNumber 参数或 TestCaseInputObject 参数结合使用。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration 对象。接受通过管道传递的语音测试配置对象的输入。
返回类型
此 cmdlet 可返回一个类型为 Microsoft.Rtc.Management.Voice.OcsVoiceTestResult 的对象。
示例
-------------------------- 示例 1 --------------------------
Get-CsVoiceTestConfiguration -Identity TestConfig1 | Test-CsVoiceTestConfiguration
此示例针对配置 TestConfig1 运行语音配置测试。首先，运行 Get-CsVoiceTestConfiguration cmdlet，以检索 Identity 为 TestConfig1 的配置。然后将该配置对象通过管道传递给 Test-CsVoiceTestConfiguration cmdlet。
-------------------------- 示例 2 --------------------------
$a = Get-CsVoiceTestConfiguration -Identity TestConfig1
Test-CsVoiceTestConfiguration -TestCaseInputObject $a
示例 2 与示例 1 相同，但不是将 Get 操作的结果直接通过管道传递给 Test cmdlet，而是先将此对象存储在变量 $a 中，然后作为参数 TestCaseInputObject 的值传入，用作测试配置。
-------------------------- 示例 3 --------------------------
$dp = Get-CsDialPlan -Identity Global
$vp = Get-CsVoicePolicy -Identity Global
Test-CsVoiceTestConfiguration -DialedNumber 4255551212 -Dialplan $dp -VoicePolicy $vp
此示例运行一个测试配置，但不必首先调用 New-CsVoiceTestConfiguration 来定义该配置。此示例没有传递提前创建的 TestConfiguration 对象，而是演示了如何通过指定要测试的已拨号码及执行测试所针对的拨号计划和语音策略来实时地设置一个测试。
示例的第一行调用 Get-CsDialPlan cmdlet 来检索 Global 拨号计划。检索到的拨号计划对象被分配给变量 $dp。在第二行中，对语音策略执行相同的操作，即调用 Get-CsVoicePolicy cmdlet 来检索 Global 语音策略，然后将该策略分配给变量 $vp。
最后，准备运行测试。我们调用 Test-CsVoiceTestConfiguration，将要测试的电话号码传递给 DialedNumber 参数，将在第一行中检索到的拨号计划（存储在 $dp 中）传递给 Dialplan 参数，将在第二行中检索到的语音策略（存储在 $vp 中）传递给 VoicePolicy 参数。
请注意，示例 3 的输出将不包含预期结果的状态。如果要对照预期结果测试上述结果，必须使用 New-CsVoiceTestConfiguration cmdlet 定义这些预期结果，并按照示例 1 和示例 2 中所示调用 Test-CsVoiceTestConfiguration。