Partager via

  • Article

Remove-CsSipResponseCodeTranslationRule

 

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

Supprime une 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

Remove-CsSipResponseCodeTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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.

La cmdlet Remove-CsSipResponseCodeTranslationRule permet de supprimer 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 Remove-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 "Remove-CsSipResponseCodeTranslationRule"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique de la règle de traduction à supprimer. 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.

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

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

Types de retours

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

Exemple

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

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

La commande présente dans l’exemple 1 supprime une seule règle de traduction de code de réponse : la règle dont l’identité est PstnGateway:192.168.0.240/Rule404.

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

Get-CsSipResponseCodeTranslationRule -Filter "service:PstnGateway:192.168.0.240/*" | Remove-CsSipResponseTranslationCode

Dans l’exemple 2, toutes les règles de traduction de code de réponse sont supprimées de la passerelle PSTN 192.168.0.240. Pour ce faire, la commande appelle d’abord Get-CsSipResponseCodeTranslationRule et le paramètre Filter ; la valeur de filtre « service:PstnGateway:192.168.0.240/* » limite les données retournées aux règles dont l’identité commence par la valeur de chaîne « service:PstnGateway:192.168.0.240/ ». Cette collection filtrée est ensuite redirigée vers Remove-CsSipResponseTranslationCode, qui supprime chaque règle dans la collection.

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

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

La commande précédente supprime toutes les règles de traduction de code de réponse dans lesquelles aucune valeur n’a été configurée pour 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.

À partir de là, la collection filtrée est redirigée vers Remove-CsSipResponseTranslationCode, qui supprime chaque règle contenue dans la collection.