Set-CsVoiceTestConfiguration
Dernière rubrique modifiée : 2012-03-27
Modifie un scénario de test que vous pouvez utiliser pour tester des numéros de téléphone par rapport aux itinéraires et aux règles spécifiés.
Syntaxe
Set-CsVoiceTestConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceTestConfiguration [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
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. Pour ce faire, vous pouvez modifier des scénarios de test avec cette cmdlet.
La cmdlet Set-CsVoiceTestConfiguration modifie l’itinéraire de communication vocale, l’utilisation, le profil d’emplacement (plan de numérotation) et la stratégie de voix par rapport auxquels le numéro de téléphone spécifié doit être testé. Toutes ces informations peuvent être définies et récupérées grâce à d’autres cmdlets définies dans les descriptions de paramètre de cette rubrique.
Les configurations modifiées par cette cmdlet sont testées via la cmdlet Test-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 Set-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 "Set-CsVoiceTestConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Chaîne |
Chaîne qui identifie de manière unique le scénario de test que vous souhaitez modifier. La valeur de ce paramètre n’inclut pas l’étendue, car cet objet ne peut être créé que dans l’étendue globale. Par conséquent, seul un nom unique est requis. |
Instance |
Facultatif |
TestConfiguration |
Objet de type Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration qui contient la configuration de test vocal existante, ainsi que les changements que vous souhaitez apporter à cette configuration. Ce type d’objet peut être récupéré par l’appel de la cmdlet Get-CsVoiceTestConfiguraton. |
DialedNumber |
Facultatif |
Chaîne |
Numéro de téléphone que vous souhaitez utiliser pour tester les stratégies, les utilisations, etc. Ne doit pas comporter plus de 512 caractères. |
ExpectedRoute |
Facultatif |
Chaîne |
Nom de l’itinéraire de communications vocales qui doit être utilisé lors du test de configuration. Si un autre itinéraire est appliqué avec le plan de numérotation (profil d’emplacement) cible et la stratégie de voix, le test échouera. Vous pouvez récupérer les itinéraires de communications vocales disponibles en appelant la cmdlet Get-CsVoiceRoute. Ne doit pas comporter plus de 256 caractères. |
ExpectedTranslatedNumber |
Facultatif |
Chaîne |
Numéro de téléphone au format souhaité à l’issue de la traduction. Il s’agit de la valeur du paramètre DialedNumber une fois la normalisation effectuée. Si vous exécutez Test-CsVoiceTestConfiguration et que DialedNumber ne génère pas la valeur de ExpectedTranslatedNumber, le test échouera. Ne doit pas comporter plus de 512 caractères. |
ExpectedUsage |
Facultatif |
Chaîne |
Nom de l’utilisation du réseau PSTN prévue pour le test de configuration. Si un autre réseau PSTN est utilisé avec le plan de numérotation (profil d’emplacement) et la stratégie de voix cibles, le test échouera. Vous pouvez récupérer les utilisations disponibles en appelant Get-CsPstnUsage. Ne doit pas comporter plus de 256 caractères. |
TargetDialplan |
Facultatif |
Chaîne |
Identité du plan de numérotation à utiliser pour ce test. Les plans de numérotation peuvent être récupérés en appelant la cmdlet Get-CsDialPlan. Ne doit pas comporter plus de 40 caractères. |
TargetVoicePolicy |
Facultatif |
Chaîne |
Identité de la stratégie de voix sur laquelle ce test est exécuté. Les stratégies de voix peuvent être récupérées en appelant Get-CsVoicePolicy. Ne doit pas comporter plus de 40 caractères. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications. |
WhatIf |
Facultatif |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Confirm |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration. Accepte la saisie de données transmises via le pipeline pour les objets de configuration vocale de test.
Types de retours
Cette cmdlet retourne un objet de type Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 14255551212
Cet exemple définit le numéro composé pour la configuration de test vocale TestConfig1 à 14255551212. Il s’agit du numéro qui sera contrôlé par rapport à la stratégie de voix et à l’itinéraire, afin de s’assurer que la normalisation s’effectue comme prévu, mais aussi que ce sont les itinéraires et les plans de numérotation corrects qui sont appliqués.
-------------------------- Exemple 2 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -TargetDialplan site:Redmond1 -ExpectedTranslatedNumber "+912065551212"
Cet exemple modifie les paramètres de la configuration de test vocal TestConfig1. La commande définit l’élément TargetDialplan en fonction du profil d’emplacement (plan de numérotation) pour site:Redmond1. Une modification du plan de numérotation pouvant impliquer une modification des règles de normalisation, l’élément ExpectedTranslationNumber a également été modifié pour obtenir la fonction attendue des règles de normalisation pour ce plan de numérotation.