Partager via

  • Article

Get-CsSipResponseCodeTranslationRule

 

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

Renvoie des informations sur les règles de traduction de code de réponse SIP. Ces règles permettent aux administrateurs de mapper les codes de réponse SIP ayant des valeurs comprises entre 400 et 699 aux valeurs utilisées par Microsoft Lync Server 2010.

Syntaxe

Get-CsSipResponseCodeTranslationRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsSipResponseCodeTranslationRule [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

Les tronçons (ou troncation)  SIP permettent de connecter un réseau VoIP (Enterprise Voice, par exemple) à un réseau téléphonique commuté (PSTN). Dans Lync Server 2010, le serveur de médiation utilise des tronçons couplés pour communiquer avec le réseau téléphonique commuté (PSTN). Quand un appel sortant échoue sur le réseau téléphonique commuté, un code de motif de la « partie Usager RNIS » (ISUP) est automatiquement généré. Par exemple, une passerelle PSTN peut retourner le code de motif 34, indiquant ainsi qu’aucun circuit ou canal n’était disponible pour le traitement à terme de l’appel. Lorsqu’une paire de tronçons serveur de médiation reçoit ce code de motif ISUP, il le convertit en code de réponse SIP, qui est ensuite envoyé au serveur de médiation. Lync Server utilise à son tour ces codes de réponse pour décider de la marche à suivre en matière de routage du trafic sortant. Par exemple, une passerelle défaillante peut automatiquement se voir attribuer un état de moindre préférence, ce qui permet de minimiser le recours à la passerelle incriminée et d’augmenter ainsi les chances d’une réalisation en bonne et due forme de l’appel.

Toutefois, toutes les passerelles n’utilisent pas le code de motif ISUP recommandé pour le mappage des codes de réponse SIP utilisés par Lync Server 2010. Pour ces passerelles, les administrateurs peuvent utiliser les cmdlets CsSipResponseCodeTranslationRule afin de mapper le code de réponse SIP de la passerelle (en association avec le code de motif ISUP, le cas échéant) à un code de réponse SIP utilisé par Lync Server. Par exemple, une passerelle peut mapper le code de motif ISUP 34 (« Aucun circuit/canal n’est disponible ») au code de réponse SIP 486 (« Occupé »). Selon le code de réponse 486, la logique de routage du trafic sortant de Lync Server ne tentera pas de chercher une nouvelle passerelle pour conclure l’appel.

Pour Lync Server, toutefois, le code de réponse SIP 486 doit être mappé au code de réponse SIP 503. Le code de réponse 503 entraîne une nouvelle tentative de la part du mécanisme de logique de routage du trafic sortant de Lync Server, ce qui signifie que le système essaie de trouver une autre passerelle pour effectuer l’appel. Pour gérer cette situation, vous pouvez créer une règle de traduction mappant la combinaison du code de motif ISUP 34 et le code de réponse SIP 486 à un code de réponse SIP 503.

La cmdlet Get-CsSipResponseCodeTranslationRule vous permet de récupérer des informations sur toutes les règles de traduction configurées pour être utilisées dans votre organisation.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la règle de traduction. L’identité d’une règle de traduction est constituée de deux parties : l’étendue dans laquelle la règle a été configurée, et le nom attribué à la règle lors de sa création. Par exemple, une règle de traduction appelée Rule404 et créée dans l’étendue globale comporterait une identité similaire à celle-ci : global/Rule404.

En plus de l’étendue globale, vous pouvez créer des règles de traduction dans l’étendue Site ou Service (bien que cela concerne uniquement le service PstnGateway).

Pour renvoyer toutes les règles de traduction créées pour un site ou un service particulier, il suffit de spécifier l’identité du site ou du service. Par exemple :

-Identity « site:Redmond »

Si ce paramètre est omis, Get-CsSipResponseCodeTranslationRule renvoie un ensemble de toutes les règles de traduction de code de réponse SIP.

Filter

Facultatif

Chaîne

Vous permet d’utiliser des caractères génériques pour spécifier la ou les règles de traduction à renvoyer. Par exemple, la syntaxe suivante renvoie toutes les règles de traduction dont l’identité contient la valeur de chaîne « 404 » :

-Filter « *404* »

LocalStore

Facultatif

Paramètre de commutateur

Récupère les données de règle de traduction du code de réponse SIP à partir du réplica local du magasin central de gestion, au lieu du magasin central de gestion lui-même.

Types d’entrées

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

Types de retours

Get-CsSipResponseCodeTranslationRule renvoie des instances de l'objet Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTRanslationRule#Decorated.

Exemple

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

Get-CsSipResponseCodeTranslationRule

La commande illustrée dans l’exemple 1 renvoie un ensemble de toutes les règles de traduction de code de réponse configurées pour être utilisées dans votre organisation. Cette opération est effectuée en appelant la cmdlet Get-CsSipResponseCodeTranslationRule sans aucun paramètre.

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

Get-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404"

La commande précédente renvoie une seule règle de traduction de code de réponse : la règle comportant l’identité PstnGateway:192.168.0.240/Rule404.

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

Get-CsSipResponseCodeTranslationRule -Filter "site:*"

Dans l’exemple 3, le paramètre Filter est utilisé pour limiter les données renvoyées pour toutes les règles de traduction de code de réponse configurées dans l’étendue Site. La valeur de filtre « site:* » limite les données renvoyées aux règles dont l’identité commence par la valeur de chaîne « site: ».

-------------------------- Exemple 4 ------------------------

Get-CsSipResponseCodeTranslationRule | Where-Object {$_.ReceivedISUPCauseValue -eq -1}

La commande illustrée dans l’exemple 4 renvoie un ensemble de toutes les règles de traduction de code de réponse pour lesquelles aucune valeur n’a été attribuée à la propriété ReceivedISUPCauseValue. Pour ce faire, la commande appelle d’abord Get-CsSipResponseCodeTranslationRule sans aucun paramètre, afin de retourner une collection de toutes les règles de traduction de code de réponse actuellement utilisées. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui sélectionne uniquement les règles dans lesquelles la propriété ReceivedISUPCauseValue est égale à -1.