Testen der Telefonnummer für eine VoIP-Route 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-CsVoiceRoute-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:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Test-CsVoiceRoute"}

Beschreibung

VoIP-Routen arbeiten mit VoIP-Richtlinien zusammen, um Enterprise-VoIP Anrufe an das PSTN-Netzwerk weiterzuleiten. Jede VoIP-Route enthält einen regulären Ausdruck (ein Nummernmuster), der die Telefonnummern identifiziert, die über eine bestimmte VoIP-Route weitergeleitet werden: Die Route kann alle Telefonnummern verarbeiten, die diesem regulären Ausdruck entsprechen. Beispielsweise kann eine VoIP-Route einen regulären Ausdruck aufweisen, mit dem eine beliebige 10-stellige Nummer verarbeitet werden kann. Dies bedeutet, dass die Route in der Lage wäre, eine Telefonnummer wie die folgende zu behandeln:

  • 2065551219

Die Route wäre nicht in der Lage, eine der folgenden beiden Zahlen zu verarbeiten, von denen keine 10 Ziffern enthält:

  • 5551219

  • 12065551219

Das cmdlet Test-CsVoiceRoute überprüft, ob eine bestimmte VoIP-Route eine angegebene Telefonnummer weiterleiten kann.

Ausführen des Tests

Die Überprüfung der Fähigkeit einer VoIP-Route, eine angegebene Telefonnummer weiterzuleiten, ist ein zweistufiger Prozess. Zuerst müssen Sie das cmdlet Get-CsVoiceRoute verwenden, um eine Instanz dieser VoIP-Route zurückzugeben, und dann müssen Sie das cmdlet Test-CsVoiceRoute verwenden, um die Fähigkeit dieser Route zu überprüfen, die Zieltelefonnummer zu behandeln. Mit diesem Befehl wird beispielsweise überprüft, ob die RedmondVoiceRoute-VoIP-Route die Telefonnummer 2065551219 weiterleiten kann:

Get-CsVoiceRoute -Identity "RedmondVoiceRoute" | Test-CsVoiceRoute -TargetNumber "2065551219"

Beachten Sie, dass die Telefonnummer so eingegeben werden sollte, wie Sie erwarten, dass Benutzer diese Nummer wählen. Wenn Sie beispielsweise nicht erwarten, dass Benutzer die Landes- und Vorwahl bei der Einwahl einschließen, verwenden Sie eine ähnliche Syntax wie die folgende:

-TargetNumber "5551219"

In diesem Fall lässt die Zielnummer sowohl die Ländervorwahl als auch die Vorwahl aus.

Wenn Sie einen einzelnen Befehl verwenden möchten, um alle VoIP-Routen anhand einer angegebenen Zielnummer zu testen, verwenden Sie eine Syntax wie die folgende:

Get-CsVoiceRoute | Test-CsVoiceRoute -TargetNumber "2065551219"

Weitere Informationen finden Sie in der Hilfedokumentation zum cmdlet Test-CsVoiceRoute.

Bestimmen von Erfolg oder Fehler

Wenn die VoIP-Route die Zieltelefonnummer weiterleiten kann, gibt das cmdlet Test-CsVoiceRoute nur den Wert True zurück:

MatchesPattern

--------------

Wahr

Dies bedeutet, dass die Route Zahlen verarbeiten kann, die der Zielnummer ähneln. Wenn die VoIP-Route die Zielnummer nicht verarbeiten kann, gibt Test-CsVoiceRoute den Wert False zurück:

MatchesPattern

--------------

Falsch

Gründe, warum der Test möglicherweise fehlgeschlagen ist

Beim Testen von VoIP-Routen ist "Failure" ein relativer Begriff. In diesem Fall bedeutet dies nicht, dass die Route irgendwie "fehlerhaft" ist. Stattdessen bedeutet dies lediglich, dass die Route die Zielnummer nicht verarbeiten kann. Dies könnte daran zurückzuführen sein, dass die VoIP-Route falsch konfiguriert wurde. Dies könnte auch bedeuten, dass die Route niemals dazu bestimmt war, Nummern mit diesem Muster zu verarbeiten. Wenn Sie beispielsweise Anrufe nicht über eine bestimmte Route in andere Länder weiterleiten möchten, ist diese Route möglicherweise so konfiguriert, dass alle Telefonnummern abgelehnt werden, die eine Ländervorwahl enthalten. Wenn Test-CsVoiceRoute "False" zurückgibt, wenn Sie erwartet haben, dass "True" zurückgegeben wird, vergewissern Sie sich, dass Sie die Zielnummer richtig eingegeben haben. Wenn Sie dies getan haben, verwenden Sie einen Befehl ähnlich dem folgenden, um die für die Route konfigurierte NumberPattern anzuzeigen:

Get-CsVoiceRoute -Identity "RedmondVoiceRoute" | Select-Object NumberPattern

Siehe auch

Test-CsVoiceRoute