Test-CsAddressBookService
Letztes Änderungsdatum des Themas: 2012-03-26
Testet die Fähigkeit eines Benutzers, auf den Server mit dem Adressbuch-Downloadwebdienst zuzugreifen.
Syntax
Test-CsAddressBookService -TargetFqdn <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsAddressBookService -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Test-CsAddressBookService [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Detaillierte Beschreibung
Test-CsAddressBookService ist ein Beispiel für eine "synthetische Transaktion". Anhand synthetischer Transaktionen wird in 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-CsAddressBookService kann überprüft werden, ob ein Benutzer eine Verbindung mit dem Adressbuch-Downloadwebdienst herstellen kann. Wenn Sie das Cmdlet ausführen, stellt Test-CsAddressBookService eine Verbindung mit dem Adressbuch-Downloadwebdienst im angegebenen Pool her und fordert den Speicherort der Adressbuchdateien an. Wenn der Adressbuch-Downloadwebdienst den Speicherort zurückgibt, wird der Test als erfolgreich betrachtet. Wenn die Anforderung abgelehnt wird, wird der Test als nicht erfolgreich betrachtet.
Es gibt zwei Möglichkeiten, den Adressbuch-Downloadwebdienst zu testen: Entweder testen Sie den Dienst selbst, oder Sie testen den zugeordneten Webdienst.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Test-CsAddressBookService auszuführen: RTCUniversalServerAdmins. 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-CsAddressBookService"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
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. Der folgende Code gibt beispielsweise ein Objekt mit Anmeldeinformationen für den Benutzer "litwareinc\kenmyer" zurück und speichert dieses Objekt in der 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 nicht angegeben ist, führt Test-CsAddressBookService die Prüfungen unter Verwendung des Kontos für den angemeldeten Benutzer durch. |
External |
Optional |
Switch-Parameter |
Ermöglicht Ihnen zu überprüfen, ob externe Benutzer den Adressbuch-Downloadwebdienst 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. |
TargetFqdn |
Optional |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des Registrierungspools, in dem sich der zu testende Adressbuch-Downloadwebdienst befindet. Beispiel: -TargetFqdn "atl-cs-001.litwareinc.com". Sie können die Parameter "TargetUri" und "TargetFqdn" nicht in demselben Befehl verwenden. |
TargetUri |
Optional |
Zeichenfolge |
Der URI (Uniform Resource Identifier) des Adressbuch-Webabfragediensts. Beispiel: -TargetUri "https://atl-cs-001.litwareinc.com/abs/handler". Sie können die Parameter "TargetUri" und "TargetFqdn" nicht in demselben Befehl verwenden. |
WebCredential |
Optional |
PS-Objekte 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 |
Erforderlich |
Switch-Parameter |
Gibt bei Ausführung des Cmdlets auf dem Bildschirm ausführliche Informationen zur Aktivität aus. |
Eingabetypen
Keine. Test-CsAddressBookService akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Test-CsAddressBookService wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsAddressBookService -TargetFqdn atl-cs-001.litwareinc.com
Im vorstehenden Beispiel wird der Adressbuch-Downloadwebdienst für den Pool "atl-cs-001.litwareinc.com" getestet. Dieser Befehl testet den Adressbuch-Downloadwebdienst mithilfe von Testbenutzern, die für den Pool "atl-cs-001.litwareinc.com" vorkonfiguriert wurden.
-------------------------- Beispiel 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsAddressBookService -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:kenmyer@litwareinc.com"
Die in Beispiel 2 gezeigten Befehle testen ebenfalls die Verfügbarkeit des Servers mit dem Adressbuch-Downloadwebdienst. 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-CsAddressBookService dazu verwendet, den Adressbuch-Downloadwebdienst 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". Zusätzlich muss Kens SIP-Adresse über den Parameter "UserSipAddress" bereitgestellt werden.
-------------------------- Beispiel 3 --------------------------
Test-CsAddressBookService -TargetUri https://atl-cs-001.litwareinc.com/abs/handler -UserSipAddress "sip:kenmyer@litwareinc.com"
Beispiel 3 zeigt, wie der Adressbuch-Downloadwebdienst für "atl-cs-001.litwareinc.com" getestet werden kann. Zu diesem Zweck wird Test-CsAddressBookService mit zwei Parametern aufgerufen: "TargetUri" gibt den URI des Adressbuch-Downloadwebdiensts an, und "UserSipAddress" enthält die Windows PowerShell-SIP-Adresse für das im Test verwendete Benutzerkonto.