Test-CsVoiceRoute
Última modificación del tema: 2012-03-26
Prueba un número de teléfono en comparación con un patrón de número de ruta de voz y devuelve un valor Boolean (verdadero/falso), que indica si el número suministrado coincide con el patrón de número para la ruta. El patrón de número es solamente una de las propiedades usadas por rutas de voz para indicarle a Microsoft Lync Server 2010 cómo enrutar las llamadas de usuarios de Enterprise Voice a números de teléfono de la red telefónica conmutada (RTC) o de una central de conmutación (PBX).
Sintaxis
Test-CsVoiceRoute -Route <Route> -TargetNumber <PhoneNumber> [-Force <SwitchParameter>]
Descripción detallada
Una ruta de voz incluye una expresión regular que identifica qué números de teléfono se enrutarán a través de una ruta de voz determinada: los números de teléfono que coincidan con la expresión regular se enrutarán a través de esta ruta. Este cmdlet comprueba si un número de teléfono determinado se enrutará o no a través de una ruta de voz especificada según el patrón de número de la ruta (la propiedad NumberPattern). Puede usar este cmdlet para solucionar problemas de enrutamiento o para simplemente probar números de teléfono con rutas específicas, a fin de asegurarse de que los resultados sean lo que esperaba.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Test-CsVoiceRoute localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsVoiceRoute"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Route |
Requerido |
Ruta |
Un objeto que contiene una referencia a una ruta de voz con la que quiere probar el número especificado en el parámetro TargetNumber. Puede recuperar objetos de rutas de voz disponibles mediante el llamado del cmdlet Get-CsVoiceRoute. Tipo de datos completo: Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route |
TargetNumber |
Requerido |
Número de teléfono |
El número de teléfono con el que quiera probar la ruta de voz especificada en el parámetro Route. Este número debe tener un formato E.164 (como +14255551212). Tipo de datos completo: Microsoft.Rtc.Management.Voice.PhoneNumber |
Force |
Opcional |
Parámetro modificador |
Suprime cualquier aviso de confirmación o mensaje de error leve que se pueda producir al ejecutar el cmdlet. |
Tipos de entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route. Acepta entradas canalizadas de objetos de ruta de voz.
Tipos de valores devueltos
Devuelve un objeto tipo Microsoft.Rtc.Management.Voice.VoiceRouteTestResult.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
$vr = Get-CsVoiceRoute -Identity testroute
Test-CsVoiceRoute -TargetNumber "+14255551212" -Route $vr
Este comando determina si un número determinado coincide con el patrón para la ruta especificada. Primero usamos el cmdlet Get-CsVoiceRoute para recuperar la ruta de prueba de la ruta de voz. Usamos esa ruta como el valor para el parámetro Route del cmdlet Test-CsVoiceRoute. También incluimos el número que deseamos probar en el parámetro TargetNumber. El resultado es un valor Boolean que establece si el número de destino coincide con el patrón para esa ruta.
-------------------------- Ejemplo 2 --------------------------
Get-CsVoiceRoute -Identity testroute | Test-CsVoiceRoute -TargetNumber "+14255551212"
El Ejemplo 2 realiza la misma acción que el Ejemplo 1. Sin embargo, en este ejemplo, la acción se realiza en un único comando. Primero llamamos al cmdlet Get-CsVoiceRoute para recuperar la ruta de voz con la ruta de prueba Identity. Redireccionamos esa ruta de voz al cmdlet Test-CsVoiceRoute y probamos la ruta con el número suministrado en el parámetro TargetNumber. Tenga en cuenta que no es necesario brindar el parámetro Route porque la ruta se redireccionó al cmdlet.
-------------------------- Ejemplo 3 --------------------------
Get-CsVoiceRoute | Test-CsVoiceRoute -TargetNumber "+14255551212"
Este ejemplo recupera una recopilación de todas las rutas de voz definidas dentro de una implementación de Lync Server 2010 y prueba los patrones de número de cada ruta con el valor TargetNumber que se brinda en el llamado al cmdlet Test-CsVoiceRoute. El resultado será un valor True o False para cada ruta probada.
-------------------------- Ejemplo 4 --------------------------
$z = Get-CsVoiceRoute
foreach ($x in $z){$x.Identity; Test-CsVoiceRoute -TargetNumber "+14255551212" -Route $x}
Este ejemplo es similar al Ejemplo 3, en el hecho de que recupera los resultados de una prueba de ruta de voz con varias rutas. Sin embargo, el resultado del Ejemplo 3 simplemente será una lista de valores True/False, sin una indicación clara de a qué ruta se aplican los resultados de la prueba. Este ejemplo resuelve ese problema. (Se puede hacer algo para que el resultado sea mejor, pero este ejemplo breve, al menos, logra cumplir la tarea).
Comenzamos con el llamado de Get-CsVoiceRoute para recuperar todas las rutas de voz y asignar la recopilación a la variable $z. En la siguiente línea, iniciamos un bucle para cada uno. Este bucle tomará a cada integrante de la recopilación a la vez y lo asignará a la variable $x. Lo primero que hacemos con $x, que contiene una referencia a una única ruta de voz es mostrar la identidad de esa ruta: $x.Identity. La siguiente parte del comando es un llamado a Test-CsVoiceRoute, donde se prueba la ruta $x en función del número de destino. El resultado final será una lista (sin un formato muy aceptable) de identidades de ruta de voz seguidas de un indicador de verdadero/falso, que señala si el número de destino coincidió con el patrón de número en la ruta con esa identidad.