Partager via


Get-CsVoiceRoute

 

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

Renvoie des informations sur les itinéraires de communications vocales configurés pour être utilisés dans une organisation.

Syntaxe

Get-CsVoiceRoute [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

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

Description détaillée

Cette cmdlet vous permet de récupérer un ou plusieurs itinéraires de communications vocales existants. Les itinéraires de communications vocales contiennent des instructions qui indiquent à Microsoft Lync Server 2010 comment router les appels des utilisateurs Enterprise Voice vers des numéros de téléphone sur le réseau téléphonique commuté (PSTN) ou un autocommutateur privé (PBX).

Cette cmdlet peut être utilisée pour récupérer des informations sur les itinéraires de communications vocales, comme les passerelles PSTN auxquelles l’itinéraire est associé (le cas échéant), les utilisations PSTN associées à l’itinéraire, le modèle (sous la forme d’une expression régulière) qui identifie les numéros de téléphone auxquels l’itinéraire s’applique, ainsi que les paramètres d’ID d’appelant. L’utilisation PSTN associe l’itinéraire de communications vocales à une stratégie de voix.

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-CsVoiceRoute : 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-CsVoiceRoute"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsGlobalRelativeIdentity

Chaîne qui identifie de façon unique l’itinéraire de communications vocales. Si aucune identité n’est fournie, tous les itinéraires de communications vocales de l’organisation sont renvoyés.

Filter

Facultatif

Chaîne

Ce paramètre filtre les résultats de l’opération Get en fonction de la valeur de caractère générique transmise à ce paramètre.

LocalStore

Facultatif

Paramètre de commutateur

Récupère l'itinéraire de communications vocales à 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

Cette cmdlet retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.

Exemple

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

Get-CsVoiceRoute

Récupère les propriétés de tous les itinéraires de communications vocales définis dans l’organisation.

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

Get-CsVoiceRoute -Identity Route1

Récupère les propriétés de l’itinéraire de communications vocales Route1.

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

Get-CsVoiceRoute -Filter *test*

Cette commande affiche les paramètres d’itinéraire de communications vocales pour lesquels l’identité contient la chaîne « test » dans la valeur. Pour trouver la chaîne test uniquement à la fin de l’identité, utilisez la valeur *test. De même, pour trouver la chaîne test uniquement au début de l’identité, spécifiez la valeur test*.

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

Get-CsVoiceRoute | Where-Object {$_.PstnGatewayList.Count -eq 0}

Cette commande récupère tous les itinéraires de communications vocales auxquels aucune passerelle PSTN n’a été attribuée. Tous les itinéraires de communications vocales sont d’abord récupérés à l’aide de la cmdlet Get-CsVoiceRoute. Ces itinéraires de communications vocales sont ensuite redirigés vers la cmdlet Where-Object. Where-Object permet de restreindre les résultats de l’opération Get. Dans ce cas, nous analysons chaque itinéraire de communications vocales (ce que représente le $_) et contrôlons la propriété Count de la propriété PstnGatewayList. Si le nombre de passerelles PSTN est 0, la liste est vide et aucune passerelle n’a été définie pour l’itinéraire.