Test-CsVoiceTestConfiguration
Última modificación del tema: 2012-03-26
Ejecuta configuraciones de voz de prueba para garantizar que el enrutamiento y las directivas de voces funcionan correctamente.
Sintaxis
Test-CsVoiceTestConfiguration -TestCaseInputObject <TestConfiguration> [-Dialplan <LocationProfile>] [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>] [-VoicePolicy <VoicePolicy>]
Test-CsVoiceTestConfiguration -DialedNumber <PhoneNumber> -Dialplan <LocationProfile> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]
Descripción detallada
Antes de implementar rutas y directivas de voz, es recomendable probarlas en varios números de teléfono para garantizar los resultados esperados. Al ejecutar este cmdlet con la configuración de los parámetros correspondiente, se realizan estas pruebas.
Este cmdlet prueba un número de teléfono con la ruta de voz, el uso, el plan de marcado y la directiva de voz para habilitarlo para verificar los resultados deseados o comparar el resultado real con el esperado. Las opciones de configuración de voz que se comprobarán pueden definirse al escribir los parámetros apropiados individualmente o con el cmdlet New-CsVoiceTestConfiguration.
Si escribe valores para DialedNumber, DialPlan y VoicePolicy, el resultado comprenderá el número convertido, la regla de normalización usada para crear la conversión, la ruta usada y el uso de RTC. Si en cambio escribe un valor para el parámetro TestCaseInputObject, podrá además recuperar el estado cuando los resultados coincidan con los resultados esperados que suministró al objeto de la prueba cuando la creó con el cmdlet New-CsVoiceTestConfiguration.
Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Test-CsVoiceTestConfiguration en forma local: 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-CsVoiceTestConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
DialedNumber |
Requerido |
Número de teléfono |
El número de teléfono para realizar la prueba. Basándose en el plan de marcado, la ruta y la directiva, este número se normalizará y se mostrará como resultado. Este parámetro es obligatorio a no ser que la opción TestCaseInputObject incluya un valor. No es posible especificar los valores DialedNumber y TestCaseInputObject. (TestCaseInputObject ya contiene un valor DialedNumber en el objeto.) |
Dialplan |
Requerido |
LocationProfile |
Referencia a un objeto de plan de marcado del plan que se usará al ejecutar la prueba. Los objetos de plan de marcado pueden recuperarse llamando al cmdlet Get-CsDialPlan. Este parámetro es obligatorio si se ha especificado también DialedNumber. No use este parámetro si está usando TestCaseInputObject. Si lo hace, el objeto de este parámetro debe coincidir con el plan de marcado especificado en TestCaseInputObject, lo que hace que el uso del parámetro resulte redundante. |
TestCaseInputObject |
Requerido |
TestConfiguration |
Objeto que contiene una referencia a la configuración de voz que se probará. La referencia de este objeto puede recuperarse llamando al cmdlet Get-CsVoiceTestConfiguration. Si se llama al cmdlet con este parámetro, no puede especificarse el valor DialedNumber. Tampoco debe especificar los valores Dialplan y VoicePolicy, ya están especificados en los valores del objeto de configuración de prueba de voz. |
VoicePolicy |
Requerido |
VoicePolicy |
Referencia a un objeto de directiva de voz de la directiva que se usará al ejecutar la prueba. Los objetos de directiva de voz pueden recuperarse llamando al cmdlet Get-CsVoicePolicy. Este parámetro es obligatorio si se ha especificado también DialedNumber. No use este parámetro si está usando TestCaseInputObject. Si lo hace, el objeto de este parámetro debe coincidir con la directiva de voz especificada en TestCaseInputObject, lo que hace que el uso del parámetro resulte redundante. |
RouteSettings |
Opcional |
PstnRoutingSettings |
Referencia a un objeto que contiene todas las rutas de voz disponibles en la instalación de Microsoft Lync Server 2010. Puede recuperar este objeto llamando al cmdlet Get-CsRoutingConfiguration. Puede usar este parámetro con DialedNumber o TestCaseInputObject. |
Force |
Opcional |
Parámetro modificador |
Suprime las solicitudes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios. |
Tipos de entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration. Acepta entradas canalizadas de un objeto de configuración de prueba de voz.
Tipos de valores devueltos
Este cmdlet devuelve un objeto de tipo Microsoft.Rtc.Management.Voice.OcsVoiceTestResult.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsVoiceTestConfiguration -Identity TestConfig1 | Test-CsVoiceTestConfiguration
En este ejemplo, se ejecuta una prueba de configuración de voz con la configuración TestConfig1. En primer lugar se ejecuta el cmdlet Get-CsVoiceTestConfiguration para recuperar la configuración con la prueba Identity TestConfig1. El objeto de configuración se transfiere al cmdlet Test-CsVoiceTestConfiguration.
-------------------------- Ejemplo 2 --------------------------
$a = Get-CsVoiceTestConfiguration -Identity TestConfig1
Test-CsVoiceTestConfiguration -TestCaseInputObject $a
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, el objeto se almacena primero en la variable $a y después se transfiere como el valor al parámetro TestCaseInputObject para usarlo como la configuración de la prueba.
-------------------------- Ejemplo 3 --------------------------
$dp = Get-CsDialPlan -Identity Global
$vp = Get-CsVoicePolicy -Identity Global
Test-CsVoiceTestConfiguration -DialedNumber 4255551212 -Dialplan $dp -VoicePolicy $vp
En este ejemplo, se ejecuta una configuración de prueba sin tener que definirla primero con New-CsVoiceTestConfiguration. En lugar de enviar un objeto TestConfiguration creado antes de tiempo, en este ejemplo se muestra como configurar una prueba inmediatamente al especificar el número marcado a comprobar, el plan de marcado y la directiva de voz para realizar la prueba.
En la primera línea del ejemplo se llama al cmdlet Get-CsDialPlan para recuperar el plan de marcado Global. El objeto de plan de marcado recuperado se asigna a la variable $dp. En la segunda línea se repite la acción con la directiva de voz, llamando al cmdlet Get-CsVoicePolicy para recuperar la directiva de voz Global y después asignarla a la variable $vp.
Ya está todo listo para ejecutar la prueba. Se llama a Test-CsVoiceTestConfiguration, se envía el número de teléfono que comprobar al parámetro DialedNumber, el plan de marcado recuperado en la línea 1 (almacenado en $dp), al parámetro Dialplan y la directiva de voz recuperada en la línea 2 (almacenada en $vp), al parámetro VoicePolicy.
Tenga en cuenta que el resultado del Ejemplo 3 no incluirá el estado de los resultados esperados. Si desea probar los resultados con las expectativas, deberá definir esas expectativas al usar el cmdlet New-CsVoiceTestConfiguration y llamar a Test-CsVoiceTestConfiguration como se muestra en los Ejemplos 1 y 2.