Partager via

  • Article

Test-CsVoiceNormalizationRule

 

Dernière rubrique modifiée : 2012-03-27

Vérifie un numéro de téléphone par rapport à une règle de normalisation vocale et retourne le numéro après application de la règle de normalisation. Les règles de normalisation vocale permettent de convertir une exigence de numérotation téléphonique (comme par exemple le fait de devoir composer le 9 pour accéder à une ligne externe) au format de numéro de téléphone E.164 utilisé par Microsoft Lync Server 2010.

Syntaxe

Test-CsVoiceNormalizationRule -DialedNumber <PhoneNumber> -NormalizationRule <NormalizationRule>

Description détaillée

Cette cmdlet vous permet de voir les résultats de l’application d’une règle de normalisation vocale à un numéro de téléphone donné. Ces règles de normalisation vocale sont un élément obligatoire de l’autorisation téléphonique et du routage des appels. Elles définissent les exigences de conversion (ou traduction) des numéros d’un format généralement composé par les utilisateurs en format (E.164) standard. Utilisez cette cmdlet pour résoudre des problèmes de numérotation ou pour vérifier que les règles fonctionneront comme prévu avec certains numéros.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Test-CsVoiceNormalizationRule : RTCUniversalServerAdmins. 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-CsVoiceNormalizationRule"}

Paramètres

Paramètre Obligatoire Type Description

DialedNumber

Obligatoire

PhoneNumber

Numéro de téléphone en fonction duquel vous souhaitez tester la règle de normalisation spécifiée dans le paramètre NormalizationRule.

Type de données complet : Microsoft.Rtc.Management.Voice.PhoneNumber

NormalizationRule

Obligatoire

NormalizationRule

Objet contenant une référence à la règle de normalisation de numérotation en fonction de laquelle vous souhaitez tester le numéro précisé dans le paramètre DialedNumber.

Vous pouvez récupérer les itinéraires de normalisation vocale en appelant la cmdlet Get-CsVoiceNormalizationRule.

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule. Accepte la saisie de données transmises via le pipeline pour les objets de règle de normalisation vocale.

Types de retours

Renvoie un objet de type Microsoft.Rtc.Management.Voice.NormalizationRuleTestResult.

Exemple

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

Get-CsVoiceNormalizationRule -Identity "global/11 digit number rule" | Test-CsVoiceNormalizationRule -DialedNumber 14255559999

Cet exemple exécute un test de normalisation vocale par rapport à la règle de normalisation vocale avec l’identité « global/11 digit number rule ». Tout d’abord la cmdlet Get-CsVoiceNormalizationRule est exécutée pour récupérer la règle avec l’identité « global/11 digit number rule ». Cet objet de règle est ensuite redirigé vers la cmdlet Test-CsVoiceNormalizationRule où elle est une nouvelle fois testée par rapport au numéro de téléphone 14255559999. Le résultat obtenu est le paramètre DialedNumber après application de la règle de normalisation vocale « global/11 digit number rule ». Si cette règle ne s’applique pas à la valeur DialedNumber (par exemple, si la règle de normalisation est conforme à un modèle de numéro à 11 chiffres mais que vous utilisez un numéro à 7 chiffres), aucune valeur ne sera retournée.

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

$a = Get-CsVoiceNormalizationRule -Identity "global/11 digit number rule"
Test-CsVoiceNormalizationRule -DialedNumber 5551212 -NormalizationRule $a

L’exemple 2 est identique à l’exemple 1, mais au lieu de rediriger les résultats de l’opération Get directement vers la cmdlet Test, l’objet est d’abord stocké dans la variable $a, puis transmis en tant que valeur au paramètre NormalizationRule à utiliser comme règle de normalisation de test.

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

Get-CsVoiceNormalizationRule | Test-CsVoiceNormalizationRule -DialedNumber 2065559999

Cet exemple exécute un test de normalisation vocale par rapport à toutes les règles de normalisation vocale définies dans le déploiement de Lync Server 2010. La cmdlet Get-CsVoiceNormalizationRule est d’abord exécutée (sans aucun paramètre) afin de récupérer toutes les règles de normalisation vocale. La collection de règles retournée est ensuite redirigée vers la cmdlet Test-CsVoiceNormalizationRule et chacune de ses règles y est testée avec le numéro de téléphone 2065559999. Le résultat obtenu est une liste des numéros traduits, un pour chaque règle testée. Si une règle ne s’applique pas à la valeur DialedNumber (par exemple, si la règle de normalisation est conforme à un modèle de numéro à 11 chiffres mais que vous utilisez un numéro à 7 chiffres), il y aura une ligne vierge dans la liste pour cette règle.