Testen von Messaging mit XMPP in Lync Server 2013
Letztes Änderungsdatum des Themas: 2014-11-03
Überprüfungszeitplan |
Täglich |
Testtool |
Windows PowerShell |
Erforderliche Berechtigungen |
Bei lokaler Ausführung mithilfe der Lync Server-Verwaltungsshell müssen Benutzer Mitglieder der Sicherheitsgruppe RTCUniversalServerAdmins sein. Bei der Ausführung mit einer Remote-instance von Windows PowerShell muss Benutzern eine RBAC-Rolle zugewiesen werden, die über die Berechtigung zum Ausführen des Cmdlets Test-CsXmppIM 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
Das Extensible Messaging and Presence Protocol (XMPP) ist ein Standardkommunikationsprotokoll (basierend auf XML), das zum Senden von Nachrichten über das Internet verwendet wird. XMPP wurde ursprünglich Jabber genannt und wird von mehreren Internet-Messaging- und Kommunikationsanwendungen wie Google Talk und Facebook Chat unterstützt. Das Cmdlet Test-CsXmppIM überprüft, ob ein Benutzer Chatnachrichten mit einem Benutzer in einem XMPP-Netzwerk austauschen kann. Beachten Sie, dass Sie für einen erfolgreichen Test über eine gültige SIP-Adresse für den XMPP-Benutzer verfügen und dass sich diese SIP-Adresse in einem Netzwerk befinden muss, das als zulässiger XMPP-Partner konfiguriert wurde.
Ausführen des Tests
Im folgenden Beispiel werden die XMPP-Instant Messaging-Funktionen für den Pool atl-cs-001.litwareinc.com überprüft. Dieser Befehl funktioniert nur, wenn Testbenutzer für den Pool atl-cs-001.litwareinc.com definiert sind. Wenn ja, bestimmt der Befehl, ob der erste Testbenutzer eine XMPP-Chatnachricht an einen Benutzer senden kann, der über die SIP-Adresse verfügt adelaney@contoso.com.
Wenn Testbenutzer nicht definiert sind, schlägt der Befehl fehl, da er nicht weiß, unter welchem Benutzer er sich anmelden soll. Wenn Sie keine Testbenutzer für einen Pool definiert haben, müssen Sie den UserSipAddress-Parameter und die Anmeldeinformationen des Benutzers einschließen, den der Befehl bei der Anmeldung verwenden soll.
Test-CsXmppIM -TargetFqdn "atl-cs-001.litwareinc.com" -Receiver "adelany@contoso.com"
Die im nächsten Beispiel gezeigten Befehle testen die Fähigkeit eines bestimmten Benutzers (litwareinc\pilar), sich anzumelden, um eine XMPP-Sofortnachricht an den Benutzer adelaney@contoso.comzu senden. Dazu verwendet der erste Befehl im Beispiel das Cmdlet Get-Credential, um ein Windows PowerShell Anmeldeinformationsobjekt der Befehlszeilenschnittstelle zu erstellen, das den Namen und das Kennwort des Benutzers Pilar Ackerman enthält. (Da der Anmeldename litwareinc\pilar als Parameter enthalten war, muss der Administrator im Dialogfeld Windows PowerShell Anmeldeinformationsanforderung nur das Kennwort für das Pilar Ackerman-Konto eingeben.) Das resultierende Anmeldeinformationsobjekt wird dann in einer Variablen mit dem Namen $cred 1 gespeichert.
Der zweite Befehl überprüft dann, ob sich dieser Benutzer beim Pool anmelden kann, atl-cs-001.litwareinc.com und die XMPP-Sofortnachricht senden kann. Zum Ausführen dieser Aufgabe wird das Cmdlet Test-CsXmppIm zusammen mit vier Parametern aufgerufen: TargetFqdn (der FQDN des Registrierungsstellenpools); Empfänger (die SIP-Adresse des Benutzers, an den die Nachricht adressiert wird); UserCredential (das Windows PowerShell-Objekt, das die Benutzeranmeldeinformationen von Pilar Ackerman enthält) und UserSipAddress (die SIP-Adresse, die den angegebenen Benutzeranmeldeinformationen entspricht).
$credential = Get-Credential "litwareinc\kenmyer"
Test-CsXmppIM -TargetFqdn "atl-cs-001.litwareinc.com" -Receiver "adelany@contoso.com" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential
Bestimmen von Erfolg oder Misserfolg
Wenn XMPP-Instant Messaging ordnungsgemäß konfiguriert ist, erhalten Sie eine Ausgabe ähnlich der folgenden, wobei die Result-Eigenschaft als Erfolg gekennzeichnet ist:
Ziel-Fqdn: atl-cs-001.litwareinc.com
Ergebnis: Erfolg
Latenz: 00:00:02.5361946
Fehlermeldung:
Diagnose:
Wenn die angegebenen Benutzer XMPP-Chatnachrichten nicht verwenden können, wird das Ergebnis als Fehler angezeigt, und zusätzliche Informationen werden in den Eigenschaften Fehler und Diagnose aufgezeichnet:
WARNUNG: Fehler beim Lesen der Registrierungsstellenportnummer für die angegebene vollqualifizierte
Domänenname (FQDN). Verwenden der Standardportnummer der Registrierungsstelle. Ausnahme:
System.InvalidOperationException: In der Topologie wurde kein übereinstimmender Cluster gefunden.
Auf
Microsoft.Rtc.Management.SyntheticTransactions.SipSyntheticTransaction.TryRetri
eveRegistrarPortFromTopology(Int32& registrarPortNumber)
Ziel-Fqdn: atl-cs-001.litwareinc.com
Ergebnis: Fehler
Latenz: 00:00:00
Fehlermeldung: 10060, Ein Verbindungsversuch ist fehlgeschlagen, weil die verbundene Partei
nach einem bestimmten Zeitraum nicht ordnungsgemäß reagiert hat, oder
Fehler bei der hergestellten Verbindung, weil der verbundene Host über
Fehler beim Antworten von 10.188.116.96:5061
Innere Ausnahme: Ein Verbindungsversuch ist fehlgeschlagen, weil
Die verbundene Partei hat nach einem Zeitraum von
Zeitpunkt oder Verbindungsaufbau fehlgeschlagen, weil der verbundene Host
hat nicht reagiert 10.188.116.96:5061
Diagnose:
Gründe, warum der Test möglicherweise fehlgeschlagen ist
Im Folgenden finden Sie einige häufige Gründe, warum Test-CsXmppIM fehlschlägt:
Ein falscher Parameterwert wurde angegeben. Bei Verwendung müssen die optionalen Parameter ordnungsgemäß konfiguriert werden, andernfalls schlägt der Test fehl. Führen Sie den Befehl ohne die optionalen Parameter erneut aus, und überprüfen Sie, ob dies erfolgreich ist.
Dieser Befehl schlägt fehl, wenn die XMPP-Gatewaykonfiguration falsch konfiguriert oder noch nicht bereitgestellt wurde.
Siehe auch