Freigeben über


Test-CsIM

 

Letztes Änderungsdatum des Themas: 2012-03-26

Testet, ob zwei Benutzer Sofortnachrichten austauschen können.

Syntax

Test-CsIM -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]

Test-CsIM [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]

Detaillierte Beschreibung

Test-CsIM ist ein Beispiel für eine "synthetische Transaktion" in Microsoft Lync Server 2010. 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 keine Sofortnachrichten austauschen können, kann ein Administrator eine synthetische Transaktion anhand der beiden fraglichen Benutzerkonten durchführen (statt anhand eines Testkontopaars), um das Problem zu ermitteln und zu lösen. Denken Sie beim Ausführen einer synthetischen Transaktion mit tatsächlichen Benutzerkonten daran, dass Sie die Anmeldeinformationen für jeden Benutzer angeben müssen.

Das Cmdlet Test-CsIM versucht zunächst, zwei Testbenutzer bei Lync Server anzumelden. Wenn die zwei Anmeldungen erfolgreich waren, initiiert das Cmdlet daraufhin eine Sofortnachrichtensitzung (Instant Messaging) zwischen den beiden Testbenutzern. (Benutzer 1 lädt Benutzer 2 zu einer Sofortnachrichtensitzung ein, und Benutzer 2 nimmt die Einladung an.) Nachdem geprüft wurde, ob Nachrichten zwischen den beiden Benutzern ausgetauscht werden können, beendet Test-CsIM die Sofortnachrichtensitzung und meldet beide Benutzer vom System ab.

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-CsIM"}

Parameter

Parameter Erforderlich Typ Beschreibung

ReceiverCredential

Erforderlich

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:jhaas@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.

SenderCredential

Erforderlich

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

Erforderlich

Zeichenfolge

Die SIP-Adresse für das zweite der beiden zu testenden Benutzerkonten. Beispiel: -SenderSipAddress "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.

TargetFqdn

Erforderlich

Zeichenfolge

Vollqualifizierter Domänenname (FQDN) des zu testenden Pools.

RegistrarPort

Optional

Ganze Zahl

Der vom Registrierungsdienst verwendete SIP-Port. Dieser Parameter ist nicht erforderlich, wenn die Registrierung den Standardport 5061 verwendet.

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-CsIM akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Test-CsIM wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.

Beispiel

-------------------------- Beispiel 1 --------------------------

Test-CsIm -TargetFqdn atl-cs-001.litwareinc.com

Der vorstehende Befehl prüft, ob sich ein vorkonfiguriertes Testbenutzerpaar am Pool "atl-cs-001.litwareinc.com" anmelden und dann Sofortnachrichten austauschen kann. Dieser Befehl funktioniert nur, wenn Testbenutzer für den Pool "atl-cs-001.litwareinc.com" definiert wurden. Ist dies der Fall, ermittelt der Befehl, ob sich diese beiden Benutzer am System anmelden und ggf. Sofortnachrichten austauschen 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 Registrierung definiert haben, müssen Sie die Parameter "SenderSipAddress" und "ReceiverSipAddress" sowie die entsprechenden Anmeldeinformationen der Benutzer angeben, die an der Sofortnachrichtensitzung teilnehmen. Test-CsIM führt die Überprüfungen dann anhand der beiden angegebenen Benutzer durch.

-------------------------- Beispiel 2 --------------------------

$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"

Test-CsIm -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2

Die Befehle in Beispiel 2 testen, ob sich ein Benutzerpaar ("litwareinc\pilar" und "litwareinc\kenmyer") bei Lync Server anmelden und Sofortnachrichten austauschen 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 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 Sofortnachrichten austauschen können. Zu diesem Zweck wird Test-CsIM mit den folgenden Parametern aufgerufen: "TargetFqdn" (FQDN des Registrierungspools); "SenderSipAddress" (SIP-Adresse für den ersten Testbenutzer); "SenderCredential" (Windows PowerShell-Objekt mit den Anmeldeinformationen für diesen Benutzer); "-ReceiverSipAddress " (SIP-Adresse für den anderen Testbenutzer) und "ReceiverCredential" (Windows PowerShell-Objekt mit den Anmeldeinformationen für den anderen Benutzer).

Siehe auch

Weitere Ressourcen

Test-CsGroupIM