Partager via

  • Article

Get-CsVoiceNormalizationRule

 

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

Retourne des informations sur les règles de normalisation vocale utilisées dans votre organisation. Les règles de normalisation vocale convertissent des exigences de numérotation téléphonique (par exemple, le fait de 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

Get-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsVoiceNormalizationRule [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

Cette cmdlet retourne une règle de normalisation vocale nommée ou une collection de règles de normalisation vocale. 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 (traduction) des numéros de format Lync Server 2010 interne au format (E.164) standard. Il est bon de savoir comment fonctionne les expressions régulières pour définir les modèles de numéro qui seront traduits.

Les mêmes règles auxquelles accède cette cmdlet sont également accessibles via la propriété NormalizationRules renvoyée par un appel à 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 Get-CsVoiceNormalizationRule : RTCUniversalUserAdmins, 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 "Get-CsVoiceNormalizationRule"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la règle. Si une valeur est spécifiée pour ce paramètre, elle doit être au format étendue/nom, par exemple, site:Redmond/Rule1 où site:Redmond est l’étendue et Rule1, le nom.

Filter

Facultatif

XdsIdentityFilter

Utilisez des caractères génériques pour retourner une collection de règles de normalisation basées sur l’identité. Notez que le filtre ne fonctionne que sur la portion étendue de l’identité, pas sur le nom. Par exemple, la valeur de filtre *lob* renverra toutes les règles au niveau de l’étendue globale (étendues contenant les lettres lob), mais pas une règle avec l’identité site:Redmond/lobby où lob ne se trouve que dans la partie identité du nom et pas dans la partie étendue.

LocalStore

Facultatif

Paramètre de commutateur

Récupère la règle de normalisation vocale à partir du réplica local du magasin central de gestion, au lieu du magasin central de gestion lui-même.

Types d’entrées

Aucun.

Types de retours

Get-CsVoiceNormalizationRule retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.

Exemple

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

Get-CsVoiceNormalizationRule

Cet exemple retourne toutes les règles de normalisation vocale définies pour l’organisation.

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

Get-CsVoiceNormalizationRule -Filter site*

L’exemple 2 récupère toutes les règles de normalisation vocale spécifiées pour l’ensemble des sites.

-------------------------- Exemple 3 --------------------------

Get-CsVoiceNormalizationRule -Filter *s*

L’exemple 3 récupère toutes les règles de normalisation vocale avec la lettre « s » à n’importe quelle position dans l’étendue. Par exemple, cela renverra toutes les règles au niveau du site et du service ainsi que les règles de la configuration par utilisateur avec un « s » dans le nom de l’étendue, comme RedmondEastUsers.

-------------------------- Exemple 4 --------------------------

Get-CsVoiceNormalizationRule | Where-Object {$_.Name -match "seattle"}

Le paramètre Filter utilisé dans les exemples 2 et 3 correspond uniquement à la partie étendue de l’identité. Cet exemple établit une correspondance avec la partie nom pour retourner toutes les règles dont le nom contient la chaîne « seattle ». Pour ce faire, nous appelons d’abord Get-CsVoiceNormalizationRule pour récupérer toutes les règles de normalisation de l’organisation. Nous redirigeons ensuite cette collection vers la cmdlet Where-Object afin de rechercher tous les éléments de la collection pour lesquels la propriété Name correspond à la chaîne « seattle ».