Compartir a través de


Get-CsOutboundTranslationRule

 

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

Recupera una o varias reglas de traducción de salida. Una regla de conversión de salida convierte números de teléfono en el formato de marcación local para la interacción con sistemas de centrales de conmutación (PBX) y puertas de enlace de la red telefónica conmutada (RTC).

Sintaxis

Get-CsOutboundTranslationRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsOutboundTranslationRule [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Al llamar a este cmdlet se recupera una regla de conversión de salida existente. Microsoft Lync Server 2010 normaliza los números de teléfono en formato E.164. Sin embargo, muchos sistemas de centrales de conmutación (PBX) no trabajan con este formato. Las reglas de conversión de salida 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. Es posible asociar más de una regla de conversión de salida con cada configuración troncal. 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.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsOutboundTranslationRule de forma local: RTCUniversalUserAdmins, 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 (incluidos los roles RBAC personalizados que haya creado usted mismo), ejecute el siguiente comando desde el símbolo del sistema de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsOutboundTranslationRule"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único para la regla de traducción de salida que desea recuperar. La identidad (Identity) está formada por el ámbito seguido de un nombre único dentro de cada ámbito (por ejemplo, site:Redmond/OutboundRule1). La especificación de un valor para la Identidad devolverá, como máximo, una regla de traducción de salida.

Filter

Opcional

Cadena de caracteres

Realiza una búsqueda en Identidad que permite restringir los resultados para obtener solamente las reglas de traducción de salida cuyas identidades coincidan con la cadena de caracteres comodín especificada.

LocalStore

Opcional

Parámetro modificador

Recupera la regla de conversión de salida de la réplica local del Almacén de administración central, en lugar del propio Almacén de administración central.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Este cmdlet recupera uno o más objetos del tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule.

Ejemplo

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

Get-CsOutboundTranslationRule

En este ejemplo se recuperan todas las reglas de conversión de salida para la implementación de Lync Server 2010.

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

Get-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"

En este ejemplo se recupera una única regla de conversión de salida: la regla con la identidad site:Redmond/Prefix Redmond.

-------------------------- Ejemplo 3 --------------------------

Get-CsOutboundTranslationRule -Filter site:*

En este ejemplo se recuperan todas las reglas de traducción de salida de un sitio. El comando llama a Get-CsOutboundTranslationRule con un filtro de site:*, que devolverá una colección de todas las reglas con valores de identidad que comiencen con la cadena site:.