Test-CsVoiceUser
上一次修改主题： 2012-03-26
标识通过其完成来自给定用户的电话呼叫（基于语音规则、路由和策略）的路由。
语法
Test-CsVoiceUser -DialedNumber <PhoneNumber> -SipUri <UserIdParameter> [-Force <SwitchParameter>]
详细说明
用户发出电话呼叫时，此呼叫到达其目标所通过的路由取决于分配给该用户的策略和拨号计划。给定一个用户的 SIP 地址和电话号码，此 cmdlet 可以返回转换为 E.164 格式（基于用户的拨号计划）的号码、提供此转换的规范化规则、号码模式与电话号码相匹配的第一个路由（基于路由的优先级）以及将用户的语音策略链接到语音路由的电话用法。
此 cmdlet 可用于确定特定的电话号码能否基于用户设置按预期进行路由和转换，还可以帮助解决各个用户所遇到的问题。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Test-CsVoiceUser cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsVoiceUser"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
DialedNumber |
必需 |
PhoneNumber |
要测试的电话号码。 完整数据类型：Microsoft.Rtc.Management.Voice.PhoneNumber |
SipUri |
必需 |
字符串 |
针对其进行测试的用户的 SIP URI。这是 CsUser cmdlet 中所使用的用户的 Identity。可以使用以下四种格式之一指定用户的标识：1) 用户的 SIP 地址；2) 用户的用户主体名称 (UPN)；3) 用户的域名和登录名，格式为“域名\登录名”（如 litwareinc\kenmyer）；以及 4) 用户的 Active Directory 显示名称（例如 Ken Myer）。请注意，SAMAccountName 不能用作标识。 |
Force |
可选 |
开关参数 |
禁止显示运行此 cmdlet 时可能出现的任何确认提示或非严重错误消息。 |
输入类型
无。
返回类型
返回一个类型为 Microsoft.Rtc.Management.Voice.OcsVoiceUserTestResult 的对象。
示例
-------------------------- 示例 1 --------------------------
Test-CsVoiceUser -DialedNumber "+14255559999" -SipUri "sip:kmyer@litwareinc.com" -Verbose
此示例针对 SIP 地址为 sip:kmyer@litwareinc.com 的用户运行语音用户测试。该测试针对由 DialedNumber 参数提供的电话号码（“+14255559999”）执行。如果没有标识匹配的规则或路由，此 cmdlet 将返回空值。请注意，我们还包含了 Verbose 参数。Verbose 是一个常见的 Windows PowerShell 参数，它将在进行测试时显示其他信息，例如为此测试所加载的拨号计划和语音策略。
-------------------------- 示例 2 --------------------------
Get-CsUser | ForEach-Object {$_.DisplayName; Test-CsVoiceUser -DialedNumber "+14255559999" -SipUri $_.SipAddress} | Format-List
此示例为启用 Lync Server 2010 或 Office Communications Server 的所有用户进行语音路由测试。该命令首先调用 Get-CsUser 以返回启用 Lync Server 2010 或 Office Communications Server 的所有用户的集合。然后，此示例将该用户集合通过管道传递到 ForEach-Object cmdlet。该 cmdlet 将查看每个用户对象，并执行花括号 ({}) 内指定的操作。
第一个操作是输出当前用户的显示名称。（$_ 字符代表当前用户，因此，显示名称包含在 $_ 的 DisplayName 属性中。）现在，我们可以看到正在测试哪个用户帐户。接下来，调用 Test-CsVoiceUser cmdlet，向其传递当前用户的 DialedNumber（“+14255559999”）和 SipUri。在此示例中，我们使用的是用户的 SIP 地址 ($_.SipAddress)。
最后，由于默认情况下，输出使用表格式且可能出现截断以适应屏幕宽度，因此我们将测试结果通过管道传递到 Format-List cmdlet，使其显示为每个用户的显示名称后跟每个输出字段（每个字段对应一行）。