Testen von PSTN-Telefonanrufen in Lync Server 2013

 

Letzte Änderung: 05.06.2014

Überprüfungszeitplan

Täglich

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-CsRegistration-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-CsPstnOutboundCall"}

Beschreibung

Das cmdlet Test-CsPstnOutboundCall testet die Fähigkeit eines Benutzers, einen Anruf an eine Telefonnummer im PSTN zu tätigen. Wenn Sie Test-CsPstnOutboundCall ausführen, versucht das Cmdlet zunächst, den Testbenutzer bei Lync Server zu protokollieren. Wenn die Anmeldung erfolgreich ist, versucht das Cmdlet, einen Telefonanruf über das PSTN-Gateway zu tätigen. Dieser Telefonanruf erfolgt mithilfe des Wählplans, der VoIP-Richtlinie und anderer Richtlinien und Einstellungen, die dem Testkonto zugewiesen sind. Wenn der Anruf angenommen wird, sendet das Cmdlet DTMF-Codes (Dual-Tone Multi-Frequency) über das Netzwerk, um die Medienkonnektivität zu überprüfen.

Bei der Durchführung des Tests führt Test-CsPstnOutboundCall einen tatsächlichen Telefonanruf durch: Das Zieltelefon klingelt und muss beantwortet werden, damit der Test erfolgreich ist. Dieser Aufruf muss auch manuell vom Administrator beendet werden.

Ausführen des Tests

Das Test-CsPstnOutboundCall-Cmdlet kann entweder mit einem vorkonfigurierten Testkonto (siehe Einrichten von Testkonten zum Ausführen von Lync Server-Tests) oder mit dem Konto eines benutzers ausgeführt werden, der für Lync Server aktiviert ist. Um diese Überprüfung mit einem Testkonto auszuführen, müssen Sie lediglich den FQDN des getesteten Lync Server-Pools und die angerufene PSTN-Telefonnummer angeben. Zum Beispiel:

Test-CsPstnOutboundCall -TargetFqdn "atl-cs-001.litwareinc.com" -TargetPstnPhoneNumber "+12065551219"

Um diese Überprüfung mit einem tatsächlichen Benutzerkonto auszuführen, müssen Sie zuerst ein Windows PowerShell Anmeldeinformationenobjekt erstellen, das den Kontonamen und das Kennwort enthält. Anschließend müssen Sie das Anmeldeinformationsobjekt und die dem Konto zugewiesene SIP-Adresse einschließen, wenn Sie Test-CsPstnOutboundCall aufrufen:

$credential = Get-Credential "litwareinc\kenmyer"
Test-CsPstnOutboundCall -TargetFqdn "atl-cs-001.litwareinc.com" -TargetPstnPhoneNumber "+12065551219" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential

Weitere Informationen finden Sie in der Hilfedokumentation für das Cmdlet Test-CsPstnOutboundCall .

Bestimmen von Erfolg oder Fehler

Wenn der angegebene Benutzer den Anruf tätigen kann und der Anruf angenommen wird, erhalten Sie eine ähnliche Ausgabe wie die folgende, wobei die Ergebniseigenschaft als "Erfolgreich" gekennzeichnet ist:

TargetFqdn: atl-cs-001.litwareinc.com

Ergebnis: Erfolg

Latenz: 00:00:06.8630376

Fehler:

Diagnose:

Wenn der angegebene Benutzer den Anruf nicht tätigen kann oder der Anruf nicht angenommen wird, wird das Ergebnis als "Fehler" angezeigt, und zusätzliche Informationen werden in den Eigenschaften "Fehler" und "Diagnose" aufgezeichnet:

TargetFqdn: atl-cs-001.litwareinc.com

Ergebnis: Fehler

Latenz: 00:00:0987365

Fehler: 403, Verboten

Diagnose : ErrorCode=12001,Source=atl-cs-001.litwareinc.com,Reason=User

Richtlinie enthält keine Nutzung von Telefonrouten

In der vorherigen Ausgabe wird angegeben, dass der Test fehlgeschlagen ist, da die dem angegebenen Benutzer zugewiesene VoIP-Richtlinie keine Telefonnutzung enthält. (Telefonnutzungen binden VoIP-Richtlinien mit VoIP-Routen. Ohne eine VoIP-Richtlinie und eine entsprechende VoIP-Route können Sie keine Anrufe über das PSTN tätigen.)

Wenn Test-CsPstnOutboundCall fehlschlägt, möchten Sie den Test möglicherweise erneut ausführen, dieses Mal einschließlich des Verbose-Parameters:

Test-CsPstnOutboundCall -TargetFqdn "atl-cs-001.litwareinc.com" -TargetPstnPhoneNumber "+12065551219" -Verbose

Wenn der Parameter "Verbose" enthalten ist, gibt Test-CsPstnOutboundCall schrittweise ein Konto für jede Aktion zurück, die versucht wurde, als die Fähigkeit des angegebenen Benutzers überprüft wurde, sich bei Lync Server anzumelden. Diese Ausgabe gibt beispielsweise an, dass Netzwerkprobleme eine Verbindung mit dem PSTN verhindern:

Einrichten eines Audiovideoanrufs für "sip:+12065551219@litwareinc.com;user=phone".

Eine Ausnahme 'A 404 (Not Found) response was received from the network and the operation failed.

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

Hier sind einige häufige Gründe, warum Test-CsPstnOutboundCall möglicherweise fehlschlägt:

  • Sie haben ein ungültiges Benutzerkonto angegeben. Sie können überprüfen, ob ein Benutzerkonto vorhanden ist, indem Sie einen Befehl wie den folgenden ausführen:

    Get-CsUser "sip:kenmyer@litwareinc.com"
    
  • Das Benutzerkonto ist gültig, aber das Konto ist derzeit nicht für Lync Server aktiviert. Führen Sie einen Befehl wie den folgenden aus, um zu überprüfen, ob ein Benutzerkonto für Lync Server aktiviert ist:

    Get-CsUser "sip:kenmyer@litwareinc.com" | Select-Object Enabled
    

    Wenn die Enabled-Eigenschaft auf "False" festgelegt ist, bedeutet dies, dass der Benutzer derzeit nicht für Lync Server aktiviert ist.

  • Die voIP-Richtlinie, die dem angegebenen Benutzer zugewiesen ist, hat keine gültige PSTN-Verwendung. Sie können die VoIP-Richtlinie bestimmen, die einem Benutzer zugewiesen ist, indem Sie einen Befehl wie den folgenden verwenden:

    Get-CsUser "sip:kenmyer@litwareinc.com" | Select-Object VoicePolicy
    

    Anschließend können Sie die PSTN-Verwendungen (falls vorhanden) ermitteln, die dieser Richtlinie zugewiesen sind, indem Sie einen Befehl wie den folgenden verwenden, der Informationen zur benutzerspezifischen VoIP-Richtlinie "RedmondVoicePolicy" abruft:

    Get-CsVoicePolicy -Identity "RedmondVoicePolicy"