Test-CsPstnOutboundCall
Dernière rubrique modifiée : 2012-03-26
Teste la capacité d’un utilisateur à appeler un numéro de téléphone situé sur le réseau téléphonique commuté (RTC).
Syntaxe
Test-CsPstnOutboundCall -TargetFqdn <String> -TargetPstnPhoneNumber <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsPstnOutboundCall [-TargetFqdn <String>] -TargetPstnPhoneNumber <String> -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Description détaillée
Test-CsPstnOutboundCall 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 pour 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 effectuées de deux manières différentes. 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 à l’aide de comptes d’utilisateur réels. Par exemple, si deux utilisateurs ne parviennent pas à échanger des messages instantanés, un administrateur peut exécuter une transaction synthétique à l’aide des deux comptes d’utilisateurs en question (par opposition à un groupe de comptes de test), et essayer de diagnostiquer et de résoudre le problème. 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-CsPstnOutboundCall peut également être utilisée en mode plate-forme de serveur. Dans ce cas, il vous suffit de spécifier l’adresse SIP d'un utilisateur et Lync Server 2010 utilisera des certificats pour authentifier cet utilisateur.
Lorsque vous exécutez Test-CsPstnOutboundCall, la cmdlet tente d’abord de connecter l’utilisateur test à Lync Server. Si la connexion est correctement établie, la cmdlet essaiera de passer un appel téléphonique sur la passerelle RTC. Cet appel sera effectué en se basant sur le plan de numérotation, la stratégie de voix et d’autres stratégies et paramètres affectés au compte de test. Lorsque l'appel est répondu, la cmdlet envoie des codes de numérotation en fréquences vocales (DTMF) sur le réseau pour vérifier la connectivité multimédia.
Lors de la réalisation d’un test, Test-CsPstnOutboundCall passe un appel téléphonique réel : le téléphone cible retentit et doit être décroché pour que le test réussisse. Par ailleurs, cet appel doit être conclu manuellement par l’administrateur.
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-CsPstnOutboundCall"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
TargetFqdn |
Obligatoire |
Chaîne |
Nom de domaine complet (FQDN) du pool à tester. |
TargetPstnPhoneNumber |
Obligatoire |
Chaîne |
Numéro de téléphone PSTN à appeler lors de l’exécution du test. Pour spécifier au mieux le numéro de téléphone, il est préférable d'utiliser le format E.164. Le numéro ressemblera donc à « +14255551298 », autrement dit, un signe plus (+) suivi de l'indicatif du pays (1), de l'indicatif régional (425) et du numéro de téléphone (5551298). N’utilisez pas de tirets, de parenthèses ou d’autres caractères lors de la saisie du numéro de téléphone. Si vous n'utilisez pas le format E.164, le plan de numérotation de l'utilisateur de test sera ajouté à la fin du numéro. Lync Server 2010 utilisera ensuite ce plan de numérotation pour normaliser le numéro au format E.164. S'il ne peut pas être normalisé, l'appel ne pourra pas être passé et le test échouera. |
UserCredential |
Facultatif |
Objet Credential PS |
Objet d’identification du compte à 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\kenmyer et le stocke dans une variable appelée $x : $x = Get-Credential "litwareinc\kenmyer" Vous devez saisir le mot de passe de l’utilisateur lors de l’exécution de cette commande. Ce paramètre n'est pas nécessaire si la commande utilise des utilisateurs de test configurés à l'aide de la cmdlet CsHealthMonitoringConfiguration. Vous n'avez pas non plus besoin de spécifier ce paramètre si le test est réalisé en mode plate-forme de serveur. Dans ce cas, Lync Server 2010 essaiera d'authentifier l'utilisateur en utilisant des certificats. |
UserSipAddress |
Facultatif |
Adresse SIP |
Adresse SIP du compte d’utilisateur à tester. Par exemple : -SenderSipAddress « sip:kenmyer@litwareinc.com ». Le paramètre UserSipAddress doit se référer au même compte d’utilisateur que UserCredential. Ce paramètre n'est pas nécessaire si la commande utilise des utilisateurs de test configurés à l'aide de la cmdlet CsHealthMonitoringConfiguration. |
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. |
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. |
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 |
Chaîne |
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-CsPstnOutboundCall n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Test-CsPstnOutboundCall retourne une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemple
-------------------------- Exemple 1 --------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567"
L’exemple précédent vérifie si un utilisateur préconfiguré peut se connecter au pool atl-cs-001.litwareinc.com et effectuer ensuite un appel téléphonique 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éterminera si le premier utilisateur test peut se connecter au système et si oui, s’il peut appeler un numéro de téléphone situé sur le réseau PSTN.
Si aucun utilisateur de test n’a été défini, la commande échouera car elle ignore quel utilisateur employer lors de l’exécution du test. Si vous n’avez pas défini d'utilisateur de test pour un pool, vous devez inclure le paramètre UserSipAddress ainsi que les informations d’identification correspondantes pour le compte d’utilisateur impliqué dans le test. Test-CsPstnOutboundCall effectuera ensuite ses vérifications à l’aide du nom d’utilisateur spécifié.
-------------------------- Exemple 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1
Les commandes illustrées dans l’exemple 2 testent la capacité d’un utilisateur test (litwareinc\kenmyer) à se connecter à Lync Server et à effectuer ensuite un appel téléphonique sur la passerelle RTC. 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 Ken Myer (le nom de connexion litwareinc\kenmyer 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 Ken Myer). L’objet d’identification résultant est ensuite stocké dans une variable appelée $cred1.
À partir de cet objet d’identification, la deuxième commande de l’exemple détermine si l’utilisateur de test peut ou non se connecter à Lync Server et appeler ensuite le numéro de téléphone cible (+15551234567). Pour exécuter cette tâche, la cmdlet Test-CsPstnOutboundCall est appelée avec les paramètres suivants : TargetFqdn (le nom de domaine complet du pool de serveurs d’inscriptions), UserSipAddress (l'adresse SIP de l’utilisateur qui effectue l’appel), UserCredential (l'objet Windows PowerShell contenant les informations d’identification de l’utilisateur de test) et TargetPstnPhoneNumber (le numéro de téléphone composé).
-------------------------- Exemple 3 --------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress sip:kenmyer@litwareinc.com -TargetPstnPhoneNumber "+15551234567"
L’exemple 3 présente une utilisation de Test-CsPstnOutboundCall en mode plate-forme de serveur. Avec ce mode, les adresses SIP des utilisateurs 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 l'utilisateur de test.