Set-CsTrunkConfiguration
Última modificación del tema: 2012-03-25
Modifica una configuración del tronco existente que describe la configuración de una entidad del mismo nivel de tronco, como una puerta de enlace de red telefónica conmutada (RTC), una central de conmutación (PBX) de IP pública o un controlador de borde de sesión (SBC) del proveedor de servicios.
Sintaxis
Set-CsTrunkConfiguration [-Identity <XdsIdentity>] [-ConcentratedTopology <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <$true | $false>] [-EnableMobileTrunkSupport <$true | $false>] [-EnablePIDFLOSupport <$true | $false>] [-EnableReferSupport <$true | $false>] [-EnableSessionTimer <$true | $false>] [-EnableSignalBoost <$true | $false>] [-Force <SwitchParameter>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
Set-CsTrunkConfiguration [-ConcentratedTopology <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <$true | $false>] [-EnableMobileTrunkSupport <$true | $false>] [-EnablePIDFLOSupport <$true | $false>] [-EnableReferSupport <$true | $false>] [-EnableSessionTimer <$true | $false>] [-EnableSignalBoost <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Use este cmdlet para modificar una configuración del tronco aplicable a entidades de puerta de enlace RTC. Cada configuración consta de opciones específicas para una entidad del mismo nivel de tronco, como una puerta de enlace RTC, IP-PBX o SBC del proveedor de servicios. Esta configuración establece aspectos, por ejemplo, si la omisión de medios está habilitada en este tronco, si los paquetes del protocolo de transporte en tiempo real (RTCP) se envían bajo determinadas condiciones y si el cifrado del protocolo de transporte seguro en tiempo real (SRTP) es obligatorio.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsTrunkConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsTrunkConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Un identificador único que incluye el ámbito de la configuración del tronco. Las configuraciones de tronco pueden estar en el ámbito global o de sitio, o bien en el ámbito de servicio en el caso de un servicio de puerta de enlace RTC. Por ejemplo, site:Redmond (ámbito del sitio) o PstnGateway:Redmond.litwareinc.com (ámbito del servicio). |
Instance |
Opcional |
TrunkConfiguration |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. Este parámetro precisa de un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration, que se puede obtener si se llama al cmdlet Get-CsTrunkConfiguration. |
ConcentratedTopology |
Opcional |
Booleano |
El valor de este parámetro determina si hay un punto de terminación de medios conocido. (Un ejemplo de un punto de terminación de medios conocido sería una puerta de enlace RTC cuya terminación de medios tenga la misma IP que la terminación de señalización.) Establezca este valor en False si el tronco no tiene un punto de terminación de medios conocido. Valor predeterminado: True |
Description |
Opcional |
Cadena de caracteres |
Una cadena que describe el objetivo de la configuración del tronco. |
EnableBypass |
Opcional |
Booleano |
El valor de este parámetro determina si hay habilitado una derivación de medios para este tronco. Establezca este valor en True para habilitar la derivación. Tenga en cuenta que, para que la derivación de medios funcione correctamente, las puertas de enlace RTC, los SBC y las PBx deben dar cabida a una serie de funciones, como: - La capacidad de recibir respuestas bifurcadas para Invitar. - Los clientes de Lync Server 2010 y el punto de terminación de medios deben poder comunicarse directamente sin pasar por un servidor de mediación. - La subred de la puerta de enlace debe estar definida como perteneciente al mismo sitio que la subred del cliente, o bien, si está en un sitio diferente, los sitios no deberán estar separados mediante vínculos WAN con un ancho de banda restringido. La desviación de medios se puede habilitar únicamente bajo las siguientes circunstancias: - El parámetro ConcentratedTopology está establecido en True - El parámetro EnableReferSupport está establecido en False y RTCPActiveCalls y RTCPCallsOnHold, en False, o bien EnableReferSupport está establecido en True Tenga en cuenta que si EnableBypass es True y EnableReferSupport, False, las llamadas de desvío que se transfieran posteriormente se convertirán en llamadas de no derivación. Para que la desviación de medios funcione correctamente con un tronco en particular, debe habilitarse globalmente, y también para el tronco en cuestión. Use el cmdlet New-CsNetworkMediaBypassConfiguration para habilitar la desviación de medios de forma global. Valor predeterminado: False |
EnableMobileTrunkSupport |
Opcional |
Booleano |
Define si el proveedor de servicios es un operador de telefonía móvil. Valor predeterminado: False |
EnablePIDFLOSupport |
Opcional |
Booleano |
Establece si las llamadas de emergencia se van a enrutar con un objeto PIDF-LO a través de la puerta de enlace definida. Establezca este parámetro en True si las llamadas de emergencia se van a enrutar a un proveedor de servicios de emergencia certificado (la ubicación se transmitirá con la llamada). Valor predeterminado: False |
EnableReferSupport |
Opcional |
Booleano |
Define si el tronco admite la recepción de solicitudes de referencia del servidor de mediación. La desviación de medios se puede habilitar únicamente bajo las siguientes circunstancias: - El parámetro ConcentratedTopology está establecido en True - El parámetro EnableReferSupport está establecido en False y RTCPActiveCalls y RTCPCallsOnHold, en False, o bien EnableReferSupport está establecido en True Tenga en cuenta que si EnableBypass es True y EnableReferSupport, False, las llamadas de desvío que se transfieran posteriormente se convertirán en llamadas de no derivación. Valor predeterminado: True |
EnableSessionTimer |
Opcional |
Booleano |
Especifica si se ha habilitado el temporizador de sesión. Los temporizadores de sesión se utilizan para determinar si una sesión determinada aún está activa. Recuerde que, aun cuando este parámetro sea False, los temporizadores de sesión serán aplicables si la conexión remota tiene el temporizador de sesión habilitado, en cuyo caso el servidor de mediación responderá a las pesquisas del temporizador de sesión desde la entidad remota. Valor predeterminado: False |
EnableSignalBoost |
Opcional |
Booleano |
Cuando este parámetro se establece en True, la puerta de enlace RTC, IP-PBX o SBC en el proveedor de servicios aumentará el volumen de audio en las secuencias de voz que se envían al servidor de mediación o los clientes de Microsoft Lync Server 2010. Si se establece en False, el audio aumentará en el servidor de mediación (llamadas que no son de desvío) o bien en los clientes de Lync Server 2010 (llamadas de desvío). Valor predeterminado: False |
MaxEarlyDialogs |
Opcional |
Int64 |
Número máximo de respuestas bifurcadas que una puerta de enlace RTC, IP-PBX o SBC del proveedor de servicios puede recibir para una invitación enviada al servidor de mediación. Valor predeterminado: 20 |
OutboundTranslationRulesList |
Opcional |
Modificador de lista PS |
Una colección de reglas de traducción de números de teléfono que se aplica a las llamadas administradas mediante enrutamiento saliente (llamadas enrutadas a destinos PBX o RTC). A pesar de que esta lista y estas reglas se pueden modificar directamente con este cmdlet, aconsejamos usar el cmdlet Set-CsOutboundTranslationRule para modificar las reglas de traducción de salida. Set-CsOutboundTranslationRule modificará la regla y dichas modificaciones se reflejarán automáticamente en la configuración del tronco. Para modificar la configuración del tronco agregando una nueva regla de traducción de salida, llame al cmdlet New-CsOutboundTranslationRule. La nueva regla se agregará a la configuración del tronco cuyo ámbito coincida. |
RemovePlusFromUri |
Opcional |
Booleano |
Al establecer este parámetro en True, el servidor de mediación quitará los signos más (+) iniciales de los URI antes de enviarlos al proveedor de servicios. Valor predeterminado: False |
RTCPActiveCalls |
Opcional |
Booleano |
Este parámetro determina si, en las llamadas activas, los paquetes RTCP se envían desde la puerta de enlace RTC, IP-PBX o SBC en el proveedor de servicios. En este contexto, una llamada activa consiste en una llamada donde los medios pueden fluir en al menos una dirección. Si RTCPActiveCalls se establece en True, el servidor de mediación o el cliente de Lync Server podrán finalizar una llamada si no se reciben paquetes RTCP en un periodo de 30 segundos. Tenga en cuenta que, si deshabilita las comprobaciones de los medios RTCP recibidos para las llamadas activas en los elementos de Lync Server, estará prescindiendo de un importante método para detectar pares descartados, por lo que se aconseja llevar esto a cabo únicamente cuando sea absolutamente necesario. Valor predeterminado: True |
RTCPCallsOnHold |
Opcional |
Booleano |
Este parámetro determina si los paquetes RTCP se continúan enviando a través del tronco para las llamadas puestas en espera y no se espera el paso de paquetes de medios en ninguna de las direcciones. Si Music on Hold está habilitado en el cliente de Lync Server o en el tronco, se considerará que la llamada está activa y esta propiedad se omitirá. En este tipo de situaciones, use el parámetro RTCPActiveCalls. Tenga en cuenta que, si deshabilita las comprobaciones de los medios RTCP recibidos para las llamadas activas en los elementos de Lync Server, estará prescindiendo de un importante método para detectar pares descartados, por lo que se aconseja llevar esto a cabo únicamente cuando sea absolutamente necesario. Valor predeterminado: True |
SipResponseCodeTranslationRulesList |
Opcional |
Modificador de lista PS |
Lista de reglas de traducción de códigos de respuesta SIP que se aplican a los códigos de respuesta recibidos de una puerta de enlace RTC, IP-PBX o SBC en el proveedor de servicios. Mediante estas reglas, el administrador puede asignar códigos de respuesta SIP con valores entre 400 y 699 recibidos a través de un tronco a nuevos valores más uniformes con Lync Server. Tanto la lista como las reglas correspondientes se pueden crear directamente con este cmdlet, si bien recomendamos crear las reglas de traducción de códigos de respuesta SIP llamando al cmdlet New-CsSipResponseCodeTranslationRule. Con él, se creará la regla y se asignará a la configuración del tronco cuyo ámbito coincida. |
SRTPMode |
Opcional |
SRTPMode |
El valor de este parámetro determina el nivel de compatibilidad de SRTP para proteger el tráfico de medios entre el servidor de mediación y la puerta de enlace RTC, IP-PBX o SBC en el proveedor de servicios. En los casos de desvío de medios, este valor debe ser compatible con el valor de EncryptionLevel en la configuración de medios. La configuración de medios se define mediante los cmdlet New-CsMediaConfiguration y Set-CsMediaConfiguration. Valores válidos: - Required: se debe usar el cifrado SRTP. - Optional: se utilizará SRTP si el proveedor de servicios lo admite. - NotSupported: el cifrado SRTP no se admite y, por lo tanto, no se usará. Nota: SRTPMode solo se usa en caso de que la puerta de enlace se configure para usar la Seguridad de la capa de transporte (TLS). Si está configurada con el Protocolo de control de transmisión (TCP) como transporte, SRTPMode se establece internamente en NotSupported. Valor predeterminado: Requerido |
Force |
Opcional |
Parámetro modificador |
Suprime las preguntas de confirmación que aparecerían antes de realizar cambios. |
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.TrunkConfiguration. Acepta la entrada transferida de objetos de configuración de tronco.
Tipos de valores devueltos
Este cmdlet no devuelve un valor, sino que modifica un objeto del tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
En este ejemplo se modifica una configuración del tronco con el valor de Identity site:Redmond para habilitar la derivación de medios. La derivación de medios se habilita al asignar el valor $True al parámetro EnableBypass. El resto de las propiedades de esta configuración conservará sus valores existentes.
-------------------------- Ejemplo 2 ------------------------
Set-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Translation '$1'
En este ejemplo se modifica una regla de traducción de salida definida para la configuración del tronco con el valor de Identity site:Redmond. Observe que, realmente, no realizamos ninguna llamada al cmdlet Set-CsTrunkConfiguration para efectuar este cambio. Los cambios realizados con Set-CsOutboundTranslationRule se reflejarán automáticamente en la configuración del tronco con un parámetro Identity que coincida con la parte de ámbito del parámetro Identity de la regla de traducción de salida.
-------------------------- Ejemplo 3 ------------------------
Get-CsTrunkConfiguration -Filter site:* | Set-CsTrunkConfiguration -SRTPMode "Optional"
En el Ejemplo 3 se establece SRTPMode para todas las configuraciones del tronco en el ámbito del sitio en Optional. La primera parte del comando es una llamada al cmdlet Get-CsTrunkConfiguration que usa el parámetro Filter para recuperar todas las configuraciones del tronco cuyo Identity comienza por site:, es decir, todas las configuraciones del tronco definidas en el nivel de sitio. A continuación, esta colección de configuraciones se transfiere al cmdlet Set-CsTrunkConfiguration, que establece la propiedad SRTPMode de cada una de ellas en Optional.
-------------------------- Ejemplo 4 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnablePIDFLOSupport $True
En el ejemplo 4 se modifica una configuración del tronco con el valor de Identity site:Redmond para habilitar la compatibilidad de PIDF-LO. De forma predeterminada, el parámetro de EnablePIDFLOSupport es False. En este ejemplo, el valor se estableció en True para habilitar una ubicación compatible con llamadas de emergencia. Debe establecer EnablePIDFLOSupport en True para que la información de ubicación pueda ser enviada al tronco por la aplicación de enrutamiento de salida.