Test-CsVoiceTestConfiguration
Dernière rubrique modifiée : 2012-03-26
Effectue des configurations de test vocales pour s’assurer que le routage et les stratégies fonctionnent comme prévu.
Syntaxe
Test-CsVoiceTestConfiguration -TestCaseInputObject <TestConfiguration> [-Dialplan <LocationProfile>] [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>] [-VoicePolicy <VoicePolicy>]
Test-CsVoiceTestConfiguration -DialedNumber <PhoneNumber> -Dialplan <LocationProfile> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]
Description détaillée
Avant d’implémenter les itinéraires de communications vocales et les stratégies de voix, il est préférable de les tester sur divers numéros de téléphone afin de s’assurer que les résultats sont ceux que vous attendez. L’exécution de cette cmdlet avec les paramètres appropriés vous permet de réaliser ces tests.
Cette cmdlet teste un numéro de téléphone par rapport à l’itinéraire de communications vocales, à l’utilisation, au plan de numérotation et à la stratégie de voix, afin de vérifier le résultat souhaité ou de comparer le résultat réel au résultat attendu. Vous pouvez définir les configurations vocales à tester en saisissant les paramètres appropriés individuellement ou à l’aide de la cmdlet New-CsVoiceTestConfiguration.
Si vous entrez des valeurs pour DialedNumber, DialPlan et VoicePolicy, le résultat inclura le numéro traduit, la règle de normalisation utilisée pour créer cette traduction, l’itinéraire utilisé ainsi que l’utilisation RTC. Si à la place, vous avez entré une valeur pour le paramètre TestCaseInputObject, vous pouvez également récupérer un statut indiquant si les résultats étaient conformes aux résultats attendus que vous avez renseignés dans l’objet de test lors de sa création avec la cmdlet New-CsVoiceTestConfiguration.
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-CsVoiceTestConfiguration : 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-CsVoiceTestConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
DialedNumber |
Obligatoire |
PhoneNumber |
Numéro de téléphone auquel le test doit être appliqué. À partir du plan de numérotation, de l’itinéraire et de la stratégie, ce numéro sera normalisé et affiché en sortie. Ce paramètre est obligatoire, sauf si le paramètre TestCaseInputObject est fourni avec une valeur. Vous ne pouvez pas saisir un paramètre DialedNumber et un paramètre TestCaseInputObject (TestCaseInputObject inclut déjà un paramètre DialedNumber dans cet objet). |
Dialplan |
Obligatoire |
LocationProfile |
Référence à un objet du plan de numérotation à utiliser lors de l’exécution du test. Vous pouvez extraire des objets de plan de numérotation en appelant la cmdlet Get-CsDialPlan. Ce paramètre est obligatoire si vous avez également spécifié le paramètre DialedNumber. N’appliquez pas ce paramètre si vous utilisez TestCaseInputObject. Si vous le faites, l’objet dans ce paramètre doit correspondre au plan de numérotation spécifié dans TestCaseInputObject, rendant ainsi redondante l’utilisation de ce paramètre. |
TestCaseInputObject |
Obligatoire |
TestConfiguration |
Objet contenant une référence à la configuration vocale à tester. Vous pouvez extraire cette référence d’objet en appelant la cmdlet Get-CsVoiceTestConfiguration. Si vous appelez la cmdlet avec ce paramètre, vous ne pouvez pas spécifier le paramètre DialedNumber. Les paramètres LocationProfile ou VoicePolicy ne doivent pas non plus être spécifiés, car ces derniers seraient redondants avec les valeurs de l’objet de configuration de test vocale. |
VoicePolicy |
Obligatoire |
VoicePolicy |
Référence à un objet de la stratégie de voix à utiliser lors de l’exécution du test. Vous pouvez extraire des objets de stratégie de voix en appelant la cmdlet Get-CsVoicePolicy. Ce paramètre est obligatoire si vous avez également spécifié le paramètre DialedNumber. N’appliquez pas ce paramètre si vous utilisez TestCaseInputObject. Si vous le faites, l’objet dans ce paramètre doit correspondre à la stratégie de voix spécifiée dans le TestCaseInputObject, rendant ainsi redondante l’utilisation de ce paramètre. |
RouteSettings |
Facultatif |
PstnRoutingSettings |
Référence à un objet contenant tous les itinéraires de communications vocales disponibles dans l’installation Microsoft Lync Server 2010. Vous pouvez extraire cet objet en appelant la cmdlet Get-CsRoutingConfiguration. Vous pouvez associer ce paramètre à DialedNumber ou à TestCaseInputObject. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications. |
Types d’entrées
Objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration. Accepte la saisie de données transmises via le pipeline pour un objet de configuration de test vocale.
Types de retours
Cette cmdlet renvoie un objet de type Microsoft.Rtc.Management.Voice.OcsVoiceTestResult.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsVoiceTestConfiguration -Identity TestConfig1 | Test-CsVoiceTestConfiguration
Dans cet exemple, un test de configuration vocale est effectué à partir de la configuration TestConfig1. La cmdlet Get-CsVoiceTestConfiguration est d’abord exécutée pour extraire la configuration comportant l’identité TestConfig1. Cet objet de configuration est ensuite redirigé vers la cmdlet Test-CsVoiceTestConfiguration.
-------------------------- Exemple 2 --------------------------
$a = Get-CsVoiceTestConfiguration -Identity TestConfig1
Test-CsVoiceTestConfiguration -TestCaseInputObject $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 stocké dans la variable $a, puis transmis comme valeur au paramètre TestCaseInputObject à utiliser en tant que configuration de test.
-------------------------- Exemple 3 --------------------------
$dp = Get-CsDialPlan -Identity Global
$vp = Get-CsVoicePolicy -Identity Global
Test-CsVoiceTestConfiguration -DialedNumber 4255551212 -Dialplan $dp -VoicePolicy $vp
Dans cet exemple, une configuration de test est exécutée sans avoir à la définir préalablement avec la cmdlet New-CsVoiceTestConfiguration. Au lieu de transmettre un objet TestConfiguration préalablement créé, cet exemple indique comment configurer un test à la volée en spécifiant le numéro composé à tester, ainsi que le plan de numérotation et la stratégie de voix à partir desquels le test doit être réalisé.
La première ligne de cet exemple appelle la cmdlet Get-CsDialPlan de façon à extraire le plan de numérotation Global. L’objet de plan de numérotation extrait est attribué à la variable $dp. Sur la deuxième ligne, nous procédons de la même manière avec la stratégie de voix en appelant la cmdlet Get-CsVoicePolicy pour extraire la stratégie de voix globale, et en attribuant ensuite cette stratégie à la variable $vp.
Enfin, nous sommes prêts à exécuter le test. Nous appelons la cmdlet Test-CsVoiceTestConfiguration, qui transmet le numéro de téléphone à tester au paramètre DialedNumber, le plan de numérotation que nous avons extrait sur la ligne 1 (stocké dans $dp) au paramètre LocationProfile et la stratégie de voix que nous avons extraite sur la ligne 2 (stockée dans $vp) au paramètre VoicePolicy.
Notez que le résultat pour l’exemple 3 n’inclura pas de statut pour les résultats attendus. Si vous voulez tester les résultats par rapport à vos attentes, vous devez définir ces dernières au moyen de la cmdlet New-CsVoiceTestConfiguration et appeler Test-CsVoiceTestConfiguration comme indiqué dans les exemples 1 et 2.