New-CsTrunkConfiguration
Última modificación del tema: 2012-03-27
Crea una nueva configuración troncal que describe la configuración para una entidad troncal del mismo tipo, como una puerta de enlace de red telefónica conmutada (RTC), un sistema PBX (Public Branch eXchange) IP o un controlador SBC (Session Border Controller) en el proveedor de servicios.
Sintaxis
New-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>] [-InMemory <SwitchParameter>] [-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 crear una configuración troncal aplicable a las entidades de puerta de enlace RTC. Cada configuración contiene opciones de configuración específicas para una entidad troncal del mismo tipo, como una puerta de enlace RTC, un sistema IP-PBX o un controlador SBC en el 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 New-CsTrunkConfiguration 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-CsTrunkConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Un identificador único que incluye el ámbito de la configuración troncal. La configuración troncal puede estar en el ámbito de sitio, o bien en el ámbito de servicio en el caso de un servicio de puerta de enlace RTC. (De forma predeterminada existe una configuración global, que no puede quitarse ni crearse de nuevo.) Por ejemplo, site:Redmond (para sitio) o PstnGateway:Redmond.litwareinc.com (para servicio). |
ConcentratedTopology |
Opcional |
Booleano |
El valor de este parámetro determina si existe 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.) Si el tronco no tiene un punto de terminación de medios conocido, defina este valor en False. Valor predeterminado: True |
Description |
Opcional |
Cadena de caracteres |
Una cadena de caracteres que describe el propósito de la configuración troncal. |
EnableBypass |
Opcional |
Booleano |
El valor de este parámetro determina si la omisión de medios está habilitada para este tronco. Establezca este valor en True para habilitar la derivación. Tenga en cuenta que para que la omisión de medios funcione correctamente, las puertas de enlace RTC, los controladores SBC y los sistemas PBX deben ser compatibles con determinadas prestaciones, como: - Recibir respuestas bifurcadas para una invitación (Invite). - Los clientes de Microsoft 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 definirse en el mismo sitio que la subred del cliente o, si se encuentra en un sitio diferente, los sitios no deben separarse mediante vínculos WAN con un ancho de banda restringido. La omisión de medios solo puede habilitarse en las siguientes circunstancias: - El parámetro ConcentratedTopology está establecido en True - El parámetro EnableReferSupport está establecido en False y los parámetros RTCPActiveCalls y RTCPCallsOnHold están establecidos en False, o EnableReferSupport está establecido en True Tenga en cuenta que si EnableBypass está establecido en True y el valor de EnableReferSupport es False, las llamadas de omisión que se transfieran a continuación pasarán a ser de no omisión. Para que la omisión de medios funcione correctamente para un elemento troncal concreto, debe habilitarse de forma global así como para el elemento en cuestión. Use el cmdlet New-CsNetworkMediaBypassConfiguration para habilitar la omisió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 |
Define si deben desviarse las llamadas de emergencia con PIDF-LO (Presence Information Data Format Location Object) a través de la puerta de enlace definida. Establezca este parámetro en True si las llamadas de emergencia deben desviarse 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 (Refer) del servidor de mediación. La omisión de medios solo puede habilitarse en las siguientes circunstancias: - El parámetro ConcentratedTopology está establecido en True - El parámetro EnableReferSupport está establecido en False y los parámetros RTCPActiveCalls y RTCPCallsOnHold están establecidos en False, o EnableReferSupport está establecido en True Tenga en cuenta que si EnableBypass está establecido en True y el valor de EnableReferSupport es False, las llamadas de omisión que se transfieran a continuación pasarán a ser de no omisión. Valor predeterminado: True |
EnableSessionTimer |
Opcional |
Booleano |
Especifica si está habilitado el temporizador de la sesión. Los temporizadores de sesión se usan para determinar si una sesión determinada continúa activa. Tenga en cuenta que aun cuando este parámetro esté establecido en False, pueden aplicarse temporizadores de sesión si la conexión remota tiene el temporizador de sesión habilitado. En tal caso, el servidor de mediación responderá a las pruebas del temporizador de sesión desde la entidad remota. Valor predeterminado: False |
EnableSignalBoost |
Opcional |
Booleano |
Cuando este parámetro está establecido en True, la puerta de enlace PSTN, el sistema IP-PBX o el controlador SBC del proveedor de servicios incrementarán el volumen de audio en las secuencias de voz que se envían a los clientes de servidor de mediación o de Microsoft Lync Server 2010. Si este valor se establece en False, el audio también incrementará en el servidor de mediación (para llamadas que no son de omisión) o en los clientes Lync Server 2010 (para llamadas de omisión). Valor predeterminado: False |
MaxEarlyDialogs |
Opcional |
Int64 |
El número máximo de respuestas bifurcadas que una puerta de enlace RTC, un sistema IP-PBX o el SBC del proveedor de servicios puede recibir para una invitación (Invite) enviada al servidor de mediación. Valor predeterminado: 20 |
OutboundTranslationRulesList |
Opcional |
Modificador de lista PS |
Una recopilación de reglas de conversión de números de teléfono que se aplican a las llamadas administradas por el enrutamiento saliente (llamadas enrutadas a destinos PBX o RTC). A pesar de que la lista y las reglas pueden crearse directamente con este cmdlet, se recomienda crear las reglas de conversión saliente con el cmdlet New-CsOutboundTranslationRule, que crea la regla y la asigna a la configuración troncal que tenga el mismo ámbito. |
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 los paquetes RTCP se envían desde la puerta de enlace RTC, el sistema IP-PBX o el controlador SBC al proveedor de servicios para llamadas activas. En este contexto, una llamada activa es una llamada en la que se permite el flujo de medios como mínimo en una dirección. Si RTCPActiveCalls se establece en True, el cliente de servidor de mediación o Lync Server puede finalizar una llamada si no recibe paquetes RTCP durante un periodo superior a los 30 segundos. Tenga en cuenta que, si se deshabilitan las comprobaciones para los medios RTCP recibidos para las llamadas activas en los elementos de Lync Server, se quita una medida de seguridad importante para detectar si se ha descartado un dispositivo del mismo tipo; por consiguiente, solo deben deshabilitarse si es necesario. Valor predeterminado: True |
RTCPCallsOnHold |
Opcional |
Booleano |
Este parámetro determina si los paquetes RTCP siguen enviándose a través del tronco para llamadas que han estado retenidas y no se espera que fluyan paquetes de medios en ninguna dirección. Si Música en espera está habilitado en el tronco o el cliente de Lync Server, se considerará que la llamada está activa y esta propiedad se omitirá. En estas circunstancias, debe usarse el parámetro RTCPActiveCalls. Tenga en cuenta que, si se deshabilitan las comprobaciones para los medios RTCP recibidos para las llamadas activas en los elementos de Lync Server, se quita una medida de seguridad importante para detectar si se ha descartado un dispositivo del mismo tipo; por consiguiente, solo deben deshabilitarse si es necesario. Valor predeterminado: True |
SipResponseCodeTranslationRulesList |
Opcional |
Modificador de lista PS |
Una lista de reglas de conversión de códigos de respuesta SIP que se aplican a los códigos de respuesta recibidos de una puerta de enlace PSTN, un sistema IP-PBX o un controlador SBC en el proveedor de servicios. Estas reglas permiten al administrador asignar códigos de respuesta SIP con valores entre 400 y 699 recibidos a través de un tronco a nuevos valores más coherentes con Lync Server. Esta lista y las reglas correspondientes pueden crearse directamente con este cmdlet. No obstante, se recomienda crear las reglas de conversión de códigos de respuesta SIP llamando al cmdlet New-CsSipResponseCodeTranslationRule. Dicho cmdlet creará la regla y la asignará a la configuración troncal con el ámbito correspondiente. |
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 PSTN, el sistema IP-PBX o el controlador SBC en el proveedor de servicios. En los casos de omisión 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 cmdlets New-CsMediaConfiguration y Set-CsMediaConfiguration. Valores válidos: - Required: debe usarse el cifrado SRTP. - Optional: se usará el cifrado SRTP si la puerta de enlace lo admite. - NotSupported: el cifrado SRTP no está admitido y, por tanto, no se usará. Nota: SRTPMode solo se utiliza si la puerta de enlace está configurada para usar TLS (Seguridad de la capa de transporte). Si la puerta de enlace está configurada con TCP (Protocolo de control de transmisión) como transporte, SRTPMode se establece internamente en NotSupported. Valor predeterminado: Requerido |
Force |
Opcional |
Parámetro modificador |
Suprime los mensajes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios. |
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. |
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.
Tipos de valores devueltos
Crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
New-CsTrunkConfiguration -Identity site:Redmond
En este ejemplo se crea una configuración troncal con el valor de Identity site:Redmond. Las propiedades restantes de esta nueva configuración se rellenarán con los valores predeterminados.
-------------------------- Ejemplo 2 ------------------------
New-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
En este ejemplo se crea una configuración troncal con el valor de Identity site:Redmond y se habilita la omisión de medios. La omisión de medios se habilita asignando el valor $True al parámetro EnableBypass. Las propiedades restantes de esta nueva configuración se rellenarán con los valores predeterminados.
-------------------------- Ejemplo 3 ------------------------
New-CsTrunkConfiguration -Identity site:Redmond
New-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Pattern '^\+(\d{8})$' -Translation '9$1'
En este ejemplo se crea una configuración troncal con el valor de Identity site:Redmond y, a continuación, se asigna una nueva conversión saliente al tronco. En la primera línea del ejemplo se llama a New-CsTrunkConfiguration para crear la configuración troncal con los valores predeterminados. En la segunda línea se llama al cmdlet New-CsOutboundTranslationRule. Preste atención al valor asignado a la identidad: site:Redmond/OTR1. La primera parte de la identidad (site:Redmond) define el ámbito en que se aplica la regla. Dicho ámbito coincide con el valor de Identity de la nueva configuración troncal, lo que significa que esta regla se aplicará automáticamente a la configuración. El ámbito va seguido de una barra diagonal (/) y una cadena de caracteres, que simplemente es el nombre único de la regla (puede haber más de una regla por ámbito). Después de esto, se envían los valores a los parámetros Pattern y Translation para definir la regla.