Test-CsVoiceUser
Dernière rubrique modifiée : 2012-03-26
Identifie l’itinéraire que doit emprunter un appel téléphonique d’un utilisateur pour être réalisé conformément à des règles, des itinéraires et des stratégies en matière de communication vocale.
Syntaxe
Test-CsVoiceUser -DialedNumber <PhoneNumber> -SipUri <UserIdParameter> [-Force <SwitchParameter>]
Description détaillée
Lorsqu’un utilisateur passe un appel téléphonique, l’itinéraire qu’il emprunte pour atteindre son destinataire dépend des stratégies et des plans de numérotation affectés à cet utilisateur. En fonction de l’adresse SIP et du numéro de téléphone de l’utilisateur, cette cmdlet retourne le numéro à traduire au format E.164 (en fonction du plan de numérotation de l’utilisateur), la règle de normalisation qui a permis cette traduction, le premier itinéraire (en fonction de la priorité de l’itinéraire) avec un modèle de numéro correspondant au numéro de téléphone, et l’utilisation téléphonique qui lie la stratégie de voix de cet utilisateur à l’itinéraire de communications vocales.
Cette cmdlet peut être utilisée pour déterminer si un numéro de téléphone spécifique sera acheminé et traduit comme prévu en fonction des paramètres utilisateur. Elle peut également aider à résoudre les problèmes auxquels chaque utilisateur est confronté.
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-CsVoiceUser : 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-CsVoiceUser"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
DialedNumber |
Obligatoire |
PhoneNumber |
Numéro de téléphone à tester. Type de données complet : Microsoft.Rtc.Management.Voice.PhoneNumber |
SipUri |
Obligatoire |
Chaîne |
URI SIP de l’utilisateur à tester. Il s’agit de l’identité (paramètre Identity) de l’utilisateur telle qu’elle est utilisée dans les cmdlets CsUser. Vous pouvez spécifier une identité d’utilisateur dans l’un des quatre formats suivants : 1) L’adresse SIP de l’utilisateur ; 2) Le nom d’utilisateur principal de l’utilisateur ; 3) Le nom de domaine et le nom d’ouverture de session de l’utilisateur, sous la forme domaine\ouverture de session (par exemple, litwareinc\kenmyer) ; et 4) Le nom complet Active Directory de l’utilisateur (par exemple, Ken Myer). Notez que le nom SAMAccountName ne peut pas être utilisé en guise d’identité. |
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
Aucun.
Types de retours
Retourne un objet de type Microsoft.Rtc.Management.Voice.OcsVoiceUserTestResult.
Exemple
-------------------------- Exemple 1 --------------------------
Test-CsVoiceUser -DialedNumber "+14255559999" -SipUri "sip:kmyer@litwareinc.com" -Verbose
Cet exemple réalise un test d’utilisateur vocal pour l’utilisateur dont l’adresse SIP est sip:kmyer@litwareinc.com. Le test est appliqué au numéro de téléphone fourni par le paramètre DialedNumber ("+14255559999"). Si aucune règle ou aucun itinéraire correspondant n’est identifié, cette cmdlet retourne une valeur Null. Notez que nous avons également inclus le paramètre Verbose. Verbose est un paramètre Windows PowerShell courant qui affiche des informations supplémentaires en cours de test, notamment le plan de numérotation et la stratégie de voix en cours de chargement pour le test.
-------------------------- Exemple 2 --------------------------
Get-CsUser | ForEach-Object {$_.DisplayName; Test-CsVoiceUser -DialedNumber "+14255559999" -SipUri $_.SipAddress} | Format-List
Cet exemple réalise un test de routage vocal pour tous les utilisateurs de Lync Server 2010 ou de Office Communications Server. Cette commande appelle d’abord la cmdlet Get-CsUser qui retourne une collection de tous les utilisateurs Lync Server 2010 ou Office Communications Server. La collection des utilisateurs est ensuite redirigée vers la cmdlet ForEach-Object. Cette cmdlet passe en revue chaque utilisateur individuel et entreprend les actions indiquées dans les accolades ({}).
La première action consiste à afficher le nom complet de l’utilisateur actuel. (L’utilisateur actuel est représenté par les caractères $_. Le nom complet se trouve donc dans la propriété DisplayName de $_.) Le compte d’utilisateur en cours de test est alors visible. Nous appelons ensuite la cmdlet Test-CsVoiceUser tout en lui transmettant le paramètre DialedNumber ("+14255559999") et le SipUri de l’utilisateur actuel. Dans cet exemple, nous utilisons l’adresse SIP de l’utilisateur ($_.SipAddress).
Enfin, parce que la sortie par défaut apparaît dans un tableau et peut être coupée afin qu’elle tienne en largeur à l’écran, nous redirigeons les résultats du test vers la cmdlet Format-List pour afficher le nom complet de chaque utilisateur suivi d’une ligne pour chaque champ de sortie.