在 Lync Server 2013 中测试 Web 应用程序访问Test Web App access in Lync Server 2013

 

上次修改的主题: 2014-06-07Topic Last Modified: 2014-06-07

验证计划Verification schedule

每月Monthly

测试工具Testing tool

Windows PowerShellWindows PowerShell

所需的权限Permissions required

在使用 Lync Server 命令行管理程序本地运行时,用户必须是 RTCUniversalServerAdmins 安全组的成员。When run locally using the Lync Server Management Shell, users must be members of the RTCUniversalServerAdmins security group.

使用 Windows PowerShell 的远程实例运行时,必须为用户分配具有运行 Test-CsWebApp cmdlet 的权限的 RBAC 角色。When run using a remote instance of Windows PowerShell, users must be assigned an RBAC role that has permission to run the Test-CsWebApp cmdlet. 若要查看可使用此 cmdlet 的所有 RBAC 角色的列表,请从 Windows PowerShell 提示符处运行以下命令:To see a list of all RBAC roles that can use this cmdlet, run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Test-CsWebApp"}

说明Description

Test-CsWebApp cmdlet 验证已通过身份验证的用户是否可以使用 Lync Web App 加入 Lync Server 会议。The Test-CsWebApp cmdlet verifies that authenticated users can join Lync Server conferences by using the Lync Web App. 运行 cmdlet 时,Test-CsWebApp 与 Web 票证服务联系,以获取指定用户的 Web 入场券。When you run the cmdlet, Test-CsWebApp contacts the Web Ticket service to obtain web tickets for the specified users. 这些票证可有效地充当 Lync Server 会议的 "许可票证"。These tickets effectively act as ‘admission tickets” to the Lync Server conference. 如果可以检索票证,并且可以对用户进行身份验证,则 Test-CsWebApp 将与 Lync Server 联系,并尝试为即时消息、应用程序共享和数据协作建立单独的会议。If the tickets can be retrieved, and if the users can be authenticated, Test-CsWebApp will then contact Lync Server and attempt to establish separate conferences for instant messaging, application sharing, and data collaboration.

请注意,Test-CsWebApp 只验证用于创建这些会议的 Api 和连接。Note that Test-CsWebApp just verifies the APIs and connections used to create these conferences. 此 cmdlet 旨在验证 Lync Web App 是否可用于创建和加入会议。The cmdlet is designed to verify that Lync Web App could be used to create and join conferences. 但是,它实际上并不创建和开展会议。However,, it does not actually create and conduct a conference.

运行测试Running the test

可以使用一对预配置的测试帐户或任何两个已启用 Lync Server 的用户的帐户运行 Test-CsWebApp cmdlet。The Test-CsWebApp cmdlet can be run using either a pair of preconfigured test accounts or the accounts of any two users who are enabled for Lync Server. 若要使用测试帐户运行此检查,只需指定要测试的 Lync Server 池的完全限定的域名即可。To run this check using test accounts, you just have to specify the fully qualified domain name of the Lync Server pool being tested. 例如:For example:

Test-CsWebApp -TargetFqdn "atl-cs-001.litwareinc.com"

若要使用实际用户帐户运行此检查,必须为每个帐户 (包含帐户名称和密码) 的对象创建两个 Windows PowerShell 凭据对象。To run this check using actual user accounts, you must create two Windows PowerShell credentials objects (objects that contain the account name and password) for each account. 在调用 CsWebApp 时,必须包括这些凭据对象和两个帐户的 SIP 地址:You must then include those credentials objects and the SIP addresses of the two accounts when you call Test-CsWebApp:

$cred1 = Get-Credential "litwareinc\kenmyer"
$cred2 = Get-Credential "litwareinc\pilar"

Test-CsWebApp -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1 -User2SipAddress "sip:pilar@litwareinc.com" -User2Credential $cred2

有关详细信息,请参阅 CsWebApp cmdlet 的帮助主题。For more information, see the help topic for the Test-CsWebApp cmdlet. 请注意,Test-CsWebApp 已弃用,无法在 Lync Server 2013 上使用。Note that Test-CsWebApp was deprecated for use on Lync Server 2013.

确定成功或失败Determining success or failure

如果 Test-CsWebApp 可以将用户加入其会议,则 cmdlet 将返回测试结果 "成功":If Test-CsWebApp can join the users to their conferences, the cmdlet will return the test result Success:

目标 Fqdn:Target Fqdn :

结果:成功Result : Success

延迟:00:00:00Latency : 00:00:00

错误消息:Error Message :

诊断Diagnosis :

如果用户无法加入必需的会议,则测试结果将被标记为 "失败"。If the users cannot join the necessary conferences then the test result will be marked as Failure. 通常 Test-CsWebApp 还将报告回详细的错误消息和诊断:Typically Test-CsWebApp will also report back a detailed error message and diagnosis:

目标 Fqdn: atl-cs-001.litwareinc.comTarget Fqdn : atl-cs-001.litwareinc.com

结果:失败Result : Failure

延迟:00:00:00Latency : 00:00:00

错误消息:未收到 Web-Ticket 服务的响应Error Message : No response received for Web-Ticket service

诊断: HTTP 请求未通过客户端授权Diagnosis : The HTTP request is unauthorized with client

身份验证方案 "Ntlm"。authentication scheme 'Ntlm'. 的身份验证The authentication

从服务器接收到的标头是 "协商,NTLM"。header received from the server was 'Negotiate,NTLM'.

测试可能失败的原因Reasons why the test might have failed

Test-CsWebApp 故障通常涉及到用户身份验证错误。Test-CsWebApp failures typically involve user authentication errors. 如果 Test-CsWebApp 失败,应首先验证指定的用户是否具有有效的用户帐户,并且是否为 Lync Server 启用了。If Test-CsWebApp fails, you should first verify that the specified users have valid user accounts and are enabled for Lync Server. 您可以使用与以下内容类似的命令检索帐户信息:You can retrieve account information by using a command similar to this:

Get-CsUser -Identity "sip:kenmyer@litwareinc.com" | Select-Object Enabled

如果 Enabled 属性不等于 True,或者如果命令失败,则表示用户没有有效的 Lync Server 帐户。此外,还应验证提供给 cmdlet 的密码是否有效。If the Enabled property is not equal to True or if the command fails, that means that the user does not have a valid Lync Server account.You should also verify that the passwords that you supplied to the cmdlet are valid.