Test-CsPstnPeerToPeerCall

Syntaxe

Test-CsPstnPeerToPeerCall -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]

Test-CsPstnPeerToPeerCall [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]

Description détaillée

Test-CsPstnPeerToPeerCall est un exemple de « transaction synthétique » Microsoft Lync Server 2010. Les transactions synthétiques utilisées dans Lync Server 2010 permettent de vérifier que les utilisateurs peuvent exécuter les tâches courantes, notamment se connecter au système, échanger des messages instantanés ou appeler un numéro de téléphone sur le réseau téléphonique commuté (PSTN). Ces tests peuvent être réalisés manuellement par un administrateur ou exécutés automatiquement par une application telle que Microsoft System Center Operations Manager (anciennement Microsoft Operations Manager).

Les transactions synthétiques sont généralement exécutées de deux manières. 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.) Avec des utilisateurs de test configurés pour un pool, les administrateurs peuvent exécuter simplement une transaction synthétique dans ce pool sans spécifier les identités (et saisir les informations d’identification) des comptes d’utilisateurs impliqués dans le test.

Les administrateurs peuvent également exécuter une transaction synthétique en utilisant des comptes d’utilisateur réels. Si, par exemple, deux utilisateurs ne peuvent pas échanger des messages instantanés, un administrateur peut exécuter une transaction synthétique en utilisant les deux comptes d’utilisateur (et non pas une paire de comptes de test) et tenter d’identifier la cause du problème pour le résoudre. Si vous décidez d’effectuer une transaction synthétique à l’aide de comptes d’utilisateurs réels, vous devrez saisir les noms des utilisateurs et les mots de passe de chacun d’eux.

La cmdlet Test-CsPstnPeerToPeerCall peut également être utilisée en mode plateforme de serveur. Dans ce cas, il vous suffit de spécifier l’adresse SIP des utilisateurs et Lync Server 2010 utilisera des certificats pour authentifier ces utilisateurs.

Lorsque vous appelez la cmdlet Test-CsPstnPeerToPeerCall, elle tente d’abord de connecter les deux utilisateurs de test à Lync Server. En supposant que les connexions aboutissent, la cmdlet demande à l’utilisateur 1 d’appeler l’utilisateur 2 sur la passerelle PSTN. Test-CsPstnPeerToPeerCall exécute cet appel en utilisant le plan de numérotation, la stratégie de voix et d’autres paramètres de stratégie et de configuration associés à l’utilisateur de test. Si le test aboutit, la cmdlet vérifie que l’utilisateur 2 a pu répondre à l’appel et elle déconnecte les deux comptes de test du système.

La cmdlet Test-CsPstnPeerToPeerCall effectue un appel téléphonique réel destiné à vérifier qu’une connexion peut être établie, puis transmet des codes de numérotation en fréquences vocales (DTMF) sur le réseau pour déterminer si des médias peuvent être envoyés par cette connexion. Puisque la cmdlet répond à l’appel, il n’est pas nécessaire d’y mettre fin manuellement. (En d’autres termes, il n’est pas nécessaire de décrocher puis de raccrocher le téléphone appelé.)

Personnes autorisées à exécuter cette cmdlet : Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

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

Paramètres

Types d’entrées

Aucun. Test-CsPstnPeerToPeerCall n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Test-CsPstnPeerToPeerCall retourne une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.

Exemple

-------------------------- Exemple 1 --------------------------

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

L’exemple précédent vérifie que deux utilisateurs de test préconfigurés peuvent se connecter au pool atl-cs-001.litwareinc.com. Une fois les utilisateurs de test connectés, Test-CsPstnPeerToPeerCall vérifie que les deux utilisateurs peuvent exécuter un appel d’égal à égal sur la passerelle PSTN. Cette commande ne fonctionne que si des utilisateurs de test ont été définis pour le pool atl-cs-001.litwareinc.com. Si tel est le cas, la commande détermine si le premier utilisateur de test peut se connecter au système et appeler le second utilisateur défini dans le pool.

Si aucun utilisateur de test n’a été défini, la commande échouera, car elle ignore quels utilisateurs employer lors de l’exécution du test. Si vous n’avez pas défini d’utilisateurs de test pour un pool et si vous n’utilisez pas le mode plateforme de serveur, vous devez inclure les paramètres SenderSipAddress et ReceiverSipAddress, ainsi que les informations d’identification des utilisateurs employés comme comptes de test. Test-CsPstnPeerToPeerCall effectue ensuite ses vérifications à l’aide des deux utilisateurs spécifiés.

-------------------------- Exemple 2 --------------------------

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

Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2

Les commandes de l’exemple 2 permettent de vérifier si deux utilisateurs (litwareinc\pilar et litwareinc\kenmyer) peuvent se connecter à Lync Server et établir un appel d’égal à égal sur la passerelle PSTN. Pour ce faire, la première commande de l’exemple utilise la cmdlet Get-Credential pour créer un objet d’identification Windows PowerShell contenant le nom et le mot de passe de l’utilisateur Pilar Ackerman. (Le nom de connexion litwareinc\pilar ayant été inclus en tant que paramètre, la boîte de dialogue Demande d’informations d’identification Windows PowerShell qui s’affiche exige uniquement que l’administrateur entre le mot de passe relatif au compte Pilar Ackerman). L’objet d’identification qui en résulte est ensuite stocké dans une variable appelée $cred1. La deuxième commande exécute la même opération, mais en retournant un objet d’identification pour le compte de Ken Myer.

En utilisant les deux objets d’informations d’identification, la troisième commande de l’exemple détermine si les deux utilisateurs peuvent se connecter à Lync Server et établir un appel d’égal à égal sur la passerelle PSTN. Pour exécuter cette tâche, la cmdlet Test-CsPstnPeerToPeerCall est appelée avec les paramètres suivants : TargetFqdn (nom de domaine complet du pool de serveurs d’inscriptions) ; SenderSipAddress (adresse SIP du premier utilisateur de test) ; SenderCredential (objet Windows PowerShell contenant les informations d’identification de cet utilisateur) ; ReceiverSipAddress (adresse SIP du second utilisateur de test) et ReceiverCredential (objet Windows PowerShell contenant les informations d’identification du second utilisateur).

-------------------------- Exemple 3 --------------------------

Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com" 

L’exemple 3 présente une utilisation de Test-CsPstnPeerToPeerCall en mode plateforme de serveur. Avec ce mode, les adresses SIP des utilisateurs de test sont indiquées, mais les informations d’identification des utilisateurs ne le sont pas. Avec ce mode d’exécution, Lync Server 2010 utilise des certificats pour authentifier les deux utilisateurs de test.

Voir aussi

Autres ressources

Test-CsPstnOutboundCall