Tester les règles, les itinéraires et les stratégies de voix dans Lync Server 2013
Rubrique Dernière modification : 2014-05-20
Planification de vérification |
Mois |
Outil de test |
Windows PowerShell |
Autorisations requises |
En cas d’exécution locale à l’aide de Lync Server Management Shell, les utilisateurs doivent être membres du groupe de sécurité RTCUniversalServerAdmins. Lors de l’exécution à l’aide d’une instance distante de Windows PowerShell, un rôle RBAC doit être attribué aux utilisateurs qui ont l’autorisation d’exécuter l’applet de commande Test-CsVoiceUser. Pour afficher la liste de tous les rôles RBAC qui peuvent utiliser cette applet de commande, exécutez la commande suivante à partir de l’invite Windows PowerShell :
|
Description
Lorsqu’un utilisateur effectue un appel téléphonique, l’itinéraire que l’appel prend pour atteindre sa destination dépend à la fois des stratégies et des plans de numérotation affectés à cet utilisateur. Compte tenu de l’adresse SIP d’un utilisateur et d’un numéro de téléphone, l’applet de commande Test-CsVoiceUser vérifie si l’utilisateur en question peut effectuer un appel à ce numéro. Si le test réussit, Test-CsVoiceUser retourne les éléments suivants :
Numéro traduit au format E.164 (en fonction du plan de numérotation de l’utilisateur)
Règle de normalisation qui a fourni cette traduction
Itinéraire vocal utilisé (en fonction de la priorité de routage) ;
Utilisation du téléphone qui a lié la stratégie vocale de l’utilisateur à l’itinéraire vocal.
Test-CsVoiceUser vous permet de déterminer si un numéro de téléphone spécifique sera acheminé et traduit comme prévu, et peut vous aider à résoudre les problèmes liés aux appels rencontrés par des utilisateurs individuels.
Exécution du test
Lors de l’exécution de l’applet de commande Test-CsVoiceUser, vous devez fournir deux informations : le numéro en cours de numérotation (NumérodNumber) et l’identité du compte d’utilisateur testé. Par exemple, cette commande teste la capacité de l’utilisateur qui a le sip d’adresse SIP :kenmyer@litwareinc.com pour effectuer un appel au numéro de téléphone +1206555-1219 :
Test-CsVoiceUser -DialedNumber "12065551219" -SipUri "sip:kenmyer@litwareinc.com"
Le numéro de téléphone doit être mis en forme de la façon dont vous vous attendez à ce qu’il soit composé. Par exemple, si les utilisateurs ne composent généralement pas le 1 avant de passer un appel longue distance, vous devez utiliser ce format :
-DialedNumber "2065551219"
Bien sûr, dans ce cas, le test échoue si vous n’avez pas de règle de normalisation qui peut traduire correctement le nombre 2065551219 au format de téléphone E.164 utilisé par Lync Server. Pour plus d’informations, consultez la rubrique d’aide New-CsVoiceNormalizationRule cmdlet.
Si vous souhaitez exécuter ce même test sur chacun de vos comptes d’utilisateur, vous pouvez utiliser une commande similaire à la suivante :
Get-CsUser | ForEach-Object {$_.DisplayName; Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri $_.SipAddress} | Format-List
Pour plus d’informations, consultez la documentation d’aide relative à l’applet de commande Test-CsVoiceUser.
Détermination de la réussite ou de l’échec
Si le test est terminé (autrement dit, si l’utilisateur peut passer un appel téléphonique au numéro spécifié), la sortie affiche des informations telles que le numéro de téléphone traduit et la règle de normalisation correspondante et l’itinéraire vocal :
TranslatedNumber MatchingRule FirstMatchingRoute MatchingUsage
---------------- ------------ ------------------ -------------
+12065551219 Descripti... LocalRoute Local
En raison des limitations de l’écran Windows PowerShell, au moins certaines informations retournées (notamment la description complète de la règle de normalisation correspondante) peuvent ne pas apparaître à l’écran. Si vous êtes uniquement intéressé par la réussite ou l’échec du test, cela peut ne pas avoir d’importance. Si vous préférez voir les détails complets des données retournées, dirigez la sortie vers l’applet de commande Format-List lors de l’exécution du test :
Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri "sip:kenmyer@litwareinc.com" -Verbose | Format-List
Cette opération affiche la sortie dans un format plus convivial pour les lecteurs :
TranslatedNumber : +12065551219
MatchingRule : Description=; Pattern=^(\d{11})$; Translation=+$1;
Name=Prefix All;IsInternalExtension=False
FirsMatchingRoute : LocalRoute
MatchingUsage : Local
Si le test échoue, Test-CsVoiceUser retourne un ensemble vide de valeurs de propriétés :
TranslatedNumber MatchingRule FirstMatchingRoute MatchingUsage
---------------- ------------ ------------------ -------------
Raisons pour lesquelles le test a peut-être échoué
Il existe un certain nombre de raisons pour lesquelles l’applet de commande Test-CsVoiceUser peut échouer : il n’existe peut-être pas de règle de normalisation capable de traduire le numéro de téléphone fourni. Il peut y avoir des problèmes avec l’itinéraire vocal. Il peut y avoir un problème de configuration avec le plan de numérotation affecté à l’utilisateur en question. Pour cette raison, vous souhaiterez peut-être inclure le paramètre Détaillé lorsque vous exécutez l’applet de commande Test-CsVoiceUser :
Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri "sip:kenmyer@litwareinc.com" -Verbose
Lorsque l’applet de commande Détaillée est incluse, Test-CsVoiceUser émet un compte rendu détaillé de toutes les étapes prises lors de l’exécution de ses vérifications. Par exemple, vous pouvez voir des étapes similaires à celles-ci :
VERBOSE : Localisation de l’utilisateur avec l’identité « sip:kenmyer@litwareinc.com »
VERBOSE : Chargement du plan de numérotation : « RedmondDialPlan »
Ces informations supplémentaires peuvent fournir des indications sur les étapes que vous pouvez suivre pour identifier la cause de l’échec. Par exemple, la sortie détaillée présentée ici nous indique que l’utilisateur testé a reçu le plan de numérotation RedmondDialPlan. Si le test a échoué, une étape logique suivante consiste à vérifier que RedmondDialPlan peut traduire le numéro de téléphone fourni.
Voir aussi