Test-CsWebApp

Syntax

Test-CsWebApp
    [-TargetFqdn] <String>
    [-External]
    [-Force]
    [-OutVerboseVariable <String>]
    [-RegistrarPort <Int32>]
    [-UserSipAddress <String>]
    [-Authentication <AuthenticationMechanism>]
    [-OutLoggerVariable <String>]
    [<CommonParameters>]

Test-CsWebApp
    [[-TargetFqdn] <String>]
    [-External]
    [-Force]
    [-OutVerboseVariable <String>]
    [-RegistrarPort <Int32>]
    -User2Credential <PSCredential>
    -User2SipAddress <String>
    -UserCredential <PSCredential>
    -UserSipAddress <String>
    [-Authentication <AuthenticationMechanism>]
    [-OutLoggerVariable <String>]
    [<CommonParameters>]

Test-CsWebApp
    [-Force]
    [-OutVerboseVariable <String>]
    -TargetUri <String>
    -UserSipAddress <String>
    [-WebCredential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-OutLoggerVariable <String>]
    [<CommonParameters>]

Description

The Test-CsWebApp cmdlet enables administrators to verify that authenticated users can employ Skype for Business Web App in order to join conferences. When you run the Test-CsWebApp cmdlet, the cmdlet attempts to obtain web tickets for a pair of test users by using the Web Ticket service. If the tickets can be obtained, and the test users authenticated, the Test-CsWebApp cmdlet will then try to connect to Skype for Business Server by using Skype for Business Web App. If the connection is made, the cmdlet will then attempt to establish separate conferences for instant messaging, application sharing, and data collaboration.

Many administrators will use the CsHealthMonitoringConfiguration cmdlets to set up test users for each of their Registrar pools. These test users represent a pair of user accounts that have been preconfigured for use with synthetic transactions. (Typically these are test accounts and not accounts that belong to actual users.) If test users are configured for a pool, administrators can run the Test-CsWebApp cmdlet against that pool without having to specify the identity of (and supply the credentials for) the user account involved in the test.

Alternatively, administrators can run the Test-CsWebApp cmdlet using actual user accounts. If you decide to conduct the test using actual user accounts you will need to supply the logon name and password for each account.

Examples

-------------------------- Example 1 --------------------------

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

Example 1 verifies whether or not a pair of test users configured for the pool atl-cs-001.litwareinc.com can use Skype for Business Web App to join a conference. This command will only succeed if you have configured test users for the pool by using the CsHealthMonitoringConfiguration cmdlets.

-------------------------- Example 2 --------------------------

$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

The commands shown in Example 2 verify whether or not the users Ken Myer and Pilar Ackerman can use Skype for Business Web App to join a conference. To use actual user accounts, the first two commands in the example use the Get-Credential cmdlet to create a Windows PowerShell command-line interface credentials objects for the two users (litwareinc\kenmyer and litwareinc\pilar). Those credentials objects (stored in the variables $cred1 and $cred2) are then used as parameter values for the UserCredential and User2Credential parameters in the final command in the example. In addition to the user credential parameters, the UserSipAddress and User2SipAddress parameters are included, along with the SIP addresses of the two user accounts being employed in the test.

Parameters

-Authentication

-External

-Force

-OutLoggerVariable

-OutVerboseVariable

-RegistrarPort

-TargetFqdn

-TargetUri

-User2Credential

-User2SipAddress

-UserCredential

-UserSipAddress

-WebCredential

Inputs

None.

Outputs

System.Object

The Test-CsWebApp cmdlet returns an instance of the Microsoft.Rtc.SyntheticTransactions.TaskOutput object.