Überprüfen des Adressbuchzugriffs in Lync Server 2013

  • Artikel

 

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-CsAddressBookService-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-CsAddressBookService"}

Beschreibung

Mit dem cmdlet Test-CsAddressBookService können Sie überprüfen, ob ein Benutzer eine Verbindung mit dem Adressbuch-Downloadwebdienst herstellen kann. Wenn Sie das Cmdlet ausführen, stellt Test-CsAddressBookService eine Verbindung mit dem Adressbuchdownloadwebdienst im angegebenen Pool her und fordert den Speicherort der Adressbuchdateien an. Wenn der Adressbuch-Downloadwebdienst diesen Speicherort bereitstellt, gilt der Test als erfolgreich. Wenn die Anforderung abgelehnt wird, wird der Test als Fehler betrachtet.

Ausführen des Tests

Das Test-CsAddressBookService-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 wurde. Um diese Überprüfung mit einem Testkonto auszuführen, müssen Sie lediglich den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des getesteten Lync Server-Pools angeben. Zum Beispiel: 

Test-CsAddressBookService -TargetFqdn "atl-cs-001.litwareinc.com"

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 beim Aufrufen von Test-CsAddressBookService dieses Anmeldeinformationsobjekt und die dem Konto zugewiesene SIP-Adresse einschließen:

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

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

Bestimmen von Erfolg oder Fehler

Wenn der angegebene Benutzer eine Verbindung mit dem Adressbuchdienst herstellen kann, erhalten Sie eine ähnliche Ausgabe wie die folgende, wobei die Ergebniseigenschaft als Erfolgreich gekennzeichnet ist:

Targeturi: https://lync-se.fabrikam.com:443/abs/handler

TargetFqdn: atl-cs-001.litwareinc.com

Ergebnis: Erfolg

Latenz: 00:00:06.2260399

Fehler:

Diagnose:

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

Targeturi:

TargetFqdn: atl-cs-001.litwareinc.com

Ergebnis: Fehler

Latenz: 00:00:00

Diagnose : ErrorCode=4005,Source=atl-cs-001.litwareinc.com,

Reason=Ziel-URI entweder nicht für SIP aktiviert oder nicht

Existieren.

Microsoft.Rtc.Signaling.DiagnosticHeader

In der vorherigen Ausgabe wird beispielsweise angegeben, dass der Test fehlgeschlagen ist, weil der angegebene Benutzer (d. h. der "Ziel-URI") entweder nicht vorhanden ist oder für Lync Server nicht aktiviert wurde. Sie können überprüfen, ob ein Benutzerkonto gültig ist, und überprüfen, ob Sie die richtige SIP-Adresse angegeben haben, indem Sie einen Befehl wie den folgenden ausführen:

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

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

Test-CsAddressBookService -TargetFqdn "atl-cs-001.litwareinc.com" -Ausführlich

Wenn der Parameter "Verbose" enthalten ist, gibt Test-CsAddressBookService 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 wird. Diese Beispielausgabe zeigt beispielsweise, dass Test-CsAddressBookService, zumindest in diesem Beispiel, die Adressbuchdatei herunterladen konnte:

Senden einer HTTP GET-Anforderung.

Dateipfad = https://atl-cs-001.litwareinc.com:443/abs/handler/f-1299.lsabs

Versuchsnummer = 1

TimeOut (ms) = 60000

Abs-Datei erfolgreich heruntergeladen https://atl-cs-001.litwareinc.com:443/abs/handler/f-1299.lsabs

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

Hier sind einige häufige Gründe, warum Test-CsAddressBookService 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.