Partager via


Test-CsVoicePolicy

 

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

Teste un numéro de téléphone par rapport à une stratégie de voix et détermine quel itinéraire vocal doit être utilisé en fonction de la stratégie de numérotation correspondante.

Syntaxe

Test-CsVoicePolicy -TargetNumber <PhoneNumber> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]

Description détaillée

Les stratégies de voix sont associées aux itinéraires de communications vocales par l’intermédiaire des utilisations du réseau téléphonique commuté (PSTN). L’appel d’un utilisateur auquel a été assignée une stratégie de voix particulière ne peut être envoyé que sur un itinéraire dont l’utilisation PSTN correspond à une utilisation de la stratégie ainsi qu’à un modèle de numérotation correspondant au numéro composé. Appelez la cmdlet Test-CsVoicePolicy pour connaître l’itinéraire utilisé pour le routage de l’appel d’un utilisateur ayant une stratégie de voix spécifique, ainsi que l’utilisation du téléphone associé à la stratégie de cet itinéraire.

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

Paramètres

Paramètre Obligatoire Type Description

TargetNumber

Obligatoire

PhoneNumber

Le numéro de téléphone qui doit être utilisé pour le test. Le numéro doit être au format E.164 (tel que +14255551212).

Type de données complet : Microsoft.Rtc.Management.Voice.PhoneNumber

VoicePolicy

Obligatoire

VoicePolicy

Référence à un objet de configuration de stratégie de voix à partir duquel le test doit être exécuté. Vous pouvez extraire des objets de stratégie de voix en appelant la cmdlet Get-CsVoicePolicy.

Type de données complet : Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy

RouteSettings

Facultatif

PstnRoutingSettings

Paramètres d’itinéraire pour lequel le test doit être exécuté. Les paramètres d’itinéraire peuvent être récupérés par un appel à la cmdlet Get-CsRoutingConfiguration.

Type de données complet : Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings

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.VoicePolicy. Accepte la saisie de données transmises via le pipeline pour les objets de stratégie de voix.

Types de retours

Retourne un objet de type Microsoft.Rtc.Management.Voice.VoicePolicyTestResult.

Exemple

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

Get-CsVoicePolicy -Identity site:Redmond | Test-CsVoicePolicy -TargetNumber "+14255559999"

Cet exemple exécute une stratégie de voix basée sur l’identité site:Redmond. C’est la cmdlet Get-CsVoicePolicy qui est d’abord exécutée pour récupérer la stratégie avec l’identité site:Redmond. L’objet de cette stratégie est ensuite acheminé vers la cmdlet Test-CsVoicePolicy où la stratégie est testée pour le numéro +14255559999. Le résultat est le premier itinéraire vocal (basé sur la propriété prioritaire de l’itinéraire) ayant un modèle de numéro correspondant à la valeur cible du numéro et une utilisation téléphonique correspondant à l’utilisation du téléphone dans le cadre de la stratégie. Si aucun itinéraire correspondant n’est trouvé (par exemple, si le modèle de numéro correspond au modèle d’un numéro à 11 chiffres et que vous fournissez un numéro à 7 chiffres), une valeur nulle vous sera renvoyée.

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

$a = Get-CsVoicePolicy -Identity site:Redmond
Test-CsVoicePolicy -TargetNumber "+14255559999" -VoicePolicy $a

L’exemple 2 est identique à l’exemple 1, mais au lieu de rediriger les résultats de l’opération Get directement vers la cmdlet Test, l’objet est d’abord enregistré dans la variable $a, puis transmis comme valeur au paramètre VoicePolicy à utiliser comme configuration de test.

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

Get-CsVoicePolicy | Test-CsVoicePolicy -TargetNumber "+12065559999"

Cet exemple exécute un test de stratégie de voix pour comparer toutes les stratégies vocales définies dans le déploiement Lync Server 2010. La cmdlet Get-CsVoicePolicy est d’abord exécutée (sans aucun paramètre) pour récupérer toutes les stratégies de voix. La collection de stratégies renvoyée est ensuite acheminée vers la cmdlet Test-CsVoicePolicy où chaque stratégie de la collection est contrôlée pour savoir si un itinéraire correspond au numéro de téléphone cible fourni (+12065559999) et aux utilisations du téléphone. Le résultat est une liste des itinéraires correspondants avec les utilisations de téléphone afférentes.