Compartir a través de

  • Artículo

Set-CsSipResponseCodeTranslationRule

 

Última modificación del tema: 2012-03-27

Modifica una regla de traducción de código de respuesta SIP existente. Estas reglas permiten a los administradores asignar códigos de respuesta SIP con valores entre 400 y 699 a los valores usados por Microsoft Lync Server 2010.

Sintaxis

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>]]

Descripción detallada

El enlace troncal SIP ofrece una manera de conectar una red de voz sobre IP (VoIP), como Enterprise Voice, con la red telefónica conmutada (RTC). En Lync Server 2010, el servidor de mediación usa pares de enlaces troncales para interactuar con la red RTC. Cuando se produce un error en una llamada realizada en la red RTC, se genera automáticamente un código de causa de parte del usuario RDSI (ISUP). Por ejemplo, una puerta de enlace RTC podría enviar el código de causa 34 para indicar que no se disponía de ningún circuito ni canal para completar la llamada. Cuando un par de enlaces troncales del servidor de mediación recibe dicho código de causa ISUP, convierte ese código en un código de respuesta SIP, el cual se envía al servidor de mediación. A su vez, Lync Server usa estos códigos de respuesta para tomar sus decisiones de enrutamiento saliente. Por ejemplo, a una puerta de enlace cuyo funcionamiento es defectuoso se le asignará automáticamente el estado de "menor preferencia"; esto desalienta el uso de la puerta de enlace defectuosa y, en consecuencia, maximiza las posibilidades de que la llamada se complete con éxito.

Sin embargo, no todas las puertas de enlace usan el código de causa ISUP recomendado para la asignación del código de respuesta SIP que usa Lync Server. Para estas puertas de enlace, las administradores pueden usar los cmdlets CsSipResponseCodeTranslationRule para asignar el código de respuesta SIP de la puerta de enlace (en combinación con el código de causa ISUP, en caso de que dicho código esté disponible) a un código de respuesta SIP usado por Lync Server. Por ejemplo, una puerta de enlace podría asignarle el código de causa ISUP 34 ("No hay circuitos ni canales disponibles") al código de respuesta SIP 486 ("No disponible"). En función de un código de respuesta de 486, la lógica del enrutamiento saliente de Lync Server no intentará encontrar una nueva puerta de enlace para completar la llamada.

Sin embargo, para Lync Server, ese código de respuesta SIP 486 en cambio se debería asignar al código de respuesta SIP 503. El código de respuesta 503 activa el mecanismo para reintentar en la lógica de enrutamiento de salida de Lync Server; eso significa que el sistema tratará de encontrar otra puerta de enlace para completar la llamada. A fin de controlar esta situación, puede generar una regla de conversión que asigne la combinación del código de causa ISUP 34 y el código de respuesta SIP 486 a un código de respuesta SIP de 503.

El cmdlet Set-CsSipResponseCodeTranslationRule ofrece una manera de modificar cualquiera de las reglas de conversión configuradas previamente en su organización.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsSipResponseCodeTranslationRule localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSipResponseCodeTranslationRule"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único para la regla de traducción que debe modificarse. El parámetro Identity de una regla de conversión consta de dos partes: el ámbito donde la regla se configuró y el nombre otorgado a la regla cuando se la creó. Por ejemplo, una regla de traducción llamada Rule404, que se creó en el ámbito global, tendría una identidad que se vería así: global/Rule404.

Instance

Opcional

Integer

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

TranslatedResponseCode

Requerido

Entero

El valor del código de respuesta SIP al cual ReceivedResponseCode y/o ReceivedISUPCauseCode deberían convertirse. Los códigos de respuesta transferidos pueden ser cualquier valor entero entre 400 y 699 (con ambos valores incluidos).

Priority

Entero

Prioridad relativa de la regla de conversión. Las reglas se procesan en función de su prioridad asignada; la primera regla que se debe procesar tiene la prioridad 0; la segunda, 1; y así sucesivamente.

ReceivedISUPCauseValue

Opcional

Entero

Valor del código de parte del usuario RDSI (ISUP) que debe estar presente en el mensaje de respuesta SIP que usa una puerta de enlace cuando se responde a un mensaje de INVITACIÓN. Un valor de -1 indica que sólo se usará el código de respuesta SIP cuando se ejecute la regla de conversión; el código de causa ISUP no se tendrá en cuenta.

ReceivedResponseCode

Opcional

Entero

Valor del código de respuesta SIP que usa una puerta de enlace cuando responde a un mensaje de INVITACIÓN. Los códigos de respuesta pueden ser cualquier valor entero entre 400 y 699 (con ambos valores incluidos). Si bien el cmdlet acepta valores enteros inferiores a 400, éstos no se reconocen como respuestas finales. En consecuencia, la regla de conversión no se usará nunca. Un valor de 0 indica que sólo el código de causa ISUP se usará cuando se ejecute la regla de conversión; el código de respuesta SIP no se tendrá en cuenta.

Force

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando.

WhatIf

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated. Set-CsSipResponseCodeTranslationRule acepta versiones canalizadas del objeto de la regla de conversión del código de respuesta SIP.

Tipos de valores devueltos

Set-CsSipResponseCodeTranslationRule no devuelve objetos ni valores. En cambio, el cmdlet modifica versiones del objeto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

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

El comando que se muestra en el Ejemplo 1 modifica la propiedad ReceivedISUPCauseValue para la regla de conversión con la identidad PstnGateway:192.168.0.240/Rule404.

-------------------------- Ejemplo 2 --------------------------

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

En el Ejemplo 2, la regla de conversión con la identidad PstnGateway:192.168.0.240/Rule404 se marca como la regla de mayor prioridad; es decir, la regla que se procesará en primer lugar. Esto se lleva a cabo mediante la configuración del parámetro Priority en 0.

-------------------------- Ejemplo 3 --------------------------

Get-CsSipResponseCodeTranslationRule | Set-CsSipResponseCodeTranslationRule -ReceivedISUPCauseValue -1

En el Ejemplo 3, se muestra cómo se puede configurar en -1 la propiedad ReceivedISUPCauseValue de todas las reglas de conversión configuradas para su uso en la organización; esto hará que el código de causa ISUP no se tenga en cuenta durante la conversión de las reglas. Para llevar a cabo esta acción, el comando primero llama a Get-CsSipResponseCodeTranslationRule sin ningún parámetro, para devolver una recopilación de todas las reglas de conversión de código de respuesta SIP que estén actualmente en uso. A continuación, esta recopilación se redirecciona al cmdlet Set-CsSipResponseCodeTranslationRule, que modifica la propiedad ReceivedISUPCauseValue en cada elemento de la recopilación.