Partager via

  • Article

Set-CsSipResponseCodeTranslationRule

 

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

Modifie une règle de traduction de code de réponse SIP existante. 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

Set-CsSipResponseCodeTranslationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Priority <Int32>] [-ReceivedISUPCauseValue <Int32>] [-ReceivedResponseCode <Int32>] [-TranslatedResponseCode <Int32>] [-WhatIf [<SwitchParameter>]]

Set-CsSipResponseCodeTranslationRule [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-ReceivedISUPCauseValue <Int32>] [-ReceivedResponseCode <Int32>] [-TranslatedResponseCode <Int32>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Les tronçons (ou troncations) 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 du 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. 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.

Set-CsSipResponseCodeTranslationRule vous permet de modifier toutes les règles de traduction préalablement 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 Set-CsSipResponseCodeTranslationRule : 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 "Set-CsSipResponseCodeTranslationRule"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique de la règle de traduction à modifier. L’identité d’une règle de traduction se compose de deux éléments : l’étendue où la règle a été configurée et le nom donné à la règle lors de sa création. Par exemple, une règle de traduction nommée Rule404 qui a été créée dans l’étendue globale aurait l’identité suivante : global/Rule404.

Instance

Facultatif

Entier

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

TranslatedResponseCode

Obligatoire

Entier

Valeur du code de réponse SIP dans laquelle le code ReceivedResponseCode et/ou le code ReceivedISUPCauseCode doivent être traduits. Les codes de réponse traduits peuvent être un entier quelconque de 400 à 699 inclus.

Priority

Entier

Priorité relative de la règle de traduction. Les règles sont traitées selon l’ordre de priorité qui leur a été attribué ; la première règle à traiter affiche une priorité 0, la deuxième a une priorité 1, et ainsi de suite.

ReceivedISUPCauseValue

Facultatif

Entier

Valeur du code de la « partie Usager RNIS » (ISUP) qui doit être incluse dans le message de la réponse SIP qu’utilise une passerelle pour répondre à un message INVITE. Une valeur égale à -1 indique que seul le code de réponse SIP sera employé lors de l’exécution de la règle de traduction. Le code de motif ISUP sera ignoré.

ReceivedResponseCode

Facultatif

Entier

Valeur du code de réponse SIP employé par une passerelle pour répondre à un message INVITE. Un code de réponse peut être un entier quelconque compris entre 400 et 699 inclus. Bien que la cmdlet accepte les valeurs entières inférieures à 400, celles-ci ne sont pas reconnues comme des réponses finales. La règle de traduction ne sera donc jamais utilisée. Une valeur égale à 0 signifie que seul le code de motif ISUP sera employé lors de l’exécution de la règle de traduction. Le code de réponse SIP sera ignoré.

Force

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.

WhatIf

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated. Set-CsSipResponseCodeTranslationRule accepte les instances transmises via le pipeline de l’objet de règle de traduction de code de réponse SIP.

Types de retours

Set-CsSipResponseCodeTranslationRule ne retourne ni objet ni valeur. Au lieu de cela, la cmdlet modifie les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated.

Exemple

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

Set-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -ReceivedISUPCauseValue 477

La commande présentée dans l’exemple 1 modifie la propriété ReceivedISUPCauseValue de la règle de traduction dont l’identité est PstnGateway:192.168.0.240/Rule404.

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

Set-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -Priority 0

Dans l’exemple 2, la règle de traduction dont l’identité est PstnGateway:192.168.0.240/Rule404 est marquée comme étant la règle la plus prioritaire, c’est-à-dire la règle qui sera traitée en premier. Cette opération s’effectue en définissant la propriété sur 0.

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

Get-CsSipResponseCodeTranslationRule | Set-CsSipResponseCodeTranslationRule -ReceivedISUPCauseValue -1

L’exemple 3 explique comment définir sur -1 la propriété ReceivedISUPCauseValue de toutes les règles de traduction configurées pour être utilisées dans votre organisation. Le code de motif ISUP sera ainsi ignoré lors de la traduction des règles. 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 SIP actuellement utilisées. Cette collection est ensuite redirigée vers la cmdlet Set-CsSipResponseCodeTranslationRule qui modifie la propriété ReceivedISUPCauseValue de chaque élément de la collection.