Compartir a través de

  • Artículo

Remove-CsSipResponseCodeTranslationRule

 

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

Quita una regla de conversión de código de respuesta SIP. Estas reglas permiten a los administradores asignar códigos de respuesta SIP cuyos valores están entre 400 y 699 a los valores que utiliza Microsoft Lync Server 2010.

Sintaxis

Remove-CsSipResponseCodeTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Los troncos SIP permiten conectar una red de voz sobre IP (VoIP) (como Enterprise Voice) con la red telefónica conmutada (RTC). En Lync Server 2010, servidor de mediación utiliza pares troncales para interactuar con la red RTC. Cuando se produce un error en una llamada saliente de la red RTC, se genera automáticamente un código de causa ISUP (ISDN User Part). Por ejemplo, una puerta de enlace RTC puede enviar un código de causa 34 para indicar que no había ningún circuito ni canal disponible para completar la llamada. Cuando un par troncal de servidor de mediación recibe ese código de causa ISUP, lo convierte en un código de respuesta SIP, el cual se envía a servidor de mediación. A su vez, Lync Server utiliza estos códigos de respuesta para tomar las decisiones de enrutamiento saliente. Por ejemplo, una puerta de enlace que no funciona bien se puede asignar automáticamente a un estado "no preferente". De este modo, se minimiza su uso y, en consecuencia, se maximiza la probabilidad de que una llamada se realice correctamente.

Sin embargo, no todas las puertas de enlace utilizan el código de causa ISUP para la asignación del código de respuesta SIP que utiliza Lync Server. En estos casos, los administradores pueden utilizar los cmdlets CsSipResponseCodeTranslationRule para asignar el código de respuesta SIP de la puerta de enlace (junto con el código de causa ISUP, cuando esté disponible) a un código de respuesta SIP que utilice Lync Server. Por ejemplo, una puerta de enlace puede asignar el código de causa ISUP 34 (que indica que no hay ningún circuito ni canal disponible) al código de respuesta SIP 486 (que significa que está ocupado). Basándose en el código de respuesta 486, la lógica de enrutamiento saliente de Lync Server no intentará buscar una nueva puerta de enlace para realizar la llamada.

Para Lync Server, sin embargo, ese código de respuesta SIP 486 se asignará al código de respuesta SIP 503, el cual inicia el mecanismo de reintento en la lógica de enrutamiento saliente de Lync Server. Es decir, el sistema intentará encontrar otra puerta de enlace para realizar la llamada. Para administrar esta situación, puede crear una regla de traducción que asigne la combinación del código de causa ISUP 34 y el código de respuesta SIP 486 al código de respuesta SIP 503.

Remove-CsSipResponseCodeTranslationRule permite eliminar todas las reglas de traducción que se hayan configurado anteriormente para su uso en la organización.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-CsSipResponseCodeTranslationRule de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de la regla de conversión que se va a quitar. La identidad de una regla de conversión consta de dos partes: el ámbito en que se ha configurado la regla y el nombre dado a la regla al crearla. Por ejemplo, una regla de conversión denominada Rule404 que se haya creado en el ámbito global, tendrá una identidad como ésta: global/Rule404.

Force

Opcional

Parámetro modificador

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

WhatIf

Opcional

Parámetro modificador

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

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated. Remove-CsSipResponseCodeTranslationRule acepta las instancias transferidas del objeto de regla de traducción de código de respuesta SIP.

Tipos de valores devueltos

Remove-CsSipResponseCodeTranslationRule no devuelve un objeto o valor. En su lugar, el cmdlet elimina/modifica instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTranslationRule#Decorated.

Ejemplo

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

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

El comando mostrado en el Ejemplo 1 elimina una sola regla de conversión de código de respuesta: la regla que tiene la identidad PstnGateway:192.168.0.240/Rule404.

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

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

En el Ejemplo 2, se quitan todas las reglas de conversión de código de respuesta de la puerta de enlace RTC 192.168.0.240. Para ello, el comando primero llama a Get-CsSipResponseCodeTranslationRule junto con el parámetro Filter; el valor de filtro "service:PstnGateway:192.168.0.240/*" limita los datos devueltos a las reglas que tengan una identidad que comience por el valor de cadena "service:PstnGateway:192.168.0.240/". A continuación, la colección filtrada se transfiere a Remove-CsSipResponseTranslationCode, que elimina todas las reglas de la colección.

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

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

El comando anterior elimina todas las reglas de conversión de código de respuesta en las que no se haya 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 colección de todas las reglas de conversión de código de respuesta que estén en uso. A continuación, la colección se transfiere al cmdlet Where-Object, que solo selecciona las reglas cuya propiedad ReceivedISUPCauseValue sea igual a -1.

La colección filtrada se transfiere a Remove-CsSipResponseTranslationCode, que elimina todas las reglas de la colección.