Test-CsGroupIM
Letztes Änderungsdatum des Themas: 2012-03-26
Testet die Fähigkeit zweier Benutzer, eine Instant Messaging-Konferenz durchzuführen. Test-CsGroupIM ist eine "synthetische Transaktion", d. h. eine Simulation gängiger Microsoft Lync Server 2010-Aktivitäten, die zur Integritäts- und Leistungsüberwachung verwendet werden.
Syntax
Test-CsGroupIM -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsGroupIM [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Detaillierte Beschreibung
Test-CsGroupIM ist ein Beispiel für eine synthetische Lync Server 2010-Transaktion. 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 anschließend versuchen, das Problem zu diagnostizieren und zu beheben. Denken Sie beim Ausführen einer synthetischen Transaktion mit tatsächlichen Benutzerkonten daran, dass Sie die Anmeldeinformationen für jeden Benutzer angeben müssen.
Mit dem Cmdlet Test-CsGroupIM können Sie überprüfen, ob Benutzer in Ihrer Organisation Konferenzen durchführen können. Damit die Tests ordnungsgemäß mit Test-CsGroupIM ausgeführt werden können, sind zwei Benutzerkonten erforderlich. Wenn Sie Testbenutzer für die Integritätsüberwachung für den Pool eingerichtet haben, für den der Test durchgeführt werden soll, müssen Sie diese Konten nicht angeben. Test-CsGroupIM verwendet automatisch die Testkonten, die dem Pool zugewiesen wurden. (Einzelheiten finden Sie im Hilfethema New-CsHealthMonitoringConfiguration.) Alternativ können Sie den Test auch mit anderen Konten als denjenigen durchführen, die der Registrierung zugewiesen wurden. So können Sie Tests selbst dann ausführen, wenn Sie keine Testbenutzer für den Pool konfiguriert haben. Sie können ferner testen, ob zwei spezifische Benutzer die Möglichkeit haben, eine Konferenz durchzuführen. Wenn Sie sich für diese Methode entscheiden, müssen Sie den Benutzernamen und das Kennwort für beide Benutzer bereitstellen.
Beim Ausführen von Test-CsGroupIM versucht das Cmdlet, beide Testbenutzer bei Lync Server anzumelden. Nach erfolgter Anmeldung erstellt Test-CsGroupIM eine neue Konferenz unter dem Namen des ersten Testbenutzers. Anschließend wird der zweite Benutzer eingeladen, an der Konferenz teilzunehmen. Es werden einige Nachrichten ausgetauscht, woraufhin beide Benutzer vom System abgemeldet werden. 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. Selbst wenn der Testbenutzer Ken Myer vom System abgemeldet wird, bleibt der reale Benutzer Ken Myer weiterhin angemeldet. Gleichermaßen erhält der reale Ken Myer keine Einladung zur Teilnahme an der Konferenz. Diese Einladung wird an das Testkonto gesendet und vom Testkonto angenommen.
Durch das Hinzufügen des Parameters "Verbose" erhalten Sie eine ausführliche Übersicht über alle Aktionen, die von Test-CsGroupIM 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-CsGroupIM"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
TargetFqdn |
Erforderlich |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des zu testenden Pools. |
ReceiverCredential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Objekt mit Anmeldeinformationen für das erste der beiden zu testenden Benutzerkonten. Bei dem an "ReceiverCredential" ü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\pilar" zurück und speichert dieses Objekt in der Variablen "$y": $y = Get-Credential "litwareinc\pilar" Sie müssen beim Ausführen dieses Befehls das Benutzerkennwort angeben. Die Angabe der Empfängeranmeldeinformationen ist nicht erforderlich, wenn Sie den Test mit den Konfigurationseinstellungen für die Integritätsüberwachung des Pools ausführen. |
ReceiverSipAddress |
Optional |
Zeichenfolge |
Die SIP-Adresse für das erste der beiden zu testenden Benutzerkonten. Beispiel: -ReceiverSipAddress "sip:pilar@litwareinc.com". Der Parameter "ReceiverSipAddress" muss auf dasselbe Benutzerkonto wie "ReceiverCredential" verweisen. Die Angabe der SIP-Adresse ist nicht erforderlich, wenn Sie den Test mit den Konfigurationseinstellungen für die Integritätsüberwachung des Pools ausführen. |
RegistrarPort |
Optional |
Ganze Zahl |
Der vom Registrierungsdienst verwendete SIP-Port. Dieser Parameter ist nicht erforderlich, wenn die Registrierung den Standardport 5061 verwendet. |
SenderCredential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Objekt mit Anmeldeinformationen für das zweite der beiden zu testenden Benutzerkonten. Bei dem an "SenderCredential" ü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. Die Angabe der Senderanmeldeinformationen ist nicht erforderlich, wenn Sie den Test mit den Konfigurationseinstellungen für die Integritätsüberwachung des Pools ausführen. |
SenderSipAddress |
Optional |
Zeichenfolge |
Die SIP-Adresse für das zweite der beiden zu testenden Benutzerkonten. Beispiel: -SenderSipAddres "sip:kenmyer@litwareinc.com". Der Parameter "SenderSipAddress" muss auf dasselbe Benutzerkonto wie "SenderCredential" verweisen. Die Angabe der SIP-Adresse ist nicht erforderlich, wenn Sie den Test mit den Konfigurationseinstellungen für die Integritätsüberwachung des Pools ausführen. |
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. |
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-CsGroupIM akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Test-CsGroupIM wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsGroupIm -TargetFqdn atl-cs-001.litwareinc.com
Im vorstehenden Beispiel wird geprüft, ob ein Paar vorkonfigurierter Testbenutzer sich beim Pool "atl-cs-001.litwareinc.com" anmelden und an einer Sofortnachrichtenkonferenz teilnehmen kann. Dieser Befehl funktioniert nur, wenn Testbenutzer für den Pool "atl-cs-001.litwareinc.com" definiert wurden. Sofern Testbenutzer konfiguriert wurden, wird mit dem Befehl geprüft, ob sich die beiden Benutzer beim System anmelden und an einer Instant Messaging-Konferenz teilnehmen können.
Wurden keine Testbenutzer definiert, kann der Befehl nicht ausgeführt werden, da nicht ermittelt werden kann, welcher Benutzer beim Test verwendet werden sollen. Wenn Sie für einen Pool keine Testbenutzer definiert haben, müssen Sie die Parameter "SenderSipAddress" und "ReceiverSipAddress" sowie die entsprechenden Anmeldeinformationen der Benutzer für den Test angeben. Mit Test-CsGroupIM werden die Überprüfungen dann mit den beiden angegebenen Benutzern durchgeführt.
-------------------------- Beispiel 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsGroupIm -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2
Mit den Befehlen in Beispiel 2 wird getestet, ob zwei Benutzer ("litwareinc\pilar" und "litwareinc\kenmyer") sich bei Lync Server anmelden und an einer Instant Messaging-Konferenz teilnehmen können. 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 hat die gleiche Aufgabe, nur gibt dieser ein Objekt mit Anmeldeinformationen für das Konto "Ken Myer" zurück.
Anhand der beiden Objekte mit Anmeldeinformationen ermittelt der dritte Befehl im Beispiel, ob sich die beiden Benutzer bei Lync Server anmelden und dann an einer Instant Messaging-Konferenz teilnehmen können. Hierzu wird Test-CsGroupIM mit folgenden Parametern aufgerufen: "TargetFqdn" (der FQDN des Registrierungspools), "SenderSipAddress" (die SIP-Adresse für den ersten Benutzer), "SenderCredential" (das PowerShell-Objekt mit den Anmeldeinformationen für den ersten Benutzer), "ReceiverSipAddress" (die SIP-Adresse des zweiten Benutzers) und "ReceiverCredential" (das PowerShell-Objekt mit den Anmeldeinformationen für den zweiten Benutzer).