Test-CsWebApp
Dernière rubrique modifiée : 2012-03-27
Vérifie que les utilisateurs authentifiés peuvent utiliser Microsoft Lync Web App pour se joindre à une conférence Microsoft Lync Server 2010.
Syntaxe
Test-CsWebApp -TargetFqdn <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsWebApp [-TargetFqdn <String>] -User2Credential <PSCredential> -User2SipAddress <String> -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Test-CsWebApp -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Description détaillée
La cmdlet Test-CsWebApp permet aux administrateurs de vérifier que les utilisateurs authentifiés peuvent employer Lync Web App pour se joindre aux conférences. Lorsque vous exécutez Test-CsWebApp, la cmdlet tente d’obtenir des tickets Web pour une paire d’utilisateurs de test via le service Web Ticket. Si les tickets peuvent être obtenus et que les utilisateurs de test sont authentifiés, Test-CsWebApp tente de se connecter à Lync Server 2010 via Lync Web App. Si la connexion aboutit, la cmdlet tente d’établir des conférences séparées pour la messagerie instantanée, le partage d’application et la collaboration de données.
De nombreux administrateurs utiliseront les cmdlets CsHealthMonitoringConfiguration pour configurer des utilisateurs de test pour chacun de leurs pools de serveurs d’inscriptions. Ces utilisateurs de test sont un groupe de deux utilisateurs préconfigurés pour être utilisés avec des transactions synthétiques. En règle générale, il s’agit de comptes de test et non de comptes appartenant à de réels utilisateurs. Lorsque des utilisateurs de test sont configurés pour un pool, les administrateurs peuvent exécuter Test-CsWebApp sur ce pool sans spécifier les identités (ni saisir les informations d’identification) des comptes d’utilisateurs impliqués dans le test.
Les administrateurs peuvent également exécuter Test-CsWebApp à l’aide de comptes d’utilisateur réel. Si vous décidez d’effectuer le test à l’aide de comptes d’utilisateurs réels, vous devrez saisir le nom de connexion et le mot de passe de chacun d’eux.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
TargetFqdn |
Facultatif |
Chaîne |
Nom de domaine complet (FQDN) du pool à tester. Par exemple : -TargetFqdn atl-cs-001.litwareinc.com |
User2Credential |
Facultatif |
PSCredential |
Objet d’identification utilisateur du deuxième compte d’utilisateur à tester. La valeur transmise à User2Credential doit être une référence d’objet obtenue à l’aide de la cmdlet Get-Credential. Par exemple, ce code retourne un objet d’identification pour l’utilisateur litwareinc\kenmyer et le stocke dans une variable appelée $y : $y = Get-Credential "litwareinc\kenmyer" Vous devez saisir le mot de passe de l’utilisateur lors de l’exécution de cette commande. |
User2SipAddress |
Facultatif |
Chaîne |
Adresse SIP du deuxième compte d’utilisateur à tester. Par exemple : -User2SipAddress "sip:pilar@litwareinc.com" Ce paramètre n’est pas nécessaire si vous exécutez le test à l’aide d’utilisateurs de test configurés via les cmdlets CsHealthMonitoringConfiguration. |
UserCredential |
Facultatif |
PSCredential |
Objet d’identification du premier compte d’utilisateur à tester. La valeur transmise à UserCredential doit être une référence d’objet obtenue à l’aide de la cmdlet Get-Credential. Par exemple, ce code renvoie un objet d’identification de l’utilisateur litwareinc\pilar et le stocke dans une variable appelée $x : $x = Get-Credential "litwareinc\pilar" Vous devez saisir le mot de passe de l’utilisateur lors de l’exécution de cette commande. |
UserSipAddress |
Facultatif |
Chaîne |
Adresse SIP du premier des deux comptes d’utilisateurs à tester. Par exemple : -UserSipAddress "sip:kenmyer@litwareinc.com" Ce paramètre n’est pas nécessaire si vous exécutez le test à l’aide d’utilisateurs de test configurés via les cmdlets CsHealthMonitoringConfiguration. |
External |
Facultatif |
SwitchParameter |
S’il est présent, ce paramètre indique à Test-CsWebApp de tester le relais Web externe du serveur Reach. S’il ne l’est pas, la cmdlet teste le relais Web interne. Le relais Web sert d’intermédiaire entre le réseau interne et Internet. |
TargetUri |
Facultatif |
Chaîne |
URI (Uniform Resource Identifier) du serveur Reach. Par exemple : -TargetUri "https://atl-cs-001.litwareinc.com/reach" Vous ne pouvez pas utiliser les paramètres TargetUri et TargetFqdn dans une même commande. |
WebCredential |
Facultatif |
Objet Credential PS |
Objet d’identification du compte d’utilisateur à utiliser dans le test. La valeur transmise à UserCredential doit être une référence d’objet obtenue à l’aide de la cmdlet Get-Credential. Par exemple, ce code retourne un objet d’identification pour l’utilisateur litwareinc\kenmyer et stocke cet objet dans une variable nommée $x : $x = Get-Credential "litwareinc\kenmyer" Ce paramètre est requis si le paramètre TargetUri ou les paramètres UserSipAddress/User2SipAddress sont spécifiés, et si l’ordinateur sur lequel vous exécutez la commande n’a pas de certificat de serveur. |
RegistrarPort |
Facultatif |
Entier |
Port SIP utilisé par le service Serveur d’inscriptions. Ce paramètre n’est pas obligatoire si le serveur d’inscriptions utilise le port par défaut 5061. |
OutVerboseVariable |
Facultatif |
Chaîne |
Lorsqu’elle est définie, la sortie détaillée de l’exécution de la cmdlet est stockée dans la variable spécifiée. Par exemple, pour stocker la sortie dans une variable appelée $TestOutput, utilisez la syntaxe suivante -OutVerboseVariable TestOutput N’utilisez pas le caractère $ pour indiquer le nom de la variable. |
Force |
Facultatif |
SwitchParameter |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
Types d’entrées
Aucun.
Types de retours
Test-CsWebApp retourne une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.TaskOutput.
Exemple
-------------------------- Exemple 1 --------------------------
Test-CsWebApp -TargetFqdn atl-cs-001.litwareinc.com
La commande précédente vérifie si une paire d’utilisateurs de test configurée pour le pool atl-cs-001.litwareinc.com peut utiliser Lync Web App pour se joindre à une conférence. Cette commande aboutit uniquement si vous avez configuré des utilisateurs de test pour le pool via les cmdlets CsHealthMonitoringConfiguration.
-------------------------- Exemple 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
Les commandes de l’exemple 2 vérifient si les utilisateurs Ken Myer et Pilar Ackerman peuvent utiliser Lync Web App pour se joindre à une conférence. Pour utiliser des comptes d’utilisateurs réels, les deux premières commandes de l’exemple utilisent la cmdlet Get-Credential pour créer des objets Informations d’identification Windows PowerShell pour les deux utilisateurs (litwareinc\kenmyer et litwareinc\pilar). Ces objets Informations d’identification (stockés dans les variables $cred1 et $cred2) servent ensuite de valeurs pour les paramètres UserCredential et User2Credential dans la commande finale de l’exemple. Outre les paramètres d’informations d’identification de l’utilisateur, les paramètres UserSipAddress et User2SipAddress sont inclus, avec les adresses SIP des deux comptes d’utilisateurs employés dans le test.