Partager via

  • Article

Set-CsOutboundTranslationRule

 

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

Modifie une règle de traduction sortante existante. Une règle de traduction sortante permet de convertir des numéros de téléphone au format de numérotation local dans le but de communiquer avec des systèmes PBX (autocommutateur privé).

Syntaxe

Set-CsOutboundTranslationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Set-CsOutboundTranslationRule [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

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. Appelez cette cmdlet pour modifier une règle de traduction sortante existante.

Chaque règle de traduction sortante est associée à une configuration de tronçon. Cela signifie que l’utilisation de cette cmdlet pour modifier une règle aura une incidence sur la configuration de tronçon correspondante. 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. Le recours à la cmdlet Set-CsOutboundTranslationRule est recommandé pour modifier des règles de traduction sortante dans une configuration de tronçon.

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-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 "Set-CsOutboundTranslationRule"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Chaîne

Identificateur unique de la règle de traduction sortante que vous souhaitez modifier. L’identité se compose de l’étendue suivie d’un nom unique dans chaque étendue. Par exemple : site:Redmond/OutboundRule1.

Instance

Facultatif

TranslationRule

Référence d’objet à une règle de traduction sortante. Cet objet doit être du type Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule que vous pouvez extraire en appelant la cmdlet Get-CsOutboundTranslationRule.

Description

Facultatif

Chaîne

Description conviviale de la règle de traduction sortante. Cette description permet aux administrateurs d’identifier clairement l’objectif 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.

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.

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.Settings.TrunkConfiguration.TranslationRule. Accepte la saisie de données transmises via le pipeline pour les objets de règle de traduction sortante.

Types de retours

Cette cmdlet ne retourne aucune valeur. Elle modifie un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule.

Exemple

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

Set-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond" -Description "Convert to seven digits" -Pattern '^\+1425(\d{7})$' -Translation '$1'

Dans cet exemple, la règle de traduction sortante globale comportant l’identité site:Redmond/Prefix Redmond est modifiée. Nous avons inclus une description expliquant que cette règle concerne la traduction de numéros au format E.164 en numéros de téléphone à sept chiffres. De plus, les valeurs Pattern and Translation ont été spécifiées, ce qui entraînera une modification des valeurs existantes pour ces propriétés. Pour traduire 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, en un numéro à sept chiffres, ces valeurs suppriment les cinq premiers chiffres. Par exemple, le numéro +14255551212 est traduit en numéro 5551212.

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

$a = Get-CsOutboundTranslationRule -Identity "site:Redmond/OBR1"
$a.Name = "Outbound Rule 1"
Set-CsOutboundTranslationRule -Instance $a

Cet exemple modifie la propriété Name d’une règle de traduction sortante. Notez que cette action entraîne une modification de l’identité (Identity) de cette règle. La première commande présentée dans cet exemple appelle la cmdlet Get-CsOutboundTranslationRule. Une identité site:Redmond\OBR1 est spécifié afin de retourner une règle de traduction unique, à savoir la règle qui comporte l’identité donnée. Au lieu d’afficher cette règle, nous l’affectons à la variable $a. La ligne 2 de cet exemple affecte la chaîne « Outbound Rule 1 » à la propriété Name de la variable $a, soit la variable contenant une référence à la règle site:Redmond/OBR1. Sur la dernière ligne de cet exemple, nous appelons la cmdlet Set-CsOutboundTranslationRule en spécifiant le paramètre Instance et en le transmettant à la variable $a. Si nous appelons maintenant Get-CsOutboundTranslationRule avec la valeur Identity « site:Redmond/OBR1 », aucun élément ne sera retourné. Cela tient au fait que la règle comportant cette identité n’existe plus. Elle a été remplacée par la même règle, mais avec l’identité site:Redmond/Outbound Rule 1.