Testen der Fähigkeit zur Verwendung der Gruppenerweiterung 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-CsGroupExpansion-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-CsGroupExpansion"}

Beschreibung

Mit dem cmdlet Test-CsGroupExpansion können Sie bestimmen, ob die Gruppenerweiterung in Ihrer Organisation funktioniert. Wenn die Gruppenerweiterung aktiviert ist, konfigurieren Benutzer Verteilergruppen als Kontakt. Das bedeutet, dass diese Benutzer dann dieselbe Chatnachricht an alle Gruppenmitglieder senden können, indem sie die Nachricht an die Gruppe anstatt an einzelne Mitglieder dieser Gruppe adressieren. Mithilfe der Gruppenerweiterung können Sie schnell und einfach alle Gruppenmitglieder und deren aktuellen Status anzeigen.

Mit dem cmdlet Test-CsGroupExpansion geben Sie eine Active Directory-Verteilergruppe mithilfe der E-Mail-Adresse der Gruppe an. Test-CsGroupExpansion verwendet dann die Gruppenerweiterung, um die Gruppenmitgliedschaft abzurufen und die abgerufene Liste mit der Mitgliedschaft der von Ihnen angegebenen Gruppen-E-Mail-Adresse zu vergleichen. Wenn die beiden Listen übereinstimmen, funktioniert die Gruppenerweiterung ordnungsgemäß. Beachten Sie, dass Sie die Gruppenerweiterung auf zwei Arten testen können: durch Testen des Diensts selbst oder durch Testen des zugehörigen Webdiensts.

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

Ausführen des Tests

Das Test-CsGroupExpansion-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 FQDN des getesteten Lync Server-Pools und die E-Mail-Adresse für eine gültige Verteilergruppe angeben. Zum Beispiel: 

Test-CsGroupExpansion -TargetFqdn "atl-cs-001.litwareinc.com" -GroupEmailAddress "Sales@litwareinc.com"

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

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

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

Bestimmen von Erfolg oder Fehler

Wenn der angegebene Benutzer die Gruppenerweiterung verwenden kann, erhalten Sie eine ähnliche Ausgabe wie die folgende mit der Ergebniseigenschaft, die als Erfolg gekennzeichnet ist :

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

TargetFqdn: atl-cs-001.litwareinc.com

Ergebnis: Erfolg

Latenz: 00:00:01.1234976

Fehler:

Diagnose:

Wenn der angegebene Benutzer die Gruppenerweiterung nicht verwenden 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:

Diagnose:

Test-CsGroupExpansion: Der Endpunkt konnte nicht registriert werden. Sehen Sie sich den ErrorCode aus einem bestimmten Grund an.

Die vorherige Ausgabe gibt an, dass der Test fehlgeschlagen ist, weil der angegebene Benutzer nicht bei Lync Server registriert werden konnte. Dies tritt in der Regel auf, wenn das Testkonto nicht vorhanden ist oder für Lync Server nicht aktiviert wurde. Sie können überprüfen, ob das Konto vorhanden ist, und ermitteln, ob das Konto für nm-ocs-14-3rd aktiviert wurde, indem Sie einen Befehl wie den folgenden ausführen:

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

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

Test-CsGroupExpansion -TargetFqdn "atl-cs-001.litwareinc.com" -GroupEmailAddress "Sales@litwareinc.com" -Verbose

Wenn der Parameter "Verbose" enthalten ist, gibt Test-CsGroupExpansion ein schrittweises 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 die angegebene Verteilergruppe nicht gefunden werden konnte:

Versuchen Sie, ein Webticket abzurufen.

Webdienst-URL: https://atl-cs-001.litwareinc.com:443/WebTicket/WebTicketService.svc

Verwenden von NTLM/Kerb-Authentifizierung.

GetWebTicketActivity abgeschlossen.

Die "VerifyDistributionList"-Aktivität wurde gestartet.

DLX Web Service Response Status is: NotFound.

Die "VerifyDistributionList"-Aktivität wurde in "0,2597923" Sek. abgeschlossen.

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

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

  • Die Gruppenerweiterung ist möglicherweise deaktiviert. Es ist möglich, die Gruppenerweiterung zu deaktivieren. Wenn die Gruppenerweiterung deaktiviert wurde, schlägt das Test-CsGroupExpansion-Cmdlet fehl. Verwenden Sie einen Befehl wie den folgenden, um festzustellen, ob die Gruppenerweiterung aktiviert ist:

    Get-CsWebServiceConfiguration | Select-Object Identity, EnableGroupExpansion