Test-CsPstnPeerToPeerCall
Dernière rubrique modifiée : 2012-03-25
Vérifie que deux utilisateurs peuvent établir un appel d’égal à égal sur une passerelle de réseau téléphonique commuté (PSTN).
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
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
TargetFqdn |
Obligatoire |
Chaîne |
Nom de domaine complet (FQDN) du pool à tester. |
ReceiverCredential |
Facultatif |
Objet Credential PS |
Objet d’identification utilisateur du premier des deux comptes d’utilisateurs à tester. La valeur transmise à ReceiverCredential 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\pilar et le stocke dans une variable appelée $y : $y = Get-Credential "litwareinc\pilar" Vous devez fournir le mot de passe de l’utilisateur lors de l’exécution de cette commande. Les informations d’identification du destinataire ne sont pas nécessaires si vous exécutez le test d’après les paramètres de configuration d’analyse d’intégrité du pool ou si vous utilisez le mode plateforme de serveur. |
ReceiverSipAddress |
Facultatif |
Adresse SIP |
Adresse SIP du premier des deux comptes d'utilisateur à tester. Par exemple : -ReceiverSipAddress "sip:pilar@litwareinc.com". Le paramètre ReceiverSIPAddress doit faire référence au même compte d’utilisateur que ReceiverCredential. L’adresse SIP n’est pas obligatoire si vous exécutez le test d’après les paramètres de configuration d’analyse d’intégrité du pool. |
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. |
SenderCredential |
Facultatif |
Objet Credential PS |
Objet d’identification utilisateur du second des deux comptes d’utilisateurs à tester. La valeur transmise à SenderCredential 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 de l’utilisateur litwareinc\kenmyer et le stocke dans une variable appelée $x : $x = Get-Credential "litwareinc\kenmyer" Vous devez fournir le mot de passe de l’utilisateur lors de l’exécution de cette commande. Les informations d’identification de l’expéditeur ne sont pas nécessaires si vous exécutez le test d’après les paramètres de configuration d’analyse d’intégrité du pool ou si vous utilisez le mode plateforme de serveur. |
SenderSipAddress |
Facultatif |
Adresse SIP |
Adresse SIP du deuxième compte d’utilisateur à tester. Par exemple : -SenderSipAddress "sip:kenmyer@litwareinc.com". Le paramètre SenderSIPAddress doit faire référence au même compte d’utilisateur que SenderCredential. L’adresse SIP n’est pas obligatoire si vous exécutez le test d’après les paramètres de configuration d’analyse d’intégrité du pool. |
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 une sortie dans une variable nommée $TestOutput, utilisez la syntaxe suivante : -OutVerboseVariable TestOutput N’utilisez pas le caractère $ pour indiquer le nom de la variable. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
Verbose |
Facultatif |
Paramètre de commutateur |
Crée un rapport détaillé des activités à l’écran lors de l’exécution de la cmdlet. |
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.