Test-CsVoiceRoute
Dernière rubrique modifiée : 2012-03-26
Permet de tester un numéro de téléphone par rapport à un modèle de numéro de routage et retourne une valeur booléenne (true/false) déclarant que le numéro fournit correspond au modèle de numéro de l’itinéraire. 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).
Syntaxe
Test-CsVoiceRoute -Route <Route> -TargetNumber <PhoneNumber> [-Force <SwitchParameter>]
Description détaillée
Un itinéraire de communications vocales inclut une expression régulière qui identifie les numéros de téléphone qui seront acheminés via un itinéraire de communications vocales donné : les numéros de téléphone qui correspondent à l’expression régulière seront acheminés via cet itinéraire. Cette cmdlet vérifie si un numéro de téléphone donné pourra être routé sur un itinéraire vocal spécifique en fonction du modèle de numéro de l’itinéraire (la propriété NumberPattern). Vous pouvez utiliser cette cmdlet pour diagnostiquer les problèmes de routage et essayer les numéros de téléphone en fonction d’itinéraires spécifiques pour garantir les résultats souhaités.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Test-CsVoiceRoute : 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 "Test-CsVoiceRoute"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Route |
Obligatoire |
Itinéraire |
Objet contenant une référence à l’itinéraire vocal en fonction lequel vous souhaitez tester le numéro précisé dans le paramètre TargetNumber. Vous pouvez récupérer un objet d’itinéraire de communications vocales en appelant la cmdlet Get-CsVoiceRoute. Type de données complet : Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route |
TargetNumber |
Obligatoire |
PhoneNumber |
Numéro de téléphone en fonction duquel vous souhaitez tester le plan de numérotation spécifié dans le paramètre Route. Le numéro doit être au format E.164 (tel que +14255551212). Type de données complet : Microsoft.Rtc.Management.Voice.PhoneNumber |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation ou les messages d’erreur récupérable qui peuvent s’afficher lors de l’exécution de la cmdlet. |
Types d’entrées
Objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route. Accepte la saisie de données transmises via le pipeline d’un objet d’itinéraire de communications vocales.
Types de retours
Retourne un objet de type Microsoft.Rtc.Management.Voice.VoiceRouteTestResult.
Exemple
-------------------------- Exemple 1 --------------------------
$vr = Get-CsVoiceRoute -Identity testroute
Test-CsVoiceRoute -TargetNumber "+14255551212" -Route $vr
Cette commande détermine si un numéro donné correspond au modèle de l’itinéraire spécifié. Nous utilisons d’abord la cmdlet Get-CsVoiceRoute pour récupérer l’itinéraire de test de l’itinéraire vocal. Nous utilisons cet itinéraire comme valeur pour le paramètre Route de la cmdlet Test-CsVoiceRoute. Nous incluons également le numéro que nous voulons tester dans le paramètre Target Number. Le résultat est une valeur booléenne déclarant si le numéro cible correspond au modèle de cet itinéraire.
-------------------------- Exemple 2 --------------------------
Get-CsVoiceRoute -Identity testroute | Test-CsVoiceRoute -TargetNumber "+14255551212"
L’exemple 2 procède de la même façon qu’à l’exemple 1. Cependant, dans cet exemple, l’action est exécutée à l’aide d’une commande unique. Nous appelons d’abord la cmdlet Get-CsVoiceRoute pour récupérer l’itinéraire vocal avec l’identité testroute. Nous acheminons l’itinéraire vocal vers la cmdlet Test-CsVoiceRoute et testons l’itinéraire en fonction du numéro fourni dans le paramètre TargetNumber. Notez que nous n’avons pas besoin de fournir le paramètre Route car l’itinéraire est acheminé vers la cmdlet.
-------------------------- Exemple 3 --------------------------
Get-CsVoiceRoute | Test-CsVoiceRoute -TargetNumber "+14255551212"
Cet exemple récupère une collection de tous les itinéraires vocaux définis avec un déploiement Lync Server 2010 et teste les modèles de numéro de chaque itinéraire en fonction de la valeur TargetNumber fournie dans l’appel à la cmdlet Test-CsVoiceRoute. Le résultat sera une valeur True ou False en fonction de chaque itinéraire testé.
-------------------------- Exemple 4 --------------------------
$z = Get-CsVoiceRoute
foreach ($x in $z){$x.Identity; Test-CsVoiceRoute -TargetNumber "+14255551212" -Route $x}
Cet exemple est similaire à l’exemple 3 en ce sens qu’il récupère les résultats d’un test d’itinéraire vocal en fonction de plusieurs itinéraires. Cependant, le résultat de l’exemple 3 sera simplifié par une liste de valeurs True/False, sans indication claire sur l’itinéraire auquel les résultats du test s’appliquent. Cet exemple résout ce problème. (Certaines choses peuvent être faites pour améliorer le résultat, mais cet exemple court permet au moins de mener la tâche à bien.)
Nous commençons par appeler Get-CsVoiceRoute pour récupérer tous les itinéraires vocaux et assigner la collection à une variable $z. Dans la ligne suivante, nous commençons une boucle foreach. La boucle prendra chaque membre de la collection, un par un et l’assignera à une variable $x. La première chose à faire avec $x, qui contient une référence à un itinéraire vocal unique, est d’afficher l’identité de cet itinéraire : $x.Identity. La partie suivante de la commande est l’appel à Test-CsVoiceRoute, où nous testons l’itinéraire $x en fonction du numéro cible. Il en résulte une liste d’identités d’itinéraire vocal (au format peu commode), suivie d’un indicateur vrai/faux permettant de savoir si le numéro cible correspond à un modèle de numéro pour l’itinéraire qui possède cette identité.