Test-CsAddressBookWebQuery
Letztes Änderungsdatum des Themas: 2012-03-25
Testet, ob ein Benutzer unter Verwendung des Adressbuch-Webabfragediensts nach Informationen im Adressbuch suchen und diese Informationen zurückgeben kann.
Syntax
Test-CsAddressBookWebQuery -TargetFqdn <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetSipAddress <String>] [-UserSipAddress <String>]
Test-CsAddressBookWebQuery -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-TargetSipAddress <String>] [-WebCredential <PSCredential>]
Test-CsAddressBookWebQuery [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetSipAddress <String>]
Detaillierte Beschreibung
Test-CsAddressBookWebQuery ist ein Beispiel für eine "synthetische Transaktion". Anhand synthetischer Transaktionen wird in Microsoft Lync Server 2010 überprüft, ob Benutzer allgemeine Aufgaben wie z. B. das Anmelden beim System, das Austauschen von Sofortnachrichten oder das Tätigen von Anrufen im Telefonfestnetz (Public Switched Telephone Network, PSTN) erfolgreich durchführen können. Diese Tests können manuell von einem Administrator oder automatisch von einer Anwendung wie Microsoft System Center Operations Manager (früher Microsoft Operations Manager) durchgeführt werden.
Synthetische Transaktionen werden in der Regel auf zwei unterschiedliche Arten ausgeführt. Viele Administratoren verwenden die CsHealthMonitoringConfiguration-Cmdlets, um für jeden Registrierungspool Testbenutzer einzurichten. Bei diesen Testbenutzern handelt es sich um ein Benutzerpaar, das für synthetische Transaktionen vorkonfiguriert wurde. (Dies sind in der Regel Testkonten und keine Konten von tatsächlich vorhandenen Benutzern.) Administratoren können mithilfe von Testbenutzern, die für einen Pool konfiguriert wurden, eine synthetische Transaktion für diesen Pool durchführen, ohne die Identitätswerte (und die Anmeldeinformationen) der für den Test verwendeten Benutzerkonten anzugeben.
Administratoren können eine synthetische Transaktion allerdings auch mit tatsächlichen Benutzerkonten ausführen. Wenn zwei Benutzer beispielsweise Sofortnachrichten austauschen, kann ein Administrator eine synthetische Transaktion mit diesen zwei Benutzerkonten (anstelle von zwei Testkonten) durchführen und versuchen, das Problem zu diagnostizieren und zu beheben. Denken Sie beim Ausführen einer synthetischen Transaktion mit tatsächlichen Benutzerkonten daran, dass Sie den Anmeldenamen und das Kennwort jedes Benutzers angeben müssen.
Mit dem Cmdlet Test-CsAddressBookWebQuery können Administratoren prü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 zur Authentifizierung zunächst eine Verbindung mit dem Webticketdienst her. Ist die Authentifizierung erfolgreich, stellt das Cmdlet eine Verbindung mit dem Adressbuch-Webabfragedienst her und sucht nach dem angegebenen Kontakt. Wird der Kontakt gefunden, versucht das Cmdlet, diese Informationen an den lokalen Computer zurückzugeben. Der Test wird nur dann als erfolgreich betrachtet, wenn alle Schritte durchgeführt werden können.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsAddressBookWebQuery"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
TargetFqdn |
Erforderlich |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des Registrierungspools, in dem sich der zu testende Adressbuch-Webabfragedienst befindet. Beispiel: -TargetFqdn "atl-cs-001.litwareinc.com". Beachten Sie, dass die Parameter "TargetUri" und "TargetFqdn" nicht im gleichen Befehl verwendet werden können. |
TargetSipAddress |
Erforderlich |
SIP-Adresse |
SIP-Adresse des Kontakts, der durch den Adressbuch-Webabfragedienst zurückgegeben werden soll. Beispiel: -TargetSipAddress "sip:kenmyer@litwareinc.com". |
TargetUri |
Erforderlich |
Zeichenfolge |
Der URI (Uniform Resource Identifier) des Adressbuch-Webabfragediensts. Beispiel: -TargetUri "https://atl-cs-001.litwareinc.com/groupexpansion". Beachten Sie, dass die Parameter "TargetUri" und "TargetFqdn" nicht im gleichen Befehl verwendet werden können. |
UserCredential |
Erforderlich |
PS-Objekt mit Anmeldeinformationen |
Objekt mit Anmeldeinformationen für das Benutzerkonto, das im Test verwendet werden soll. Bei dem an "UserCredential" übergebenen Wert muss es sich um einen Objektverweis handeln, der mit dem Cmdlet Get-Credential abgerufen wurde. Beispiel: Dieser Code gibt ein Anmeldeinformationsobjekt für den Benutzer "itwareinc\kenmyer" zurück und speichert dieses Objekt in der folgenden Variablen: $x: $x = Get-Credential "litwareinc\kenmyer" Sie müssen beim Ausführen dieses Befehls das Benutzerkennwort angeben. |
UserSipAddress |
Erforderlich |
SIP-Adresse |
SIP-Adresse des Benutzers, der im Test verwendet wird. Wenn dieser Parameter ausgelassen wird, führt das Cmdlet Test-CsAddressBookWebQuery die Überprüfungen anhand der Konfigurationseinstellungen für die Integrationsüberwachung für den getesteten Pool durch. |
External |
Optional |
Switch-Parameter |
Ermöglicht Ihnen zu überprüfen, ob externe Benutzer den Adressbuch-Webabfragedienst verwenden können. |
RegistrarPort |
Optional |
Ganze Zahl |
Der vom Registrierungsdienst verwendete SIP-Port. Dieser Parameter ist nicht erforderlich, wenn die Registrierung den Standardport 5061 verwendet. |
WebCredential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Ein Objekt mit den Benutzeranmeldeinformationen für den Zugriff auf den Standortinformationsdienst. Dieses Objekt kann abgerufen werden, indem Sie das Cmdlet Get-Credential aufrufen und die entsprechenden Anmeldeinformationen angeben. Dieser Parameter ist erforderlich, wenn die Parameter "TargetUri" und "UserSipAddress" angegeben werden und wenn der Computer, auf dem Sie den Befehl ausführen, kein Serverzertifikat besitzt. |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
OutVerboseVariable |
Optional |
Zeichenfolge |
Falls angegeben, wird nach Ausführung des Cmdlets die detaillierte Ausgabe in der angegebenen Variablen gespeichert. Geben Sie beispielsweise die folgende Syntax an, um die Ausgabe in der Variablen "$Testausgabe" zu speichern: -OutVerboseVariable Testausgabe Setzen Sie kein Dollarzeichen ($) vor den Variablennamen. |
Verbose |
Optional |
Switch-Parameter |
Gibt bei Ausführung des Cmdlets auf dem Bildschirm ausführliche Informationen zur Aktivität aus. |
Eingabetypen
Keine. Test-CsAddressBookWebQuery akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Test-CsAddressBookWebQuery wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsAddressBookWebQuery -TargetFqdn atl-cs-001.litwareinc.com -TargetSipAddress "sip:kenmyer@litwareinc.com"
Im vorstehenden Beispiel wird der Adressbuch-Webabfragedienst für den Pool "atl-cs-001.litwareinc.com" getestet, indem nach dem Kontakt mit der SIP-Adresse "sip:kenmyer@litwareinc.com" gesucht wird. Dieser Befehl funktioniert nur, wenn für den Pool "atl-cs-001.litwareinc.com" Testbenutzer definiert wurden. Trifft dies zu, wird der Befehl mit den Anmeldeinformationen des ersten Testbenutzers für diesen Pool ausgeführt.
Wurden keine Testbenutzer definiert, tritt bei der Befehlsausführung ein Fehler auf. Wenn Sie keine Testbenutzer für einen Pool definiert haben, müssen Sie den Parameter "UserSipAddress" und die Anmeldeinformationen des Benutzers verwenden, in dessen Namen der Befehl ausgeführt werden soll.
-------------------------- Beispiel 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsAddressBookWebQuery -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:kenmyer@litwareinc.com" -TargetSipAddress "sip:kenmyer@litwareinc.com"
Die in Beispiel 2 gezeigten Befehle testen ebenfalls die Verfügbarkeit des Adressbuch-Webabfragediensts. In diesem Fall werden die Befehle jedoch unter Verwendung der Anmeldeinformationen für den Benutzer "Ken Myer" (litwareinc\kenmyer) ausgeführt. Hierzu verwendet der erste Befehl das Cmdlet Get-Credential, um ein Windows PowerShell-Objekt mit Anmeldeinformationen zu erstellen, das den Namen und das Kennwort des Benutzers "Ken Myer" enthält. (Da der Anmeldename "litwareinc\kenmyer" als Parameter angegeben ist, muss der Administrator im Dialogfeld "Bei Windows PowerShell anmelden" lediglich das Kennwort für das Konto "Ken Myer" eingeben.) Das resultierende Objekt mit Anmeldeinformationen wird dann in der Variablen "$cred1" gespeichert.
Im zweiten Befehl wird Test-CsAddressBookWebQuery dazu verwendet, den Adressbuch-Webabfragedienst für den Pool "atl-cs-001.litwareinc.com" zu testen. Zur Ausführung dieses Befehls mit den Anmeldeinformationen des Benutzers Ken Myer wird der Parameter "UserCredential" eingeschlossen, zusammen mit dem Parameterwert "$cred1". Der Befehl verwendet außerdem "TargetSipAddress", um anzugeben, dass das Cmdlet das Adressbuch nach dem Kontakt mit der SIP-Adresse "sip:kenmyer@litwareinc.com" durchsuchen soll.
-------------------------- Beispiel 3 --------------------------
Test-CsAddressBookWebQuery -TargetUri https://atl-cs-001.litwareinc.com/groupexpansion -UserSipAddress "sip:packerman@litwareinc.com" -TargetSipAddress "sip:kenmyer@litwareinc.com"
Beispiel 3 zeigt, wie der Adressbuch-Webabfragedienst für "atl-cs-001.litwareinc.com" getestet werden kann. Zu diesem Zweck wird Test-CsAddressBookWebQuery mit drei Parametern aufgerufen: "TargetUri" gibt den URI des Adressbuch-Webabfragediensts an, "UserSipAddress" enthält die Windows PowerShell-SIP-Adresse des im Test verwendeten Benutzerkontos und "TargetSipAddress" enthält die SIP-Adresse des gesuchten Benutzerkontos.