New-CsVoiceTestConfiguration
Dernière rubrique modifiée : 2012-03-27
Crée un scénario de test auquel vous pouvez avoir recours pour évaluer des numéros de téléphone par rapport à des itinéraires et des règles définis.
Syntaxe
New-CsVoiceTestConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceTestConfiguration -Name <String> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 créer des scénarios de test avec cette cmdlet.
La cmdlet New-CsVoiceTestConfiguration modifie l’itinéraire de communications vocales, l’utilisation, le plan de numérotation et la stratégie de voix selon lesquels un numéro de téléphone donné doit être testé. Toutes ces informations peuvent être définies et récupérées grâce à d’autres cmdlets. Consultez les descriptions de paramètre de cette rubrique pour plus d’informations.
Les configurations créées au moyen de cette cmdlet sont testées avec 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 New-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 "New-CsVoiceTestConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsGlobalRelativeIdentity |
Chaîne qui identifie de façon unique ce scénario de test. Cette chaîne peut afficher une longueur maximale de 32 caractères et peut comporter n’importe quel caractère alphanumérique en plus de la barre oblique inverse (\), du point (.) ou du trait de soulignement (_). 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. |
Name |
Obligatoire |
Chaîne |
Ce paramètre affiche la même valeur que le paramètre Identity. Si vous spécifiez le paramètre Identity, vous ne pouvez pas inclure le paramètre Name dans votre commande. De même, si vous spécifiez le paramètre Name, aucun paramètre Identity ne peut être inclus. |
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. Valeur par défaut : 1234 |
ExpectedRoute |
Facultatif |
Chaîne |
Nom de l’itinéraire de communications vocales devant être utilisé lors du test de configuration. Si un autre itinéraire est appliqué avec le plan de numérotation 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 obtenu au format souhaité après 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. Valeur par défaut : +1234 |
ExpectedUsage |
Facultatif |
Chaîne |
Nom de l’utilisation du réseau PSTN prévue pour le test de configuration. Si une autre utilisation RTC est appliquée avec le plan de numérotation cible et la stratégie de voix, 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 par la cmdlet Get-CsDialPlan. Ne doit pas comporter plus de 40 caractères. Valeur par défaut : globale |
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. Valeur par défaut : globale |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications. |
InMemory |
Facultatif |
Paramètre de commutateur |
Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante. |
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
Aucun.
Types de retours
Cette cmdlet crée un objet de type Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1
Cet exemple crée une nouvelle configuration de test vocale dotée de valeurs par défaut dont l’identité est TestConfig1.
-------------------------- Exemple 2 --------------------------
New-CsVoiceTestConfiguration TestConfig1 -TargetDialplan site:Redmond1
Cet exemple crée une nouvelle configuration de test vocale appelée TestConfig1 et définit le paramètre TargetDialplan sur site:Redmond1. Au cours des tests, le nombre attendu, l’utilisation et l’itinéraire seront alors comparés aux paramètres du plan de numérotation du site Redmond1.
Dans cet exemple, la configuration de test vocale TestConfig1 est déclarée sans qu’un paramètre Identity ne soit spécifié. Identity est un paramètre positionnel, de sorte que la première valeur dans la commande qui suit le nom de la cmdlet est reconnue par cette dernière en tant que paramètre Identity.
-------------------------- Exemple 3 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212
Cet exemple crée une nouvelle configuration de test vocale appelée TestConfig1. Cette configuration utilisera les valeurs par défaut pour tester le paramètre DialedNumber 5551212 par rapport à un résultat attendu (ExpectedTranslatedNumber) +5551212. Ce résultat est fondé sur les règles de normalisation associées au plan de numérotation qui servira à réaliser un test pour cet objet. Ce test doit être effectué au moyen de la cmdlet Test-CsVoiceTestConfiguration.