Testen von Pushbenachrichtigungen auf Smartphones in Lync Server 2013

 

Letzte Änderung: 15.03.2017

Ü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-CsMcxPushNotification-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-CsMcxPushNotification"}

Beschreibung

Der Pushbenachrichtigungsdienst (Apple-Pushbenachrichtigungsdienst und Microsoft-Pushbenachrichtigungsdienst) kann Benachrichtigungen über Ereignisse wie neue Chatnachrichten oder neue Voicemail an mobile Geräte wie iPhones und Windows Phones senden, auch wenn der Lync-Client auf diesen Geräten derzeit angehalten oder im Hintergrund ausgeführt wird. Der Pushbenachrichtigungsdienst ist ein cloudbasierter Dienst, der auf Microsoft-Servern ausgeführt wird. Um Pushbenachrichtigungen nutzen zu können, müssen Sie in der Lage sein, eine Verbindung mit dem Pushbenachrichtigungs-Clearinghouse herzustellen und von diesem authentifiziert zu werden. Mit dem cmdlet Test-CsMcxPushNotification können Administratoren überprüfen, ob Pushbenachrichtigungsanforderungen über Ihren Edgeserver an das Pushbenachrichtigungs-Clearinghouse weitergeleitet werden können.

Ausführen des Tests

Rufen Sie zum Testen des Pushbenachrichtigungsdiensts das cmdlet Test-CsMcxPushNotification auf. Stellen Sie sicher, dass Sie den vollqualifizierten Domänennamen Ihres Edgeservers angeben:

Test-CsMcxPushNotification -AccessEdgeFqdn "atl-edge-001.litwareinc.com"

Weitere Informationen finden Sie im Hilfethema zum Cmdlet Test-CsMcxPushNotification .

Bestimmen von Erfolg oder Fehler

Wenn Test-CsMcxPushNotification erfolgreich ist, gibt das Cmdlet das Testergebnis "Erfolgreich" zurück:

TargetFqdn: atl-cs-001.litwareinc.com

Ergebnis: Erfolg

Latenz: 00:00:00

Fehler:

Diagnose:

Wenn Test-CsMcxPushNotification keine Verbindung mit dem Pushbenachrichtigungs-Clearinghouse herstellen kann, gibt das Cmdlet in der Regel kein Testergebnis des Fehlers zurück. Stattdessen schlägt der Befehl in der Regel vollständig fehl. Zum Beispiel:

Test-CsMcxPushNotification: Eine 504-Antwort (Servertimeout) wurde vom Netzwerk empfangen, und der Vorgang ist fehlgeschlagen. Weitere Informationen finden Sie in den Ausnahmedetails.

Bei Zeile:1 Zeichen:27

+ Test-CsMcxPushNotification <<<< -AccessEdgeFqdn lyncedge.mydomain.com

+ CategoryInfo : OperationStopped: (:) [Test-CsMcxPushNotification], FailureResponseException

+ FullyQualifiedErrorId : WorkflowNotCompleted,Microsoft.Rtc.Management.SyntheticTransactions.TestMcxPushNotificationCmdlet

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

Wenn der Pushbenachrichtigungsdienst fehlschlägt, gibt dies in der Regel entweder Probleme bei der Kommunikation mit Ihrem Edgeserver oder Probleme bei der Kommunikation mit dem Push Notification Clearing House an. Wenn beim Ausführen von Test-CsMcxPushNotification Probleme auftreten, sollten Sie zunächst überprüfen, ob Ihr Edgeserver ordnungsgemäß funktioniert. Eine Möglichkeit hierfür ist die Verwendung des cmdlets Test-CsAVEdgeConnectivity:

$credential = Get-Credential "litwareinc\kenmyer"

Test-CsAVEdgeConnectivity -TargetFqdn "atl-cs-001.litwareinc.com" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential

Bei dieser Überprüfung wird überprüft, ob ein angegebener Benutzer eine Verbindung mit dem Edgeserver herstellen kann.

Wenn der Edgeserver ordnungsgemäß funktioniert, bedeutet dies häufig, dass Sie keine Verbindung mit dem Clearinghouse für Pushbenachrichtigungen herstellen können. Dies bedeutet in der Regel, dass Sie entweder den Clearinghouse-URI nicht ordnungsgemäß konfiguriert haben oder keinen DNS SRV-Eintrag haben, der auf diese URL verweist. Sie können überprüfen, ob der URI auf den richtigen Wert (sip:push@push.lync.com) festgelegt ist, indem Sie den folgenden Befehl ausführen:

Get-CsMcxConfiguration

Wenn die PushNotificationProxyUri-Eigenschaft auf etwas anderes als sip festgelegt ist,push@push.lync.com können Sie dieses Problem mithilfe des cmdlets Set-McxConfiguration beheben. Mit diesem Befehl wird z. B. der URI in Der gesamten Organisation richtig festgelegt:

Get-CsMcxConfiguration | Set-CsMcxConfiguration -PushNotificationProxyUri "sip:push@push.lync.com"

Weitere Informationen finden Sie im Hilfethema zum Cmdlet Set-CsMcxConfiguration .

Wenn der URI ordnungsgemäß konfiguriert ist, sollten Sie im nächsten Schritt überprüfen, ob Sie über einen DNS SRV-Eintrag verfügen, der in Ihre SIP-Domäne und Ihren Edgeserver aufgelöst wird. Weitere Informationen zum Konfigurieren dieser Einträge finden Sie im Hilfethema "DNS-Anforderungen für Mobilität". Beachten Sie, dass die folgende Fehlermeldung in der Regel auf ein Problem mit DNS-Einträgen hinweist:

Eine 504-Antwort (Servertimeout) wurde vom Netzwerk empfangen, und der Vorgang ist fehlgeschlagen. Weitere Informationen finden Sie in den Ausnahmedetails.

Es ist auch möglich, dass Test-CsMcxConfiguration mit dieser Fehlermeldung fehlschlägt:

Test-CsMcxPushNotification: Pushbenachrichtigungsanforderung wurde abgelehnt.

Bei Zeile:1 Zeichen:27

+Test-CsMcxPushNotification <<<<

+ CategoryInfo : OperationStopped: (:) [Test-CsMcxPushNotification], SyntheticTransactionException

+ FullyQualifiedErrorId : WorkflowNotCompleted,Microsoft.Rtc.Management.SyntheticTransactions.TestMcxPushNotificationCmdlet

Die Meldung "Pushbenachrichtigungsanforderung wurde abgelehnt" tritt in der Regel auf, wenn Sie die URL-Filterung aktiviert haben und die Präfixe http: und https: blockieren. Sie können ermitteln, welche Präfixe blockiert werden, indem Sie einen Befehl wie den folgenden verwenden:

 (Get-CsImFilterConfiguration -Identity Global).Prefixes

Wenn http: oder https: in den Ergebnissen angezeigt wird, müssen Sie sie aus der Liste der blockierten Präfixe entfernen, damit Pushbenachrichtigungen funktionieren. Dies kann mithilfe von Befehlen erfolgen, die den folgenden ähneln:

Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{remove="http:"}
Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{remove="https:"}

Weitere Informationen finden Sie im Hilfethema für das Cmdlet Set-CsImFilterConfiguration.