New-CsVoiceTestConfiguration
上一次修改主题： 2012-03-27
创建可用于根据指定路由和规则测试电话号码的测试方案。
语法
New-CsVoiceTestConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceTestConfiguration -Name <String> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
详细说明
实施语音路由和语音策略之前，建议针对不同的电话号码对其进行测试，以确保达到预期的结果。要执行此测试，可以使用此 cmdlet 创建测试方案。
New-CsVoiceTestConfiguration cmdlet 可定义语音路由、用法、拨号计划和语音策略，以根据其测试指定的电话号码。所有这些信息都可以使用其他 cmdlet 进行定义和检索；有关详细信息，请参阅本主题的参数描述部分。
使用此 cmdlet 创建的配置需要使用 Test-CsVoiceTestConfiguration cmdlet 进行测试。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsVoiceTestConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsVoiceTestConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
XdsGlobalRelativeIdentity |
唯一标识此测试方案的字符串。 此字符串最多包含 32 个字符，可以包含任何数字字符加反斜杠 (\)、圆点 (.) 或下划线 (_)。 由于此对象只能在 global 作用域创建，因此此参数的值不包含作用域，而只需一个唯一的名称。 |
Name |
必需 |
字符串 |
此参数包含与 Identity 相同的值。如果指定了 Identity 参数，则不能在命令中包含 Name 参数。同样地，如果指定了 Name 参数，则不能指定 Identity 参数。 |
DialedNumber |
可选 |
字符串 |
要用于测试策略、用法等的电话号码。 不得超过 512 个字符。 默认值：1234 |
ExpectedRoute |
可选 |
字符串 |
预期在配置测试过程中使用的语音路由的名称。基于目标拨号计划和语音策略，如果使用了不同的路由，测试将失败。可以通过调用 Get-CsVoiceRoute cmdlet 来检索可用的语音路由。 不得超过 256 个字符。 |
ExpectedTranslatedNumber |
可选 |
字符串 |
采用预期在转换后使用的格式的电话号码。这是规范化后 DialedNumber 参数的值。如果运行 Test-CsVoiceTestConfiguration，而 DialedNumber 没有产生 ExpectedTranslatedNumber 中的值，则测试将报告为 Fail。 不得超过 512 个字符。 默认值：+1234 |
ExpectedUsage |
可选 |
字符串 |
预期在配置测试过程中使用的 PSTN 用法的名称。基于目标拨号计划和语音策略，如果使用了不同的 PSTN 用法，测试将失败。可以通过调用 Get-CsPstnUsage 来检索可用的用法。 不得超过 256 个字符。 |
TargetDialplan |
可选 |
字符串 |
要用于此测试的拨号计划的 Identity。可以通过调用 Get-CsDialPlan cmdlet 来检索拨号计划。 不得超过 40 个字符。 默认值：Global |
TargetVoicePolicy |
可选 |
字符串 |
要针对其运行此测试的语音策略的 Identity。可以通过调用 Get-CsVoicePolicy 来检索语音策略。 不得超过 40 个字符。 默认值：Global |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
此 cmdlet 创建一个类型为 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration 的对象
示例
-------------------------- 示例 1 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1
此示例使用默认值创建一个 Identity 为 TestConfig1 的新语音测试配置。
-------------------------- 示例 2 --------------------------
New-CsVoiceTestConfiguration TestConfig1 -TargetDialplan site:Redmond1
此示例创建一个名为 TestConfig1 的新语音测试配置，并将 TargetDialplan 参数设置为 site:Redmond1。这将导致针对站点 Redmond1 的拨号计划设置运行对预期号码、用法和路由的测试。
在此示例中，声明了 TestConfig1，但没有指定 Identity 参数。Identity 是一个位置参数，因此 cmdlet 会将命令中 cmdlet 名称后的第一个值识别为 Identity。
-------------------------- 示例 3 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212
此示例创建一个名为 TestConfig1 的新语音测试配置。此配置将使用默认值针对预期输出 (ExpectedTranslatedNumber) +5551212 对 DialedNumber 5551212 进行测试。此预期输出基于与针对此对象运行测试时使用的拨号计划关联的规范化规则。此测试必须使用 Test-CsVoiceTestConfiguration cmdlet 运行。