Compartir a través de

  • Artículo

Set-CsOutboundTranslationRule

 

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

Modifica una regla de conversión saliente. Las reglas de conversión salientes convierten los números de teléfono al formato de marcado local para la interacción con sistemas de central de conmutación (PBX).

Sintaxis

Set-CsOutboundTranslationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Set-CsOutboundTranslationRule [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Microsoft Lync Server 2010 normaliza los números de teléfono según el formato E.164. No obstante, muchos sistemas PBX no pueden trabajar con este formato. Las reglas de conversión salientes convierten el número al formato de marcado local antes de enviar el número al servidor de mediación o a la puerta de enlace. Llame a este cmdlet para modificar una regla de conversión de salida existente.

Cada regla de traducción saliente está asociada con una configuración troncal. Esto significa que al usar este cmdlet para modificar una regla, la configuración troncal correspondiente se verá afectada. Es posible asociar más de una regla de traducción saliente con cada configuración. Por tanto, la identidad (Identity) de cada regla está formada por un ámbito y un nombre que es único en dicho ámbito (con el formato ámbito/nombre, como site:Redmond/OBR1). La regla se asocia automáticamente con la configuración troncal con el mismo ámbito. Llamar a Set-CsOutboundTranslationRule es el método recomendado para cambiar las reglas de conversión salientes de una configuración troncal.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsOutboundTranslationRule 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 "Set-CsOutboundTranslationRule"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

El identificador único de la regla de conversión saliente que se quiere modificar. La identidad (Identity) está formada por el ámbito seguido de un nombre único dentro de cada ámbito. Por ejemplo, site:Redmond/OutboundRule1.

Instance

Opcional

TranslationRule

Una referencia de objeto a una regla de conversión saliente. Este objeto debe ser de tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule y puede recuperarse llamando a Get-CsOutboundTranslationRule.

Description

Opcional

Cadena de caracteres

Una descripción detallada de la regla de conversión saliente. Esta descripción puede usarse para ayudar a los administradores a identificar claramente el propósito de la regla.

Pattern

Opcional

Cadena de caracteres

Una expresión regular que representa el patrón numérico al que se aplicará la conversión.

Priority

Opcional

Int32

Si un número coincide con el patrón de más de una regla de conversión saliente, las reglas se aplicarán por orden de prioridad. Use este parámetro para asignar una prioridad a la regla.

Translation

Opcional

Cadena de caracteres

Una expresión regular que se aplicará al número que coincida con el patrón para preparar dicho número para el enrutamiento saliente.

Force

Opcional

Parámetro modificador

Suprime los mensajes de confirmación que, de lo contrario, se mostrarí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.TranslationRule. Acepta datos transferidos de objetos de reglas de conversión de salida.

Tipos de valores devueltos

Este cmdlet no devuelve un valor. Modifica un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule.

Ejemplo

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

Set-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond" -Description "Convert to seven digits" -Pattern '^\+1425(\d{7})$' -Translation '$1'

Este ejemplo modifica la regla de conversión saliente global con el valor de Identity site:Redmond/Prefix Redmond. Hemos incluido una descripción donde se explica que esta regla sirve para convertir números del formato E.164 a un número de teléfono de siete dígitos. Asimismo, hemos especificado los valores de Pattern y Translation, que modificarán los valores existentes de estas propiedades. Estos valores convierten un número en formato E.164 (en este caso 12 dígitos que empiezan por +1425), especificado por la expresión regular del parámetro Pattern, a un número de siete dígitos quitando los cinco primeros dígitos. Por ejemplo, el número +14255551212 se convertiría al número 5551212.

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

$a = Get-CsOutboundTranslationRule -Identity "site:Redmond/OBR1"
$a.Name = "Outbound Rule 1"
Set-CsOutboundTranslationRule -Instance $a

En este ejemplo se modifica la propiedad Name de una regla de conversión saliente. Tenga en cuenta que como resultado se cambia el valor de Identity de esta regla. El primer comando de este ejemplo es una llamada al cmdlet Get-CsOutboundTranslationRule. Se especifica el valor de Identity site:Redmond\OBR1, que devolverá una regla de conversión, la regla con el valor de Identity proporcionado. En lugar de mostrar la regla, se asigna a la variable $a. En la línea 2 del ejemplo se asigna la cadena de caracteres "Outbound Rule 1" a la propiedad Name de la variable $a, que contiene una referencia a la regla site:Redmond/OBR1. En la última línea del ejemplo, se llama a Set-CsOutboundTranslationRule, para ello, se especifica el parámetro Instance y se envía a la variable $a. Si se llama a Get-CsOutboundTranslationRule con un valor de Identity de site:Redmond/OBR1, no se devolverá nada. Esto se debe a que la regla con esta identidad ya no existe porque se ha reemplazado por la misma regla pero con el valor de Identity site:Redmond/Outbound Rule 1.