Überprüfen der Adressbuchwebabfrage in Lync Server 2013

Beschreibung

Mit dem cmdlet Test-CsAddressBookWebQuery können Administratoren überprüfen, ob Benutzer den Adressbuch-Webabfragedienst verwenden können, um nach einem bestimmten Kontakt zu suchen. Wenn Sie das Cmdlet ausführen, stellt Test-CsAddressBookWebQuery zuerst eine Verbindung mit dem webticketdienst her, der authentifiziert werden soll. Wenn die Authentifizierung erfolgreich ist, stellt das Cmdlet dann eine Verbindung mit dem Adressbuch-Webabfragedienst her und sucht nach dem angegebenen Kontakt. Wenn dieser Kontakt gefunden wird, versucht das Cmdlet, diese Informationen an den lokalen Computer zurückzugeben. Der Test wird nur dann als erfolgreich markiert, wenn alle diese Schritte abgeschlossen werden können.

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

Ausführen des Tests

Das Test-CsAddressBookWebQuery-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 Lync Server-Pools und die SIP-Adresse des Benutzers angeben, der als Ziel der Suche fungiert. Zum Beispiel:

Test-CsAddressBookWebQuery -TargetFqdn "atl-cs-001.litwareinc.com" -TargetSipAddress "sip:davidlongmire@litwareinc.com"

Um diese Überprüfung mit einem tatsächlichen Benutzerkonto auszuführen, müssen Sie ein Windows PowerShell Anmeldeinformationenobjekt erstellen, das einen gültigen Benutzernamen und ein gültiges Kennwort enthält. Anschließend müssen Sie das Anmeldeinformationenobjekt und die DEM Konto zugewiesene SIP-Adresse einschließen, wenn der Code Test-CsAddressBookWebQuery aufruft:

$credential = Get-Credential "litwareinc\kenmyer"
Test-CsAddressBookWebQuery -TargetFqdn "atl-cs-001.litwareinc.com" -TargetSipAddress "sip:davidlongmire@litwareinc.com" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential

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

Bestimmen von Erfolg oder Fehler

Wenn der angegebene Benutzer eine Verbindung mit dem Adressbuchdienst herstellen und die Zielbenutzeradresse abrufen kann, geben Sie die Ausgabe ähnlich der folgenden zurück, wenn die Ergebniseigenschaft als Erfolgreich gekennzeichnet ist:

Targeturi: https://atl-cs-001.litwareinc.com:443/groupexpansion/service.svc

TargetFqdn: atl-cs-001.litwareinc.com

Ergebnis: Erfolg

Latenz: 00:00:06.2611356

Fehler:

Diagnose:

Wenn der angegebene Benutzer keine Verbindung herstellen kann oder die Zielbenutzeradresse nicht abgerufen werden kann, wird das Ergebnis als Fehler angezeigt, und zusätzliche Informationen werden in den Eigenschaften "Fehler" und "Diagnose" aufgezeichnet:

Targeturi: https://atl-cs-001.litwareinc.com:443/groupexpansion/service.svc

TargetFqdn: atl-cs-001.litwareinc.com

Ergebnis: Fehler

Latenz: 00:00:00

Fehler: Fehler bei der Anforderung des Adressbuchwebdiensts mit Antwortcode

NoEntryFound.

Diagnose:

In der vorherigen Ausgabe wird angegeben, dass der Test fehlgeschlagen ist, weil der Zielbenutzer nicht gefunden wurde. Sie können feststellen, ob eine gültige SIP-Adresse an Test-CsAddressBookWebQuery übergeben wurde, indem Sie einen Befehl wie den folgenden ausführen:

Get-CsUser | Where-Object {$_.SipAddress -eq "sip:davidlongmire@litwareinc.com"

Wenn Test-CsAddressBookWebQuery fehlschlägt, sollten Sie den Test erneut ausführen, dieses Mal einschließlich des Ausführlichen Parameters:

Test-CsAddressBookWebQuery -TargetFqdn "atl-cs-001.litwareinc.com" -TargetSipAddress "sip:davidlongmire@litwareinc.com" -Verbose

Wenn der Parameter "Verbose" enthalten ist, gibt Test-CsAddressBookWebQuery schrittweise ein Konto für jede Aktion zurück, die beim Überprüfen der Fähigkeit des angegebenen Benutzers, sich bei Lync Server anzumelden, versucht hat. Diese Ausgabe gibt beispielsweise an, dass Test-CsAddressBookWebQuery eine Verbindung mit dem Adressbuchdienst herstellen konnte, die ZIEL-SIP-Adresse jedoch nicht finden konnte:

Die Aktivität "QueryAddressBookWebService" wurde gestartet.

Aufrufen des Adressbuch-Webabfragediensts. ABWS-URL =

https://atl-cs-001.litwareinc.com:443/groupexpansion/service.svc

Ausnahme der Adressbuchabfrage: Fehler bei der Anforderung des Adressbuchwebdiensts mit dem Antwortcode "NoEntryFound".

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

Hier sind einige häufige Gründe, warum Test-CsAddressBookWebQuery 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. Um zu überprüfen, ob ein Benutzerkonto für Lync Server aktiviert wurde, führen Sie einen Befehl wie den folgenden aus:

  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.

• Der Zielbenutzer befindet sich möglicherweise nicht im Adressbuch.

• Das Adressbuch wurde möglicherweise nicht vollständig aktualisiert und repliziert. Sie können eine Aktualisierung aller Adressbuchserver in Ihrer Organisation erzwingen, indem Sie den folgenden Befehl ausführen:

  Update-CsAddressBook