Compartir a través de

  • Artículo

Test-CsVoiceNormalizationRule

 

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

Comprueba un número de teléfono con una regla de normalización de voz y devuelve el número después de aplicar la regla. Las reglas de normalización de voz se usan para convertir un requisito de marcado telefónico (por ejemplo, debe marcar 9 para obtener acceso a una línea externa) al formato de número de teléfono E.164 que usa Microsoft Lync Server 2010.

Sintaxis

Test-CsVoiceNormalizationRule -DialedNumber <PhoneNumber> -NormalizationRule <NormalizationRule>

Descripción detallada

Este cmdlet permite ver los resultados de la aplicación de una regla de normalización de voz a un determinado número de teléfono. Estas reglas son un componente necesario de la autorización telefónica y el enrutamiento de llamadas. Definen los requisitos de conversión (o traducción) de números de un formato de uso común entre los usuarios a un formato estándar (E.164). Use este cmdlet para detectar problemas de marcado y verificar que las reglas funcionarán correctamente con números específicos.

Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Test-CsVoiceNormalizationRule: 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 "Test-CsVoiceNormalizationRule"}

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 la regla de normalización especificada en el parámetro NormalizationRule.

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

NormalizationRule

Requerido

NormalizationRule

Objeto que contiene una referencia a la regla de normalización con la que quiere probar el número especificado en el parámetro DialedNumber.

Puede recuperar reglas de normalización de voz mediante una llamada al cmdlet Get-CsVoiceNormalizationRule.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule. Acepta la entrada transferida de objetos de regla de normalización de voz.

Tipos de valores devueltos

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

Ejemplo

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

Get-CsVoiceNormalizationRule -Identity "global/11 digit number rule" | Test-CsVoiceNormalizationRule -DialedNumber 14255559999

Este ejemplo ejecuta una prueba de normalización de voz con la regla de normalización de voz cuyo valor Identity es "global/11 digit number rule". En primer lugar, se ejecuta el cmdlet Get-CsVoiceNormalizationRule para recuperar la regla con la identidad "global/11 digit number rule". El objeto de regla se transfiere al cmdlet Test-CsVoiceNormalizationRule, que prueba la regla con el número de teléfono 14255559999. El resultado será el valor DialedNumber después de aplicar la regla de normalización de voz "global/11 digit number rule". Si la regla no es aplicable al valor DialedNumber (por ejemplo, si la regla de normalización coincide con el patrón de un número de 11 dígitos y el usuario especifica un número de 7 dígitos), no se devolverá ningún valor.

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

$a = Get-CsVoiceNormalizationRule -Identity "global/11 digit number rule"
Test-CsVoiceNormalizationRule -DialedNumber 5551212 -NormalizationRule $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 del parámetro NormalizationRule para usarlo como la regla de normalización de voz para realizar la prueba.

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

Get-CsVoiceNormalizationRule | Test-CsVoiceNormalizationRule -DialedNumber 2065559999

Este ejemplo ejecuta una prueba de normalización de voz con todas las reglas de normalización de voz definidas en la implementación de Lync Server 2010. Primero se ejecuta el cmdlet Get-CsVoiceNormalizationRule (sin parámetros) para recuperar todas las reglas de normalización de voz. La colección de reglas devuelta se transfiere al cmdlet Test-CsVoiceNormalizationRule, que prueba cada regla de la colección con el número de teléfono 2065559999. El resultado será una lista de números traducidos, uno por cada regla probada. Si una regla no es aplicable al valor DialedNumber (por ejemplo, si la regla de normalización coincide con el patrón de un número de 11 dígitos y el usuario especifica un número de 7 dígitos), se mostrará una línea en blanco en la lista, correspondiente a dicha regla.