New-CsSipResponseCodeTranslationRule
Última modificación del tema: 2012-03-26
Crea una regla de conversión de código de respuesta SIP. 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
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>]]
Descripción detallada
Los troncos SIP permiten establecer conexión con una red VoIP (Protocolo de voz sobre IP), como Enterprise Voice, con la red telefónica conmutada (RTC). En Lync Server 2010, el servidor de mediación usa dispositivos iguales troncales para interactuar con la red RTC. Cuando una llamada saliente falla en 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 hay ningún canal o circuito disponible para completar la llamada. Cuando un dispositivo igual troncal de servidor de mediación recibe este código de causa ISUP, lo convierte en un código de respuesta SIP, que luego 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 de salida. Por ejemplo, se puede asignar a una puerta de enlace que no funciona correctamente un estado de "menos preferida"; de este modo, se reduce el uso de dicha puerta de enlace y aumenta la posibilidad de que una llamada se realice correctamente.
No obstante, no todas las puertas de enlace usan la asignación recomendada de código de causa ISUP y código de respuesta SIP usada por Lync Server. Para estas puertas de enlace, los administradores pueden usar 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, si está disponible) a un código de respuesta SIP usado por Lync Server. Por ejemplo, una puerta de enlace puede asignar un código de causa ISUP 34 (indica que no hay ningún circuito/canal disponible) al código de respuesta SIP 486 (indica que está ocupado). En base al código de respuesta 486, la lógica de enrutamiento de salida de Lync Server no intentará buscar una nueva puerta de enlace para completar la llamada.
Para Lync Server, no obstante, dicho código de respuesta SIP 486 debería asignarse a un código de respuesta SIP 503. Un código de respuesta 503 activa el mecanismo de reintento en la lógica de enrutamiento de salida de Lync Server, de modo que el sistema intentará encontrar otra puerta de enlace para completar la llamada. Para tratar esta situación, puede crear una regla de conversión que asigne la combinación de código de causa ISUP 34 y código de respuesta SIP 486 a un código de respuesta SIP 503. Estas nuevas reglas de conversión se crean mediante el cmdlet New-CsSipResponseCodeTranslationRule. Las reglas de conversión pueden asignarse al ámbito global, al ámbito de sitio o al ámbito de servicio (solo para el Servicio de puerta de enlace RTC).
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsSipResponseCodeTranslationRule de manera local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipResponseCodeTranslationRule"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identificador único de la regla de conversión que se va a crear. La identidad de una regla de conversión consta de dos partes: el ámbito en el que debe asignarse la regla y el nombre que debe asignarse a la regla. Por ejemplo, si se creara una regla de conversión denominada Rule404 en el ámbito global, tendría una identidad como ésta: global/Rule404. En lugar de usar el parámetro Identity, puede usar los parámetros Parent y Name para crear una regla de conversión. |
TranslatedResponseCode |
Requerido |
Entero |
Valor del código de respuesta SIP de Lync Server 2010 al que deberían convertirse ReceivedResponseCode y ReceivedISUPCauseCode. Los códigos de respuesta convertidos pueden ser cualquier valor entero entre 400 y 699, ambos inclusive. |
Name |
Opcional |
Cadena de caracteres |
Nombre que se usa para diferenciar una regla de conversión de otra. Los nombres deben ser únicos dentro de un ámbito; por ejemplo, el sitio Redmond solo puede tener una regla de conversión denominada Rule404. No obstante, puede tener una regla de conversión denominada Rule404 en el sitio Redmond y otra regla denominada Rule404 en el sitio Dublin. El parámetro Name debe usarse siempre junto con el parámetro Parent. |
Parent |
Opcional |
Cadena de caracteres |
Ámbito en el que debe asignarse la nueva regla de conversión. Para asignar una regla al ámbito global, use esta sintaxis: -Parent global. Para asignar una regla al ámbito de sitio, use una sintaxis como ésta: -Parent site:Redmond. Para asignar una regla al ámbito de servicio, use una sintaxis parecida a ésta: -Parent PstnGateway:192.168.0.242. El parámetro Parent debe usarse siempre junto con el parámetro Name. |
Priority |
Opcional |
Entero |
Prioridad relativa de la regla de conversión. Las reglas se procesan según el orden de prioridad que tengan asignado; la primera regla que debe procesarse tiene una prioridad 0, la segunda, una prioridad 1, y así sucesivamente. Si no se especifica ningún valor, se asignará la prioridad más baja a la nueva regla en su ámbito. |
ReceivedISUPCauseValue |
Opcional |
Entero |
Valor del código ISUP (ISDN User Part) que debe estar presente en el mensaje de respuesta SIP usado por una puerta de enlace cuando responde a un mensaje INVITE. Un valor -1 indica que solo se usará el código de respuesta SIP cuando se ejecute la regla de conversión; el código de causa ISUP se omitirá. |
ReceivedResponseCode |
Opcional |
Entero |
Valor del código de respuesta SIP usado por una puerta de enlace cuando responde a un mensaje INVITE. Un código de respuesta puede ser cualquier valor entero entre 400 y 699, ambos inclusive. Si bien el cmdlet aceptará valores enteros inferiores a 400, dichos valores no se reconocen como respuesta final. Como consecuencia, la regla de conversión nunca se usará. Un valor 0 significa que solo se usará el código de causa ISUP cuando se ejecute la regla de conversión; el código de respuesta SIP se omitirá. |
InMemory |
Opcional |
Parámetro modificador |
Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet. |
Force |
Opcional |
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 |
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
Ninguno. New-CsSipResponseCodeTranslationRule no acepta entradas transferidas.
Tipos de valores devueltos
New-CsSipResponseCodeTranslationRule crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.SipResponseCodeTRanslationRule#Decorated.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
New-CsSipResponseCodeTranslationRule -Identity "PstnGateway:192.168.0.240/Rule404" -ReceivedResponseCode 434 -TranslatedResponseCode 404
El comando que se muestra en el ejemplo 1 crea una nueva regla de conversión de códigos de respuesta SIP con el valor de Identity PstnGateway:192.168.0.240/Rule404. Esta regla convierte un código de respuesta recibido 434 en el código de respuesta SIP estándar 404 (No encontrado).
-------------------------- Ejemplo 2 ------------------------
New-CsSipResponseCodeTranslationRule -Parent "PstnGateway:192.168.0.240" -Name "Rule404" -ReceivedResponseCode 434 -TranslatedResponseCode 404
El comando mostrado en el ejemplo 2 lleva a cabo la misma tarea que el comando del ejemplo 1. En el ejemplo 2, no obstante, se usan los parámetros Parent y Name en lugar del parámetro Identity. Esto muestra una forma alternativa de crear una nueva regla de conversión de códigos de respuesta SIP cuyo valor Identity sea PstnGateway:192.168.0.240/Rule404.
Vea también
Otros recursos
Get-CsSipResponseCodeTranslationRule
Remove-CsSipResponseCodeTranslationRule
Set-CsSipResponseCodeTranslationRule