Compartir a través de

  • Artículo

Test-CsDialPlan

 

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

Prueba un número de teléfono con un plan de marcado (antes denominado perfil de ubicación) y devuelve la regla de normalización que se aplicará al número, así como el número traducido después de haber aplicado la regla de normalización.

Sintaxis

Test-CsDialPlan -DialedNumber <PhoneNumber> -Dialplan <LocationProfile>

Descripción detallada

Este cmdlet permite ver los resultados de la aplicación de un plan de marcado a un determinado número de teléfono. Los planes de marcado proporcionan información, como la forma en que se aplican las reglas de normalización, necesaria para habilitar las llamadas telefónicas para los usuarios de Enterprise Voice. Después de especificar un número de marcado y un plan de marcado, el cmdlet verificará qué regla de normalización del plan de marcado se aplicará y cuál será el número traducido.

Puede usar este cmdlet para solucionar problemas con las traducciones de números o para verificar la aplicación de las reglas con determinados números.

Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Test-CsDialPlan localmente los miembros de los siguientes grupos: 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 de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

DialedNumber

Requerido

Número de teléfono

El número de teléfono con el que quiera probar el plan de marcado especificado en el parámetro Dialplan.

Tipo de datos completo: Microsoft.Rtc.Management.Voice.PhoneNumber

Dialplan

Requerido

LocationProfile

Un objeto que contiene una referencia a un plan de marcado con el que quiere probar el número especificado en el parámetro DialedNumber.

Tipo de datos completo: Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile. Acepta la entrada por canalización de objetos de planes de marcado.

Tipos de valores devueltos

Devuelve un objeto de tipo Microsoft.Rtc.Management.Voice.LocationProfileTestResult.

Ejemplo

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

Get-CsDialPlan -Identity site:Redmond | Test-CsDialPlan -DialedNumber 14255559999 | Format-List

En este ejemplo se realiza una prueba con el plan de marcado con el valor de Identity site:Redmond. En primer lugar se ejecuta el cmdlet Get-CsDialPlan para recuperar el plan de marcado con el valor de Identity site:Redmond. A continuación, el objeto de plan de marcado se transfiere al cmdlet Test-CsDialPlan, donde el plan de marcado se prueba con el número de teléfono 14255559999. El resultado será DialedNumber, después de la aplicación de una regla de normalización de voz con un patrón de coincidencia. Si hay más de una regla de normalización con un patrón de coincidencia en el sitio, se aplicará la regla que presente el valor de Priority más bajo. Si no hay ninguna regla con patrones que coincidan con el valor de DialedNumber (por ejemplo, si la regla de normalización coincide con el patrón por un número de 11 dígitos y usted proporciona un número de 7 dígitos), no se devolverá ningún valor.

El resultado de este comando incluye un número de teléfono y una regla de normalización. La regla de normalización tiene varias propiedades y, de forma predeterminada, el resultado quedará cortado por puntos suspensivos (...). Para ver todas las propiedades y los valores de la regla de normalización de voz devuelta, el resultado se transfiere al cmdlet Format-List antes de mostrarlo en la pantalla. El número de teléfono y la regla de normalización se mostrarán en líneas separadas, y las propiedades y los valores de la regla de normalización se ajustarán para que quepan en la pantalla.

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

$a = Get-CsDialPlan -Identity site:Redmond
Test-CsDialPlan -DialedNumber 14255559999 -Dialplan $a | Format-List

El Ejemplo 2 es idéntico al Ejemplo 1 con una diferencia: en lugar de transferir los resultados de la operación Get directamente al cmdlet Test-CsDialPlan, el objeto se almacena primero en la variable $a y después se transfiere como el valor al parámetro Dialplan para usarlo como el plan de marcado de la prueba.

Como en el Ejemplo 1, este comando se finaliza transfiriendo el resultado a Format-List para poder ver más información sobre la regla de normalización de voz que aparece de forma predeterminada.

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

Get-CsDialPlan | Test-CsDialPlan -DialedNumber 2065559999 | Format-Table -Wrap

En este ejemplo se realiza una prueba de plan de marcado con todos los planes de marcado definidos en la instalación de Microsoft Lync Server 2010. Primero se ejecuta el cmdlet Get-CsDialPlan (sin parámetros) para recuperar todos los planes de marcado. A continuación, la colección de planes de marcado devuelta se transfiere al cmdlet Test-CsDialPlan, donde se prueban todos los planes de marcado de la colección con el número de teléfono 2065559999. El resultado será una lista de números traducidos junto con la regla de normalización de voz aplicada, una para cada plan de marcado de la colección. Si no se aplica ninguna regla de normalización de voz en un plan de marcado al valor de DialedNumber para un determinado plan de marcado (por ejemplo, si la regla de normalización coincide con el patrón por un número de 11 dígitos y usted proporciona un número de 7 dígitos), habrá una línea en blanco en la lista de dicho plan de marcado.

De forma predeterminada, el resultado corta la visualización completa de la regla de normalización de voz aplicada. En los Ejemplos 1 y 2 podíamos ver el resultado completo transfiriendo los resultados de la prueba al cmdlet Format-List. En este ejemplo se transfiere el resultado a Format-Table y se incluye el parámetro Wrap. De este forma, se muestran todas las entradas en formato de tabla (una columna para el número traducido y otra para la regla de normalización de voz aplicada), pero se ajusta el resultado, de modo que la regla de normalización se ajustará a la columna.