Set-CsVoiceNormalizationRule
Dernière rubrique modifiée : 2012-03-27
Modifie une 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
Set-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceNormalizationRule [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Cette cmdlet modifie 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. Il est utile de comprendre le fonctionnement des expressions régulières pour définir les modèles de numéro qui seront traduits.
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.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-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 "Set-CsVoiceNormalizationRule"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
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 est l’étendue et Rule1 est le nom. |
Instance |
Facultatif |
NormalizationRule |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. Cet objet doit être de type NormalizationRule et peut être récupéré en appelant Get-CsVoiceNormalizationRule |
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 sera un numéro interne à l’entreprise. 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. |
Priority |
Facultatif |
Int32 |
Ordre dans lequel les règles sont appliquées. Un numéro peut correspondre à plusieurs règles. Ce paramètre définit l’ordre dans lequel les règles sont testées par rapport au numéro. |
Pattern |
Facultatif |
Chaîne |
Expression régulière à laquelle le numéro composé doit correspondre pour que cette règle soit appliquée. |
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. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications. |
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
Objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule. Accepte la saisie de données transmises via le pipeline pour les objets de règle de normalisation vocale.
Types de retours
Set-CsVoiceNormalizationRule ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond" -Description "Add a prefix to all numbers on site Redmond"
Cet exemple définit la description de la règle Prefix Redmond sur le site Redmond à « Ajouter un préfixe à tous les numéros sur le site Redmond ».
-------------------------- Exemple 2 --------------------------
Set-CsVoiceNormalizationRule -Identity global/SeattleFourDigit -Description "Translate an internal four-digit extension" -Translation '+1206556$1'
Cet exemple modifie la règle de normalisation vocale dont l’identité est global/SeattleFourDigit. Une nouvelle description a été spécifiée pour refléter les modifications apportées à la règle. En outre, une valeur Translation a été spécifiée de façon à ce que la règle traduise tout numéro correspondant au modèle existant de cette règle en un numéro identique mais portant le préfixe +1206556. Par exemple, si le modèle existant correspond à un numéro à quatre chiffres et que le numéro 1234 a été entré, cette règle traduit ce numéro de poste en numéro +12065561234.
-------------------------- Exemple 3 --------------------------
$a = Get-CsVoiceNormalizationRule -Identity global/RedmondFourDigit
$a.name = "RedmondRule"
Set-CsVoiceNormalizationRule -Instance $a
L’exemple 3 change le nom de la règle de normalisation. Rappelez-vous que modifier le nom modifie également la partie du nom de l’identité. La cmdlet Set-CsVoiceNormalizationRule n’a pas de paramètre Name. Par conséquent, pour changer le nom, nous appelons d’abord Get-CsVoiceNormalizationRule afin de récupérer la règle dont l’identité est global/RedmondFourDigit et nous affectons l’objet retourné à la variable $a. Nous affectons ensuite la chaîne RedmondRule à la propriété Name de l’objet. Ensuite, nous transmettons la variable au paramètre Instance de Set-CsVoiceNormalizationRule pour que la modification soit permanente.