Test-CsPstnPeerToPeerCall
Letztes Änderungsdatum des Themas: 2012-03-25
Testet die Fähigkeit zweier Benutzer, einen Peer-zu-Peer-Anruf über das PSTN-Gateway (Public Switched Telephone Network) zu tätigen.
Syntax
Test-CsPstnPeerToPeerCall -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsPstnPeerToPeerCall [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Detaillierte Beschreibung
Test-CsPstnPeerToPeerCall 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 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.
"Test-CsPstnPeerToPeerCall" kann auch im Serverplattformmodus verwendet werden. In diesem Fall müssen Sie nur die SIP-Adresse der Benutzer angeben, und Lync Server 2010 verwendet Zertifikate zur Authentifizierung dieser Benutzer.
Wenn Sie das Cmdlet Test-CsPstnPeerToPeerCall aufrufen, wird zunächst versucht, die zwei Testbenutzer bei Lync Server anzumelden. Sind diese Anmeldungen erfolgreich, initiiert das Cmdlet einen Anruf von Benutzer 1 bei Benutzer 2, wobei der Anruf über das PSTN-Gateway erfolgt. Test-CsPstnPeerToPeerCall tätigt diesen Anruf unter Verwendung der Wähleinstellungen, VoIP-Richtlinie und weiteren Richtlinien sowie Konfigurationseinstellungen, die für den Testbenutzer festgelegt wurden. Verläuft der Test wie geplant, überprüft das Cmdlet, ob Benutzer 2 den Anruf beantworten konnte. Anschließend werden beide Testkonten vom System abgemeldet.
Test-CsPstnPeerToPeerCall tätigt einen tatsächlichen Telefonanruf, der bestätigt, dass eine Verbindung hergestellt werden kann. Außerdem werden DTMF-Codes (Mehrfrequenzverfahren) über das Netzwerk übertragen, um festzustellen, ob Medien über die Verbindung gesendet werden können. Allerdings wird der Anruf vom Cmdlet selbst angenommen, und es nicht erforderlich, den Anruf manuell zu beenden. (Es muss also niemand den Anruf entgegennehmen und anschließend auflegen.)
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-CsPstnPeerToPeerCall"}
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 oder wenn Sie den Serverplattformmodus verwenden. |
ReceiverSipAddress |
Optional |
SIP-Adresse |
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 oder wenn Sie den Serverplattformmodus verwenden. |
SenderSipAddress |
Optional |
SIP-Adresse |
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. |
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-CsPstnPeerToPeerCall akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Test-CsPstnPeerToPeerCall wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com
Im vorstehenden Beispiel wird geprüft, ob sich ein vorkonfiguriertes Testbenutzerpaar beim Pool "atl-cs-001.litwareinc.com" anmelden kann. Nachdem sich die Testbenutzer angemeldet haben, wird mit Test-CsPstnPeerToPeerCall geprüft, ob die beiden Benutzer einen Peer-zu-Peer-Anruf über das PSTN-Gateway tätigen können. 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 der erste Testbenutzer beim System anmelden kann, und prüft anschließend, ob dieser Benutzer den zweiten für den Pool definierten Benutzer anrufen kann.
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 keine Testbenutzer für einen Pool definiert haben und nicht den Serverplattformmodus verwenden, müssen Sie die Parameter "SenderSipAddress" und "ReceiverSipAddress" sowie die entsprechenden Anmeldeinformationen für die Benutzer angeben, die als Testkonten dienen. Mit Test-CsPstnPeerToPeerCall werden die Überprüfungen dann anhand der beiden angegebenen Benutzer durchgeführt.
-------------------------- Beispiel 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2
Mit den Befehlen in Beispiel 2 wird getestet, ob sich ein Benutzerpaar ("litwareinc\pilar" und "litwareinc\kenmyer") bei Lync Server anmelden und einen Peer-zu-Peer-Anruf über das PSTN-Gateway durchführen 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 wird mit dem dritten Befehl im Beispiel ermittelt, ob sich die beiden Benutzer bei Lync Server anmelden und einen Peer-zu-Peer-Anruf über das PSTN-Gateway durchführen können. Hierzu wird Test-CsPstnPeerToPeerCall 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 denselben Benutzer), "-ReceiverSipAddress " (SIP-Adresse für den anderen Testbenutzer) und "ReceiverCredential" (Windows PowerShell-Objekt mit den Anmeldeinformationen für den anderen Benutzer).
-------------------------- Beispiel 3 --------------------------
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com"
In Beispiel 3 wird gezeigt, wie "Test-CsPstnPeerToPeerCall" im Serverplattformmodus verwendet werden kann. In diesem Modus werden die SIP-Adressen der Testbenutzer angegeben, die Anmeldeinformationen der Benutzer werden jedoch nicht eingeschlossen. Bei dieser Ausführung verwendet Lync Server 2010 Zertifikate für die Authentifizierung der beiden Testbenutzer.