Partager via

  • Article

New-CsVoiceRegex

 

Dernière rubrique modifiée : 2012-03-26

Crée un modèle et une traduction d’expression régulière pour la traduction des numéros de téléphones en différents formats.

Syntaxe

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

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

Description détaillée

Les expressions régulières servent à faire correspondre des modèles de caractères. Microsoft Lync Server 2010 utilise des expressions régulières afin de convertir des numéros de téléphone depuis et vers divers formats (numéros composés, E.164, autocommutateur privé (PBX) local et réseau téléphonique commuté [RTC]). Nous vous conseillons d’apprendre les règles de syntaxe et de format de travail des expressions régulières afin de pouvoir définir correctement les règles de conversion. La cmdlet New-CsVoiceRegex fournit des paramètres permettant de spécifier certains critères, puis génère pour vous l’expression régulière.

Cette cmdlet vous aide à générer des expressions régulières qui seront utilisées comme valeurs Pattern et Translation pour les règles de normalisation (New-CsVoiceNormalizationRule) et les règles de traduction sortantes (New-CsOutboundTranslationRule), et comme valeurs NumberPattern pour les itinéraires de communications vocales (New-CsVoiceRoute).

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-CsVoiceRegex : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsVoiceRegex"}

Paramètres

Paramètre Obligatoire Type Description

AtLeastLength

Obligatoire

Int32

Longueur minimale obligatoire pour que la chaîne (numéro de téléphone) corresponde à l’expression. Par exemple, si vous définissez une règle de normalisation affectant seulement les numéros devant avoir 7 chiffres (ou caractères) au moins, spécifiez la valeur 7 pour ce paramètre.

Vous devez entrer une valeur pour ce paramètre ou pour le paramètre ExactLength. Vous ne pouvez pas entrer de valeur pour les deux.

ExactLength

Obligatoire

Int32

Longueur que la chaîne (numéro de téléphone) doit avoir pour correspondre à l’expression régulière. Par exemple, si vous souhaitez qu’une règle de normalisation affecte les numéros à 10 caractères seulement, spécifiez la valeur 10 pour ce paramètre.

Vous devez entrer une valeur pour ce paramètre ou pour le paramètre AtLeastLength. Vous ne pouvez pas entrer de valeur pour les deux.

DigitsToPrepend

Facultatif

Chaîne

Chaîne spécifiant les caractères ou nombres à ajouter au début du numéro de téléphone. La valeur entrée pour ce paramètre a une incidence sur la valeur Translation, en ce qu’elle ajoute des caractères au nombre correspondant au modèle d’expression régulière. Par exemple, si le nombre correspondant au modèle est 5551212 et que la valeur DigitsToPrepend est de 425, le numéro traduit sera 4255551212 (dans l’hypothèse où aucune autre traduction n’a été appliquée).

DigitsToStrip

Facultatif

Int32

Nombre de caractères à supprimer à partir du début de la chaîne (numéro de téléphone). Par exemple, si le numéro 2065551212 est entré et que la valeur DigitsToStrip est de 3, le numéro sera traduit en 5551212.

StartsWith

Facultatif

Chaîne

Premier caractère de la chaîne (numéro de téléphone). La chaîne ne correspond pas à l’expression régulière, à mois de commencer par la chaîne spécifiée dans le paramètre StartsWith. Par exemple, si la valeur +1 est spécifiée pour StartsWith, seuls les nombres commençant par +1 correspondent au modèle et sont traduites. Notez que le nombre de caractères de la chaîne StartsWith est inclus dans les totaux de ExactLength et AtLeastLength. Par exemple, si vous spécifiez une valeur ExactLength de 10 et une chaîne StartsWith de +1, le numéro de téléphone correspondant comporte 8 caractères et est précédé de +1, pour un total de 10 chiffres en tout.

Types d’entrées

Aucun.

Types de retours

Crée un objet de type Microsoft.Rtc.Management.Voice.OcsVoiceRegex.

Exemple

-------------------------- Exemple 1 --------------------------

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

Cet exemple crée un modèle et une traduction d’expression régulière. Cette expression inclut un modèle devant contenir exactement 7 caractères (-ExactLength 7) et supprime les trois premiers chiffres du numéro correspondant (-DigitsToStrip 3). Le modèle créé par cette expression régulière est ^\d{3}(\d{4})$. La traduction est $1. Par exemple, le numéro 5551212 correspond à ce modèle et la traduction qui en résulte est 1212 : le numéro à 7 chiffres et les 3 chiffres supprimés.

-------------------------- Exemple 2 --------------------------

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

Cet exemple créé également un modèle et une traduction d’expression régulière, mais utilise ensuite ces valeurs pour créer une règle de normalisation vocale. Dans la première ligne, nous appelons New-CsVoiceRegEx afin de créer une expression régulière dans laquelle le nombre correspondant doit comporter au moins 7 caractères (-AtLeastLength 7) et doit commencer par 1 (-StartsWith "1"). Aux résultats de cette commande sont affectés la variable $regex.

Dans la deuxième ligne, nous appelons la cmdlet New-CsVoiceNormalizationRule. Nous attribuons à la nouvelle règle un nom unique, dans ce cas, règle global/internal. Nous affectons ensuite en tant que modèle de la règle de normalisation le modèle que nous avons créé en appelant New-CsVoiceRegex : -Pattern $regex.Pattern. Nous procédons de même avec la traduction, en affectant la traduction créée avec l’appel New-CsVoiceRegex : -Translation $regex.Translation.

Remarque : le modèle créé dans cet exemple est ^(1\d{5}\d+)$. Ce dernier peut être déchiffré comme étant un nombre commençant par 1 (1) suivi de cinq chiffres (\d{5}), suivi par n’importe quel nombre de chiffres (\d+). Cela constitue un nombre d’au moins 7 chiffres (1 plus 5 plus 1 ou plus) commençant par 1, comme souhaité.