Compartir a través de

  • Artículo

New-CsVoiceRegex

 

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

Crea un modelo de expresión regular y de traducción para convertir los números de teléfono en distintos formatos.

Sintaxis

New-CsVoiceRegex -AtLeastLength <Int32> [-DigitsToPrepend <String>] [-DigitsToStrip <Int32>] [-StartsWith <String>]

New-CsVoiceRegex -ExactLength <Int32> [-DigitsToPrepend <String>] [-DigitsToStrip <Int32>] [-StartsWith <String>]

Descripción detallada

Las expresiones regulares se usan para asociar modelos de caracteres. Microsoft Lync Server 2010 usa expresiones regulares para convertir números de teléfono en diversos formatos, incluidos los números marcados, E.164, una central de conmutación (PBX) y una red telefónica conmutada (RTC). Hasta que conozca la sintaxis y las reglas de formato para trabajar con expresiones regulares, puede resultarle complicado definir estas reglas de conversión. El cmdlet New-CsVoiceRegex proporciona parámetros que permiten especificar determinados criterios y luego genera la expresión regular por usted.

Use este cmdlet como ayuda para generar expresiones regulares que se deban usar como valores de modelo y de conversión para reglas de normalización (New-CsVoiceNormalizationRule) y reglas de conversión de salida (New-CsOutboundTranslationRule), y valores NumberPattern para rutas de voz (New-CsVoiceRoute).

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsVoiceRegex de forma local: 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 "New-CsVoiceRegex"}

Parámetros

Parámetro Requerido Tipo Descripción

AtLeastLength

Requerido

Int32

Longitud mínima necesaria para que la cadena de caracteres (número de teléfono) coincida con la expresión. Por ejemplo, si define una regla de normalización que sólo afecta a los números con una longitud mínima de 7 dígitos (o caracteres), especifique un valor de 7 para este parámetro.

Debe escribir un valor para este parámetro o para el parámetro ExactLength. No puede escribir los valores de ambos.

ExactLength

Requerido

Int32

Longitud que debe tener la cadena de caracteres (número de teléfono) para coincidir con la expresión regular. Por ejemplo, si desea que una regla de normalización sólo afecte a números de 10 dígitos, especifique el valor 10 para este parámetro.

Debe escribir un valor para este parámetro o para el parámetro AtLeastLength. No puede escribir los valores de ambos.

DigitsToPrepend

Opcional

Cadena de caracteres

Cadena que especifica los caracteres o los números que se deben agregar al comienzo del número de teléfono. El valor introducido para este parámetro influye en la regla de conversión, ya que antepone caracteres al número de acuerdo con el patrón de expresión regular. Por ejemplo, si el número que sigue el patrón es 5551212 y el valor DigitsToPrepend es 425, el número convertido será 4255551212 (suponiendo que no se hayan aplicado otras conversiones).

DigitsToStrip

Opcional

Int32

Número de caracteres que se debe recortar al principio de la secuencia de caracteres (número de teléfono). Por ejemplo, si se escribe el número 2065551212 y DigitsToStrip es 3, el número se convertirá en 5551212

StartsWith

Opcional

Cadena de caracteres

Primer carácter de la cadena de caracteres (número de teléfono). La cadena de caracteres no coincidirá con la expresión regular a menos que empiece por la cadena de caracteres especificada en el parámetro StartsWith. Por ejemplo, si se especifica un valor de "+1" para StartsWith, sólo los números que empiecen por +1 coincidirán con este patrón y se traducirán. Tenga en cuenta que el número de caracteres de la cadena StartsWith se incluirá en los totales ExactLength y AtLeastLenght. Por ejemplo, si ha especificado 10 para ExactLength y una cadena StartsWith de +1, un número de teléfono de acuerdo con este modelo tendría 8 caracteres de longitud, precedidos de +1, lo cual daría un total de 10 dígitos.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Crea un objeto del tipo Microsoft.Rtc.Management.Voice.OcsVoiceRegex.

Ejemplo

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

$regex = New-CsVoiceRegex -ExactLength 7 -DigitsToStrip 3

En este ejemplo se crean un nuevo modelo de expresión regular y una traducción. Esta expresión incluye un modelo que debe tener exactamente 7 caracteres (-ExactLength 7) y quitará los tres primeros dígitos del número correspondiente (-DigitsToStrip 3). El modelo creado mediante esta expresión regular será ^\d{3}(\d{4})$, mientras que la traducción será $1. Por ejemplo, el número 5551212 coincidiría con este modelo y la traducción resultante sería 1212: el número de 7 dígitos del que se han cortado los 3 primeros dígitos.

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

$regex = New-CsVoiceRegex -AtLeastLength 7 -StartsWith "1"
New-CsVoiceNormalizationRule "global/internal rule" -Pattern $regex.Pattern -Translation $regex.Translation

En este ejemplo se crea también un nuevo modelo de expresión regular y una traducción, pero el ejemplo va más allá y utiliza luego estos valores para crear una nueva regla de normalización de voz. En la primera línea se llama a New-CsVoiceRegEx para crear una expresión regular en la que el número coincidente debe tener un mínimo de 7 caracteres (-AtLeastLength 7) y debe empezar por 1 (-StartsWith "1"). Los resultados de este comando se asignan a la variable $regex.

En la segunda línea se llama al cmdlet New-CsVoiceNormalizationRule. Se asigna un nombre único a la nueva regla, en este caso, global/internal rule. Luego se asigna como modelo para la regla de normalización el modelo creado al llamar a New-CsVoiceRegex: -Pattern $regex.Pattern. Se hace lo mismo con la traducción y se asigna la traducción creada al llamar a New-CsVoiceRegex: -Translation $regex.Translation.

Nota: El modelo creado en este ejemplo es ^(1\d{5}\d+)$. Se puede descifrar como un número que empieza por 1 (1), seguido de cinco dígitos (\d{5}), seguido de un número indeterminado de dígitos (\d+). El resultado es un número de 7 dígitos como mínimo (1 más 5 más 1 ó más) que empieza por 1, justo lo que se pretendía.