Freigeben über


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.

Siehe auch

Weitere Ressourcen

Test-CsAddressBookService
Update-CsAddressBook