Testen von VoIP-Regeln, Routen und Richtlinien in Lync Server 2013
Letzte Änderung: 20.05.2014
Überprüfungszeitplan |
Monatlich |
Testtool |
Windows PowerShell |
Erforderliche Berechtigungen |
Bei der lokalen Ausführung mithilfe der Lync Server-Verwaltungsshell müssen Benutzer Mitglieder der Sicherheitsgruppe RTCUniversalServerAdmins sein. Wenn sie mit einer Remoteinstanz von Windows PowerShell ausgeführt werden, müssen Benutzern eine RBAC-Rolle zugewiesen werden, die über die Berechtigung zum Ausführen des Test-CsVoiceUser-Cmdlets verfügt. Um eine Liste aller RBAC-Rollen anzuzeigen, die dieses Cmdlet verwenden können, führen Sie den folgenden Befehl an der Windows PowerShell Eingabeaufforderung aus:
|
Beschreibung
Wenn ein Benutzer einen Telefonanruf abgibt, hängt die Route, die der Anruf zum Erreichen seines Ziels benötigt, sowohl von den Richtlinien als auch von den Wählplänen ab, die diesem Benutzer zugewiesen sind. Angesichts der SIP-Adresse eines Benutzers und einer Telefonnummer überprüft das Test-CsVoiceUser-Cmdlet, ob der betreffende Benutzer einen Anruf an diese Nummer tätigen kann. Wenn der Test erfolgreich ist, gibt Test-CsVoiceUser Folgendes zurück:
Die in das E.164-Format übersetzte Nummer (basierend auf dem Wählplan des Benutzers)
Die Normalisierungsregel, die diese Übersetzung bereitgestellt hat
Die verwendete VoIP-Route (basierend auf der Routenpriorität);
Die Telefonnutzung, die die VoIP-Richtlinie des Benutzers mit der VoIP-Route verknüpft hat.
Test-CsVoiceUser können Sie ermitteln, ob eine bestimmte Telefonnummer wie erwartet weitergeleitet und übersetzt wird, und kann bei der Behandlung von Anrufproblemen helfen, die bei einzelnen Benutzern auftreten.
Ausführen des Tests
Wenn Sie das cmdlet Test-CsVoiceUser ausführen, müssen Sie zwei Informationen angeben: die gewählte Nummer (DialedNumber) und die Identität des benutzerkontos, das getestet wird. Mit diesem Befehl wird beispielsweise die Fähigkeit des Benutzers getestet, der über die SIP-Adresse sip verfügt:kenmyer@litwareinc.com Einen Anruf an die Telefonnummer +1206555-1219 tätigen:
Test-CsVoiceUser -DialedNumber "12065551219" -SipUri "sip:kenmyer@litwareinc.com"
Die Telefonnummer sollte so formatiert sein, wie Sie erwarten, dass sie gewählt wird. Wenn Benutzer beispielsweise in der Regel nicht die 1 wählen, bevor sie einen Fernanruf tätigen, sollten Sie dieses Format verwenden:
-DialedNumber "2065551219"
In diesem Fall schlägt der Test natürlich fehl, wenn Sie nicht über eine Normalisierungsregel verfügen, die die Nummer 2065551219 korrekt in das E.164-Telefonformat übersetzen kann, das von Lync Server verwendet wird. Weitere Informationen finden Sie im Hilfethema New-CsVoiceNormalizationRule Cmdlet.
Wenn Sie diesen Test für jedes Ihrer Benutzerkonten ausführen möchten, können Sie einen Befehl wie den folgenden verwenden:
Get-CsUser | ForEach-Object {$_.DisplayName; Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri $_.SipAddress} | Format-List
Weitere Informationen finden Sie in der Hilfedokumentation zum cmdlet Test-CsVoiceUser.
Bestimmen von Erfolg oder Fehler
Wenn der Test erfolgreich abgeschlossen wurde (d. a. wenn der Benutzer einen Telefonanruf an die angegebene Rufnummer tätigen kann), werden in der Ausgabe Informationen wie die übersetzte Telefonnummer und die entsprechende Normalisierungsregel und VoIP-Route angezeigt:
TranslatedNumber MatchingRule FirstMatchingRoute MatchingUsage
---------------- ------------ ------------------ -------------
+12065551219 Deskripti... LocalRoute Local
Aufgrund der Einschränkungen des Windows PowerShell Bildschirms werden zumindest einige zurückgegebene Informationen (insbesondere die vollständige Beschreibung der übereinstimmenden Normalisierungsregel) möglicherweise nicht auf dem Bildschirm angezeigt. Wenn Sie sich nur für den Erfolg oder Misserfolg des Tests interessieren, spielt dies möglicherweise keine Rolle. Wenn Sie die vollständigen Details der zurückgegebenen Daten anzeigen möchten, geben Sie die Ausgabe beim Ausführen des Tests an das Format-List-Cmdlet weiter:
Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri "sip:kenmyer@litwareinc.com" -Verbose | Format-List
Dadurch wird die Ausgabe in einem leserfreundlicheren Format angezeigt:
TranslatedNumber : +12065551219
MatchingRule : Description=; Pattern=^(\d{11})$; Übersetzung=+$1;
Name=Präfix alle;IsInternalExtension=False
FirsMatchingRoute : LocalRoute
MatchingUsage : Lokal
Wenn der Test fehlschlägt, gibt Test-CsVoiceUser einen leeren Satz von Eigenschaftswerten zurück:
TranslatedNumber MatchingRule FirstMatchingRoute MatchingUsage
---------------- ------------ ------------------ -------------
Gründe, warum der Test möglicherweise fehlgeschlagen ist
Es gibt eine Reihe von Gründen, warum das cmdlet Test-CsVoiceUser fehlschlägt: Möglicherweise gibt es keine Normalisierungsregel, die die angegebene Telefonnummer übersetzen kann. Es könnte Probleme mit der VoIP-Route geben. Möglicherweise liegt ein Konfigurationsproblem mit dem dem betreffenden Benutzer zugewiesenen Wählplan vor. Aus diesem Grund möchten Sie möglicherweise den Parameter "Verbose" einschließen, wenn Sie das cmdlet Test-CsVoiceUser ausführen:
Test-CsVoiceUser -DialedNumber "+12065551219" -SipUri "sip:kenmyer@litwareinc.com" -Verbose
Wenn das Verbose-Cmdlet enthalten ist, wird Test-CsVoiceUser eine detaillierte Übersicht über alle Schritte ausgeben, die bei der Durchführung der Überprüfungen erforderlich sind. Beispielsweise können Schritte wie die folgenden angezeigt werden:
VERBOSE: Suchen eines Benutzers mit der Identität "sip:kenmyer@litwareinc.com"
AUSFÜHRLICH: Laden des Wählplans: "RedmondDialPlan"
Diese zusätzlichen Informationen können Hinweise zu den Schritten geben, die Sie ausführen können, um die Ursache des Fehlers zu bestimmen. Die hier gezeigte ausführliche Ausgabe gibt beispielsweise an, dass dem getesteten Benutzer der Wählplan "RedmondDialPlan" zugewiesen wurde. Wenn der Test fehlgeschlagen ist, besteht ein logischer nächster Schritt darin, zu überprüfen, ob RedmondDialPlan die angegebene Telefonnummer übersetzen kann.
Siehe auch