New-CsOutboundTranslationRule
Dernière rubrique modifiée : 2012-03-26
Crée une nouvelle règle de traduction sortante. Une règle de traduction sortante convertit des numéros de téléphone au format de numérotation local pour une interaction avec les systèmes PBX (autocommutateur privé).
Syntaxe
New-CsOutboundTranslationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
New-CsOutboundTranslationRule -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Appelez cette cmdlet pour créer une règle de traduction sortante. Microsoft Lync Server 2010 normalise les numéros de téléphone au format E.164. Cependant, de nombreux systèmes PBX (autocommutateur privé) ne sont pas compatibles avec ce format. Les règles de traduction sortantes convertissent le numéro au format de numérotation local avant de le transmettre au serveur de médiation ou à la passerelle.
Chaque règle de traduction sortante est associée à une configuration de tronçon. Vous pouvez associer plusieurs règles de traduction sortante à chaque configuration. Par conséquent, l’identité de chaque règle se compose d’une étendue et d’un nom unique au sein de cette dernière (au format étendue/nom, par exemple : site:Redmond/OBR1). La règle est automatiquement associée à la configuration de tronçon comportant la même étendue. Si vous appelez New-CsOutboundTranslationRule et spécifiez une étendue pour laquelle une configuration de tronçon n’a pas encore été définie, la configuration de tronçon sera créée avec l’étendue donnée, la règle de traduction sortante et les valeurs par défaut.
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-CsOutboundTranslationRule : 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-CsOutboundTranslationRule"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique de la règle de traduction sortante. L’identité comprend l’étendue à laquelle la règle est appliquée ainsi que le nom de la règle. Il ne peut s’agir que de l’étendue Site, de l’étendue Global ou de l’étendue Service (PSTNGateway uniquement). Par exemple : site:Redmond/OutboundRule1 et PstnGateway:Redmond.litwareinc.com/OutboundRule2. Si le paramètre Identity est spécifié, vous ne pouvez pas spécifier de valeurs pour les paramètres Name et Parent. |
Parent |
Obligatoire |
Chaîne |
Étendue de la règle de traduction sortante. Si une valeur est spécifiée pour ce paramètre, une valeur doit également être spécifiée pour le paramètre Name. Cependant, le paramètre Identity ne peut pas être spécifié. Si les paramètres Parent et Name ne sont pas spécifiés, le paramètre Identity doit l’être. |
Name |
Obligatoire |
Chaîne |
Nom de la règle de traduction sortante. Si aucun nom n’est indiqué, une identité constituée d’une étendue et d’un nom doit être spécifiée. Si un nom est indiqué, le paramètre Parent est également requis mais il n’est pas possible de spécifier une identité. |
Description |
Facultatif |
Chaîne |
Description de la règle de traduction sortante. Cette description permet d’identifier l’objet de la règle. |
Pattern |
Facultatif |
Chaîne |
Expression régulière représentant le modèle de numéro auquel la traduction sera appliquée. Valeur par défaut : ^\+(\d*)$ |
Priority |
Facultatif |
Int32 |
Si un numéro correspond au modèle de plusieurs règles de traduction sortante, ces dernières sont appliquées par ordre de priorité. Utilisez ce paramètre pour affecter une priorité à la règle. |
Translation |
Facultatif |
Chaîne |
Expression régulière qui sera appliquée au numéro correspondant au modèle pour le préparer au routage sortant. Valeur par défaut : $1 |
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.Settings.TrunkConfiguration.TranslationRule.
Exemple
-------------------------- Exemple 1 --------------------------
New-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"
Cet exemple crée une nouvelle règle de traduction sortante pour le site Redmond nommé Prefix Redmond. Puisqu’aucun autre paramètre n’est 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 ; ceci est dû au fait que 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.
-------------------------- Exemple 2 --------------------------
New-CsOutboundTranslationRule -Parent global -Name SeattleSevenDigit -Description "Convert to seven digits" -Pattern '^\+1425(\d{7})$' -Translation '$1'
Cet exemple crée une nouvelle règle de traduction sortante globale appelée SeattleSevenDigit. (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 global/SeattleSevenDigit.) Nous avons inclus une description expliquant que cette règle concerne la traduction de numéros au format E.164 au format à sept chiffres. De plus, les valeurs Pattern et Translation ont été spécifiées. Ces valeurs traduisent un numéro E.164 (dans ce cas, 12 chiffres commençant par +1425), spécifié par l’expression régulière dans le modèle, par un numéro à sept chiffres en supprimant les cinq premiers chiffres. Par exemple, le numéro +14255551212 est traduit par le numéro 5551212.
Voir aussi
Autres ressources
Remove-CsOutboundTranslationRule
Set-CsOutboundTranslationRule
Get-CsOutboundTranslationRule