Test-CsVoiceNormalizationRule
上一次修改主题： 2012-03-27
针对语音规范化规则测试一个电话号码并在应用该规范化规则后返回该号码。语音规范化规则用于将电话拨号要求（例如，必须拨 9 才能接入外线）转换为可供 Microsoft Lync Server 2010 使用的 E.164 电话号码格式。
语法
Test-CsVoiceNormalizationRule -DialedNumber <PhoneNumber> -NormalizationRule <NormalizationRule>
详细说明
通过此 cmdlet 可以查看将某个语音规范化规则应用于给定号码的结果。语音规范化规则是电话授权和呼叫路由所必需的部分。它们定义了将号码从用户通常输入的格式转换为标准 (E.164) 格式的要求。使用此 cmdlet 可以解决拨号问题或者验证规则对给定号码是否按预期工作。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Test-CsVoiceNormalizationRule cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsVoiceNormalizationRule"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
DialedNumber |
必需 |
PhoneNumber |
要针对其测试 NormalizationRule 参数中指定的规范化规则的电话号码。 完整数据类型：Microsoft.Rtc.Management.Voice.PhoneNumber |
NormalizationRule |
必需 |
NormalizationRule |
一个包含对规范化规则的引用的对象，该规范化规则是要针对其测试在 DialedNumber 参数中指定的号码的规范化规则。 可以通过调用 Get-CsVoiceNormalizationRule cmdlet 来检索语音规范化规则。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule 对象。接受通过管道传递的语音规范化规则对象的输入。
返回类型
返回一个类型为 Microsoft.Rtc.Management.Voice.NormalizationRuleTestResult 的对象。
示例
-------------------------- 示例 1 --------------------------
Get-CsVoiceNormalizationRule -Identity "global/11 digit number rule" | Test-CsVoiceNormalizationRule -DialedNumber 14255559999
此示例针对 Identity 为“global/11 digit number rule”的语音规范化规则运行语音规范化测试。首先运行了 Get-CsVoiceNormalizationRule cmdlet，以检索 Identity 为“global/11 digit number rule”的规则。然后，将该规则对象通过管道传递到 Test-CsVoiceNormalizationRule cmdlet，后者将针对电话号码 14255559999 测试该规则。在应用了语音规范化规则“global/11 digit number rule”之后，输出将为 DialedNumber。如果此规则不适用于 DialedNumber 值（例如，规范化规则匹配 11 位号码的模式，而您提供的号码为 7 位），则不会返回任何值。
-------------------------- 示例 2 --------------------------
$a = Get-CsVoiceNormalizationRule -Identity "global/11 digit number rule"
Test-CsVoiceNormalizationRule -DialedNumber 5551212 -NormalizationRule $a
示例 2 与示例 1 相同，但不是将 Get 操作的结果直接通过管道传递到 Test cmdlet，而是先将此对象存储在变量 $a 中，然后作为参数 NormalizationRule 的值传入，用作针对其运行测试的语音规范化规则。
-------------------------- 示例 3 --------------------------
Get-CsVoiceNormalizationRule | Test-CsVoiceNormalizationRule -DialedNumber 2065559999
此示例针对在 Lync Server 2010 部署中定义的所有语音规范化规则运行语音规范化测试。首先运行了 Get-CsVoiceNormalizationRule cmdlet（不带任何参数），以检索所有语音规范化规则。然后，将返回的规则集合通过管道传递到 Test-CsVoiceNormalizationRule cmdlet，后者将针对电话号码 2065559999 测试集合中的每个规则。输出将为一个转换后的号码列表，每个号码对应一种测试的规则。如果某个规则不适用于 DialedNumber 值（例如，规范化规则匹配 11 位号码的模式，而您提供的号码为 7 位），则列表中将有一个空白行对应该规则。