Test-CsPhoneBootstrap
上一次修改主题: 2012-03-26
验证用户是否可使用 Microsoft Lync 2010 Phone Edition 兼容的设备登录 Microsoft Lync Server 2010。
语法
Test-CsPhoneBootstrap [-TargetFqdn <String>] -PhoneOrExt <String> -PIN <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetUri <String>] [-UserSipAddress <String>]
详细说明
为了连接到 Lync Server 2010,Lync 2010 Phone Edition 兼容的设备需要使用动态主机配置协议 (DHCP) 检索 Lync Server 注册器的地址;这些设备还必须提供有效的电话号码和关联的个人标识号 (PIN),以便系统进行身份验证。(此过程称为“引导”。)Test-CsPhoneBootstrap cmdlet 使管理员可以验证给定用户能否使用电话号码和为其分配的 PIN 从 Lync 2010 Phone Edition 兼容的设备登录系统。(运行此测试不需要实际使用任何设备。)
为了使 Test-CsPhoneBootstrap 进行检查,必须可以使用 DHCP 发现托管被测试用户帐户的注册器池。要确定能否以此方式发现注册器,请使用 Get-CsRegistrarConfiguration cmdlet 并检查 EnableDHCPServer 属性的值。如果此属性设置为 False,则需要使用 Set-CsRegistrarConfiguration 将属性值设置为 True,并将注册器设置为可使用 DHCP 发现。这也可通过使用 Enterprise DHCP Server 并配置 Lync Server 特定选项来实现。
谁能运行此 cmdlet:要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPhoneBootstrap"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
PhoneOrExt |
必需 |
字符串 |
被测试用户帐户的电话号码或分机。例如:-PhoneOrExt "+14255551219"。 |
PIN |
必需 |
字符串 |
被测试用户帐户的 PIN。 |
RegistrarPort |
可选 |
整数 |
Registrar 服务使用的 SIP 端口。如果 Registrar 使用默认端口 5061,则不需要指定此参数。 |
TargetFqdn |
可选 |
字符串 |
托管被测试用户帐户的注册器池的完全限定域名 (FQDN)。如果未指定,则会使用 DHCP 发现来查找注册器池。 |
TargetUri |
可选 |
字符串 |
证书设置服务的 URL。如果未包括此参数,则会使用 DHCP 发现来查找目标 URI。 |
UserSipAddress |
可选 |
字符串 |
文本中使用的用户帐户的 SIP 地址,例如:-UserSipAddress "sip:kenmyer@litwareinc.com"。UserSIPAddress 参数必须引用提供的电话号码和 PIN;如果包括的电话号码和 PIN 不属于 UserSipAddress 参数指定的用户,则测试会失败。请注意,SIP 地址必须包括“sip:”前缀。 |
OutVerboseVariable |
可选 |
字符串 |
存在此参数时,运行该 cmdlet 的详细输出将存储在指定变量中。例如,若要将输出存储在名为 $TestOutput 的变量中,可使用以下语法: -OutVerboseVariable TestOutput 指定变量名称时不要在前面附加 $ 字符。 |
Force |
可选 |
Guid |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
Verbose |
可选 |
字符串 |
在该 cmdlet 运行时将详细活动显示在屏幕上。 |
输入类型
无。Test-CsPhoneBootstrap 不接受通过管道传递的输入。
返回类型
Test-CsPhoneBootstrap 返回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712"
示例 1 中显示的命令验证具有指定电话号码和 PIN 的用户是否可使用 Lync 2010 Phone Edition 兼容的设备连接到 Lync Server。为了运行该测试,必须提供用户的电话号码 (+14255551219) 和用户的 PIN 号 (0712)。
-------------------------- 示例 2 --------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712" -UserSipAddress "sip:kenmyer@litwareinc.com"
上述命令验证具有指定电话号码和 PIN 的用户是否可使用 Lync 2010 Phone Edition 兼容的设备连接到 Lync Server。在此示例中,包含了 UserSipAddress 参数作为一项额外的检查:如果具有该 SIP 地址的用户与具有指定电话号码和 PIN 的用户不同,则测试将会失败。