Compartir a través de

  • Artículo

Get-CsSipResponseCodeTranslationRule

 

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

Devuelve información acerca de las reglas de conversión de código de respuesta SIP. Estas reglas habilitan a los administradores a asignar códigos de respuesta SIP con valores comprendidos entre 400 y 699 a los valores usados por Microsoft Lync Server 2010.

Sintaxis

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

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

Descripción detallada

El enlace troncal SIP permite conectar una red de conexión de voz sobre IP (VoIP) (por ejemplo, Telefonía IP empresarial) 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 enlace troncal del mismo nivel de servidor de mediación recibe un código de causa ISUP, convierte ese código a un código de respuesta SIP, que a continuación se envía al propio servidor de mediación. A su vez, Lync Server usa estos códigos de respuesta para tomar sus decisiones de enrutamiento de salida. 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 con la asignación del código de respuesta SIP usado por Lync Server 2010. 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 asignar al código de causa ISUP 34 ("No hay circuito/canal disponible") al código de respuesta SIP 486 ("Ocupado"). Según el código de respuesta 486, la lógica de enrutamiento de salida 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. Para manejar esta situación, puede crear una regla de conversión que asigne la combinación del código de causa ISUP 34 y el código de causa SIP 486 al código de respuesta SIP 503.

El cmdlet Get-CsSipResponseCodeTranslationRule lo habilita para recuperar información sobre todas las reglas de conversión configuradas para usar en su organización.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Get-CsSipResponseCodeTranslationRule en forma local: RTCUniversalUserAdmins, 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 "Get-CsSipResponseCodeTranslationRule"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la regla de conversión. La identidad de una regla de conversión está formada por 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.

Además del ámbito global, las reglas de conversión también pueden crearse en el ámbito de sitio o en el ámbito de servicio (aunque únicamente para el servicio PstnGateway).

Para devolver todas las reglas de conversión creadas para un sitio o servicio en particular, simplemente puede especificar el parámetro Identity de dicho sitio o servicio. Por ejemplo:

-Identity "site:Redmond"

Si se omite este parámetro, Get-CsSipResponseCodeTranslationRule devuelve una recopilación de todas las reglas de conversión de código de respuesta SIP.

Filter

Opcional

Cadena de caracteres

Le permite usar comodines al especificar la regla (o las reglas) de conversión a devolver. Por ejemplo, esta sintaxis devuelve todas las reglas de conversión que tienen el valor de cadena "404" en su parámetro Identity:

-Filter "*404*"

LocalStore

Opcional

Parámetro modificador

Recupera los datos de la regla de conversión del código de respuesta SIP de la réplica local de Almacén de administración central en lugar de hacerlo desde el propio Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsSipResponseCodeTranslationRule no acepta entradas canalizadas.

Tipos de valores devueltos

Get-CsSipResponseCodeTranslationRule devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTRanslationRule#Decorated.

Ejemplo

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

Get-CsSipResponseCodeTranslationRule

El comando mostrado en el Ejemplo 1 devuelve una recopilación de todas las reglas de conversión de código de respuesta configuradas para el uso en la organización. Esto se lleva a cabo al llamar a Get-CsSipResponseCodeTranslationRule sin ningún parámetro.

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

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

El comando anterior devuelve una única regla de conversión de código de respuesta: la regla cuyo parámetro Identity es PstnGateway:192.168.0.240/Rule404.

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

Get-CsSipResponseCodeTranslationRule -Filter "site:*"

En el Ejemplo 3, el parámetro Filter se usa para limitar los datos devueltos a todas las reglas de conversión de código de respuesta configuradas en el ámbito del sitio. El valor de filtro "site:*" limita los datos que se devuelven a las reglas cuyo parámetro Identity comienza con el valor de cadena "site:".

-------------------------- Ejemplo 4 --------------------------

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

El comando que se muestra en el Ejemplo 4 devuelve una recopilación de todas las reglas de conversión de código de respuesta en las que no se ha configurado ningún valor para la propiedad ReceivedISUPCauseValue. Para ello, 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 que estén en uso en la actualidad. A continuación, esta recopilación se canaliza al cmdlet Where-Object cmdlet, que solo selecciona las reglas cuya propiedad ReceivedISUPCauseValue sea igual a -1.