New-CsOutboundTranslationRule
Última modificación del tema: 2012-03-26
Crea una regla de traducción de salida. Una regla de traducción de salida convierte números de teléfono en el formato de marcado local para la interacción con sistemas de centrales de conmutación (PBX).
Sintaxis
New-CsOutboundTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
New-CsOutboundTranslationRule -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Llame a este cmdlet para crear una regla de traducción de salida. Microsoft Lync Server 2010 normaliza los números de teléfono según el formato E.164. Sin embargo, muchos sistemas de centrales de conmutación (PBX) no trabajan 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.
Cada regla de traducción de salida está asociada a la configuración de un tronco. Se puede asociar más de una regla de traducción de salida a cada configuración. Por lo tanto, la Identidad de cada regla consta de un ámbito y un nombre único dentro del ámbito (con formato ámbito/nombre, por ejemplo: site:Redmond/OBR1). La regla se asocia automáticamente a la configuración del tronco que tiene el mismo ámbito. Si llama a New-CsOutboundTranslationRule y especifica un ámbito en el que no se ha definido aún una configuración del tronco, la configuración del tronco se creará con el ámbito especificado, la regla de traducción de salida y los valores predeterminados.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsOutboundTranslationRule 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 "New-CsOutboundTranslationRule"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único de la regla de traducción de salida. La Identity incluye el ámbito en que se debe aplicar la regla y el nombre de la regla y debe ser en el ámbito global, de sitio o del servicio (solo PSTNGateway). Por ejemplo, site:Redmond/OutboundRule1 and PstnGateway:Redmond.litwareinc.com/OutboundRule2. Si el parámetro Identity se especifica, no puede especificar valores para los parámetros Name o Parent. |
Parent |
Requerido |
Cadena de caracteres |
El ámbito de la regla de traducción de salida. Si se especifica un valor para este parámetro, también deberá especificarse un valor para el parámetro Name. Sin embargo, el parámetro Identity no se puede especificar. Si no se especifican los parámetros Parent y Name, el parámetro Identity deberá especificarse. |
Name |
Requerido |
Cadena de caracteres |
El nombre de la regla de traducción de salida. Si no se proporciona el parámetro Name, deberá especificarse una identidad que contenga un ámbito y un nombre. Si se proporciona el parámetro Name, el parámetro Parent también será obligatorio, pero no se puede especificar un parámetro Identity. |
Description |
Opcional |
Cadena de caracteres |
Descripción de la regla de traducción de salida. Esta descripción le ayudará a identificar el propósito de la regla. |
Pattern |
Opcional |
Cadena de caracteres |
Expresión regular que representa el patrón del número al que se aplicará el parámetro Translation. Valor predeterminado: ^\+(\d*)$ |
Priority |
Opcional |
Int32 |
Si un número coincide con el parámetro Pattern de varias reglas de traducción de salida, 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 |
Expresión regular que se aplicará al número que coincida con Pattern para preparar este número para el enrutamiento saliente. Valor predeterminado: $1 |
Force |
Opcional |
Parámetro modificador |
Suprime las preguntas de confirmación que aparecerí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
Este cmdlet crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"
En este ejemplo se crea una regla de traducción de salida para el sitio Redmond denominado Prefix Redmond. Como no se han especificado más parámetros, la regla se crea con los valores predeterminados. Tenga en cuenta que el valor enviado al parámetro -Identity está delimitado entre comillas dobles, porque el nombre de la regla (Prefix Redmond) contiene un espacio. Si el nombre de la regla no contiene ningún espacio, no es necesario delimitar el parámetro Identity entre comillas dobles.
-------------------------- Ejemplo 2 --------------------------
New-CsOutboundTranslationRule -Parent global -Name SeattleSevenDigit -Description "Convert to seven digits" -Pattern '^\+1425(\d{7})$' -Translation '$1'
En este ejemplo se crea una nueva regla de traducción de salida global con el nombre SeattleSevenDigit. (Nota: en lugar de especificar un valor para los parámetros Parent y Name, podríamos haber creado la misma regla especificando -Identity global/SeattleSevenDigit). Se ha incluido una descripción para explicar que esta regla tiene como objetivo traducir números con formato E.164 en números con formato de siete dígitos. Además, se han especificado los valores de Pattern y Translation. Estos valores traducen un número con formato E.164 (en este caso 12 dígitos empezando con +1425), especificado por la expresión regular en el parámetro Pattern, a un número de siete dígitos, eliminando los cinco primeros dígitos. Por ejemplo, el número +14255551212 se convierte en el número 5551212.
Vea también
Otros recursos
Remove-CsOutboundTranslationRule
Set-CsOutboundTranslationRule
Get-CsOutboundTranslationRule