Test-CsRegistration
Letztes Änderungsdatum des Themas: 2012-03-26
Testet, ob der Benutzer sich bei Microsoft Lync Server 2010 anmelden kann. Test-CsRegistration ist eine "synthetische Transaktion", d. h. eine Simulation gängiger Lync Server 2010-Aktivitäten, die zur Integritäts- und Leistungsüberwachung verwendet werden.
Syntax
Test-CsRegistration -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsRegistration [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Detaillierte Beschreibung
Test-CsRegistration ist ein Beispiel einer "synthetischen Transaktion" in Lync Server. Anhand synthetischer Transaktionen wird in Lync Server ü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 den zwei betreffenden 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-CsRegistration können Sie überprüfen, ob Benutzer in Ihrer Organisation sich bei Lync Server anmelden können. Für Test-CsRegistration ist ein Testkonto erforderlich, um diese Überprüfung durchführen zu können. Wenn Sie Testbenutzer für den Pool eingerichtet haben, für den der Test durchgeführt werden soll, müssen Sie kein Konto angeben. Test-CsRegistration verwendet automatisch die ersten Testkonten, die dem Pool zugewiesen wurden. (Einzelheiten finden Sie im Hilfethema New-CsHealthMonitoringConfiguration.) Sie können den Test alternativ mit einem Konto durchführen, das dem Pool nicht zugewiesen wurde. So können Sie Tests selbst dann ausführen, wenn Sie keine Testbenutzer konfiguriert haben. Sie können außerdem überprüfen, ob ein bestimmter Benutzer sich bei Lync Server anmelden kann. (Wenn Sie sich für diese Methode entscheiden, müssen Sie den Benutzernamen und das Kennwort für das Konto bereitstellen, das getestet werden soll.)
Wenn Test-CsRegistration ausgeführt wird, versucht das Cmdlet, den Testbenutzer bei Lync Server anzumelden. Bei Erfolg wird dieser Testbenutzer anschließend vom System getrennt. Dies wird ohne Benutzereingriff und ohne Auswirkungen auf tatsächlich vorhandene Benutzer durchgeführt. Beispiel: Das Testkonto "sip:kenmyer@litwareinc.com" entspricht einem realen Benutzer mit einem tatsächlichen Lync Server-Konto. In diesem Fall wird der Test ohne Unterbrechungen für Ken Myer durchgeführt. Wenn sich das Testkonto "Ken Myer" vom System abmeldet, bleibt die Person "Ken Myer" weiterhin angemeldet.
Durch das Hinzufügen des Parameters "Verbose" erhalten Sie eine ausführliche Übersicht über alle Aktionen, die von Test-CsRegistration während des Tests durchgeführt wurden.
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-CsRegistration"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
TargetFqdn |
Erforderlich |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des zu testenden Pools. |
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. |
RegistrarPort |
Optional |
Ganze Zahl |
Der vom Registrierungsdienst verwendete SIP-Port. Dieser Parameter ist nicht erforderlich, wenn die Registrierung den Standardport 5061 verwendet. |
UserCredential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Objekt mit Anmeldeinformationen für das Konto, das getestet wird. Der Wert, der an "UserCredential" übergeben wird, muss ein Objektverweis sein, der durch die Verwendung des Cmdlets 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. Dieser Parameter ist nicht erforderlich, wenn Sie den Test mit den Konfigurationseinstellungen für die Integritätsüberwachung des Pools ausführen. |
UserSipAddress |
Optional |
SIP-Adresse |
SIP-Adresse für das Benutzerkonto, das getestet wird. Beispiel: -UserSipAddress "sip:kenmyer@litwareinc.com". Der Parameter "UserSipAddress" muss auf dasselbe Benutzerkonto wie "UserCredential" verweisen. Dieser Parameter ist nicht erforderlich, wenn Sie den Test mit den Konfigurationseinstellungen für die Integritätsüberwachung des Pools ausführen. |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
Verbose |
Optional |
Switch-Parameter |
Gibt bei Ausführung des Cmdlets auf dem Bildschirm ausführliche Informationen zur Aktivität aus. |
Eingabetypen
Keine. Test-CsRegistration akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Test-CsRegistration gibt eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurück.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com
Im vorstehenden Beispiel wird der Registrierungsdienst für den Pool "atl-cs-001.litwareinc.com" getestet. Dieser Befehl funktioniert nur, wenn Testbenutzer für den Pool "atl-cs-001.litwareinc.com" definiert wurden. Wenn dies der Fall ist, wird anschließend mit dem Befehl festgelegt, ob sich der erste Testbenutzer bei Lync Server anmelden kann.
Wenn keine Testbenutzer definiert wurden, tritt beim Befehl ein Fehler auf, da nicht bekannt ist, welcher Benutzer angemeldet werden soll. Wenn Sie keine Testbenutzer für einen Pool definiert haben, müssen Sie den Parameter "UserSipAddress" und die Anmeldeinformationen des Benutzers verwenden, die der Befehl für die Anmeldung verwenden soll.
-------------------------- Beispiel 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred1 -UserSipAddress "sip:pilar@litwareinc.com"
Mit dem Befehl in Beispiel 2 wird getestet, ob sich ein bestimmter Benutzer (litwareinc\pilar) bei Lync Server anmelden kann. Hierzu verwendet der erste Befehl im Beispiel das Cmdlet Get-Credential, um ein Windows PowerShell-Objekt mit Anmeldeinformationen zu erstellen, das den Namen und das Kennwort des Benutzers "Pilar Ackerman" enthält. (Da der Anmeldename "litwareinc\pilar" als Parameter angegeben ist, muss der Administrator im Dialogfeld "Bei Windows PowerShell anmelden" lediglich das Kennwort für das Konto "Pilar Ackerman" eingeben.) Das resultierende Objekt mit Anmeldeinformationen wird dann in der Variablen "$cred1" gespeichert.
Der zweite Befehl prüft anschließend, ob sich dieser Benutzer beim Pool "atl-cs-001.litwareinc.com" anmelden kann. Dazu werden mit dem Befehl zunächst Test-CsRegistration und drei Parameter aufgerufen: "TargetFqdn" (der vollqualifizierte Domänenname des Registrierungspools), "UserCredential" (das Windows PowerShell-Objekt mit den Anmeldeinformationen des Benutzers "Pilar Ackerman") und "UserSipAddress" (die mit den eingegebenen Anmeldeinformationen übereinstimmende SIP-Adresse).