New-CsVoiceNormalizationRule
Dernière rubrique modifiée : 2012-03-26
Crée une nouvelle règle de normalisation vocale. Les règles de normalisation vocale permettent de convertir une exigence de numérotation téléphonique (par exemple, composer le 9 pour accéder à une ligne externe) au format de numéro de téléphone E.164 utilisé par Microsoft Lync Server 2010.
Syntaxe
New-CsVoiceNormalizationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceNormalizationRule -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Cette cmdlet crée une règle de normalisation vocale nommée. Ces règles sont un élément obligatoire de l’autorisation téléphonique et du routage des appels. Elles définissent les exigences de conversion (ou traduction) des numéros d’un format Lync Server 2010 interne en format (E.164) standard. Une compréhension du fonctionnement des expressions régulières est utile pour définir les modèles de numéro à traduire.
Les règles créées avec cette cmdlet font partie du plan de numérotation et, outre le fait d’être accessibles via la cmdlet Get-CsVoiceNormalizationRule, elles le sont également via la propriété NormalizationRules renvoyée par un appel vers la cmdlet Get-CsDialPlan. Il n’est possible de créer une règle de normalisation que si un plan de numérotation dont l’identité correspond à l’étendue spécifiée dans l’identité de la règle de normalisation existe déjà. Par exemple, vous ne pouvez créer de règle de normalisation comportant l’identité site:Redmond/RedmondNormalizationRule que si un plan de numérotation existe pour site:Redmond.
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-CsVoiceNormalizationRule : 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-CsVoiceNormalizationRule"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique de la règle. L’identité spécifiée doit inclure l’étendue suivie d’une barre oblique, puis du nom, par exemple : site:Redmond/Rule1, où site:Redmond correspond à l’étendue et Rule1 au nom. Ce nom sera automatiquement stocké dans la propriété Name. Il n’est pas possible de spécifier une identité et un nom dans la même commande. Des règles de normalisation vocale peuvent être créées sur les étendues suivantes : Global, Site, Service (serveur d'inscriptions et PSTNGateway uniquement) et Utilisateur. Un plan de numérotation dont l'identité correspond à l'étendue de la règle de normalisation doit préalablement exister pour pouvoir créer une nouvelle règle. (Pour récupérer la liste des plans de numérotation, appelez la cmdlet Get-CsDialPlan.) Le paramètre Identity est obligatoire sauf si le paramètre Parent est spécifié. Vous ne pouvez pas inclure les paramètres Identity et Parent dans la même commande. |
Name |
Obligatoire |
Chaîne |
Nom de la règle. Ce paramètre est obligatoire si une valeur a été spécifiée pour le paramètre Parent. Si aucune valeur n’a été définie pour le paramètre Parent, le nom par défaut est celui que vous avez spécifié dans le paramètre Identity. Par exemple, si une règle est créée avec l’identité site:Redmond/RedmondRule, le nom par défaut sera RedmondRule. Les paramètres Name et Identity ne peuvent pas être utilisés dans la même commande. |
Parent |
Obligatoire |
Chaîne |
Étendue dans laquelle la nouvelle règle de normalisation sera créée. Cette valeur doit être Global, site:<nom du site>, où <nom du site> correspond au nom du site Lync Server, passerelle PSTN ou service d’inscriptions, tel que PSTNGateway:redmond.litwareinc.com ou une chaîne désignant une règle utilisateur. Un plan de numérotation avec l’étendue spécifiée doit préalablement exister. Sinon, la commande échouera. Le paramètre Parent est obligatoire, excepté si le paramètre Identity est spécifié. Vous ne pouvez pas inclure les paramètres Identity et Parent dans la même commande. Si vous spécifiez le paramètre Parent, le paramètre Name est également nécessaire. |
Description |
Facultatif |
Chaîne |
Description conviviale de la règle de normalisation. Longueur de chaîne maximale : 512 caractères. |
IsInternalExtension |
Facultatif |
Booléen |
Si la valeur est True, le résultat de l’application de cette règle est un numéro interne à l’organisation. Si la valeur est False, la règle génère un numéro externe. Cette valeur est ignorée si la valeur de la propriété OptimizeDeviceDialing du plan de numérotation associé est définie sur False. Valeur par défaut : False |
Pattern |
Facultatif |
Chaîne |
Expression régulière à laquelle le numéro composé doit correspondre pour que cette règle soit appliquée. Valeur par défaut : ^(\d{11})$ (La valeur par défaut représente n’importe quelle série de chiffres de 11 chiffres maximum.) |
Priority |
Facultatif |
Int32 |
Ordre dans lequel les règles sont appliquées. Un numéro de téléphone peut correspondre à plusieurs règles. Ce paramètre définit l’ordre dans lequel les règles sont testées avec le numéro. |
Translation |
Facultatif |
Chaîne |
Modèle d’expression régulière qui sera appliqué au numéro afin de le convertir au format E.164. Valeur par défaut : +$1 (La valeur par défaut définit un signe plus [+] comme préfixe du numéro.) |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications. |
InMemory |
Facultatif |
Paramètre de commutateur |
Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante. |
WhatIf |
Facultatif |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Confirm |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Aucun.
Types de retours
Cette cmdlet crée un objet de type Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.
Exemple
-------------------------- Exemple 1 --------------------------
New-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond"
Cet exemple illustre la création d’une nouvelle règle de normalisation vocale pour le site de Redmond appelé Prefix Redmond. Aucun autre paramètre n’étant spécifié, la règle est créée avec les valeurs par défaut. Notez que la valeur transmise au paramètre Identity est placée entre guillemets. En effet, le nom de la règle (Prefix Redmond) contient un espace. Si le nom de la règle ne contient pas d’espace, il n’est pas nécessaire de placer l’identité entre guillemets.
Rappelez-vous qu’un plan de numérotation pour le site de Redmond doit exister pour que cette commande fonctionne. Vous pouvez créer un nouveau plan de numérotation en appelant la cmdlet New-CsDialPlan.
-------------------------- Exemple 2 --------------------------
New-CsVoiceNormalizationRule -Parent SeattleUser -Name SeattleFourDigit -Description "Dialing with internal four-digit extension" -Pattern '^(\d{4})$' -Translation '+1206555$1'
Dans cet exemple, on crée une nouvelle règle de normalisation vocale appelée SeattleFourDigit qui s’applique au plan de numérotation utilisateur comportant l’identité SeattleUser. (Remarque : au lieu de spécifier un parent et un nom, nous aurions pu créer la même règle en spécifiant -Identity SeattleUser/SeattleFourDigit.) Nous avons inclus une description expliquant que cette règle permet de traduire les numéros composés en interne avec un seul numéro de poste à 4 chiffres. De plus, les valeurs Pattern et Translation ont été spécifiées. Ces valeurs traduisent un numéro à quatre chiffres (spécifié par l’expression régulière dans le modèle) par le même numéro, précédé de la valeur Translation (+1206555). Par exemple, si le numéro de poste 1234 a été saisi, la règle convertit ce numéro de poste en +12065551234.
Notez la présence de guillemets simples autour des valeurs Pattern et Translation. Les guillemets simples sont obligatoires pour ces valeurs. Cette instance fonctionnera aussi avec des guillemets doubles ou sans guillemets.
Comme dans l’exemple 1, un plan de numérotation avec l’étendue donnée doit exister. Dans ce cas, cela signifie qu’un plan de numérotation comportant l’identité SeattleUser doit préalablement exister.