Partager via

  • Article

New-CsSipResponseCodeTranslationRule

 

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

Crée une nouvelle règle 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

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

New-CsSipResponseCodeTranslationRule -Name <String> -Parent <String> -TranslatedResponseCode <Int32> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ReceivedISUPCauseValue <Int32>] [-ReceivedResponseCode <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 chargée de mapper la combinaison du code de motif ISUP 34 et du code de réponse SIP 486 à un code de réponse SIP 503. Ces nouvelles règles de traduction sont créées à l’aide de la cmdlet New-CsSipResponseCodeTranslationRule. Les règles de traduction peuvent être attribuées au niveau de l’étendue globale, de l’étendue Site ou de l’étendue Service (pour le service de passerelle PSTN uniquement).

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la règle de traduction à créer. L’identité d’une règle de traduction se compose de deux éléments : l’étendue dans laquelle la règle est à affecter et le nom à donner à la règle. Par exemple, une règle de traduction nommée Rule404 à créer dans l’étendue globale aurait l’identité suivante : global/Rule404.

Au lieu d’utiliser le paramètre Identity, utilisez de préférence les paramètres Parent et Name pour créer une nouvelle règle de traduction.

TranslatedResponseCode

Obligatoire

Entier

Valeur du code de réponse SIP Lync Server 2010 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.

Name

Facultatif

Chaîne

Nom employé pour différencier une règle de traduction d’une autre. Les noms doivent être uniques dans une étendue donnée. Par exemple, le site de Redmond peut disposer seulement d’une règle de traduction appelée Rule404. Par contre, vous pouvez avoir une règle de traduction nommée Rule404 sur le site de Redmond et une autre règle portant le même nom sur le site de Dublin.

Le paramètre Name doit toujours être utilisé conjointement avec le paramètre Parent.

Parent

Facultatif

Chaîne

Étendue dans laquelle la nouvelle règle de traduction est à affecter. Pour affecter une règle au niveau de l’étendue globale, optez pour une syntaxe semblable à ce qui suit : -Parent global. Pour affecter une règle au niveau de l’étendue Site, utilisez une syntaxe semblable à ceci : -Parent site:Redmond. Pour affecter une règle au niveau de l’étendue Service, utilisez une syntaxe semblable à ceci : -Parent PstnGateway:192.168.0.242.

Le paramètre Parent doit toujours être utilisé conjointement avec le paramètre Name.

Priority

Facultatif

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. Si aucune priorité n’est définie, la règle recevra la priorité la plus faible de son étendue.

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é.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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.

WhatIf

Facultatif

Paramètre de commutateur

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

Confirm

Facultatif

Paramètre de commutateur

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

Types d’entrées

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

Types de retours

New-CsSipResponseCodeTranslationRule crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTRanslationRule#Decorated.

Exemple

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

New-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -ReceivedResponseCode 434 -TranslatedResponseCode 404

La commande présentée dans l’exemple 1 crée une nouvelle règle de traduction de code de réponse SIP avec un paramètre Identity PstnGateway:192.168.0.240/Rule404. Cette règle traduit un code de réponse reçue 434 en un code de réponse SIP standard 404 (Introuvable).

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

New-CsSipResponseCodeTranslationRule -Parent "PstnGateway:192.168.0.240" -Name "Rule404" -ReceivedResponseCode 434 -TranslatedResponseCode 404

La commande présentée dans l’exemple 2 réalise la même tâche que la commande de l’exemple 1. Dans ce deuxième exemple, en revanche, les paramètres Parent et Name sont utilisés à la place du paramètre Identity. Il s’agit simplement d’une autre méthode permettant de créer une règle de traduction de code de réponse SIP avec un paramètre Identity PstnGateway:192.168.0.240/Rule404.