Test-CsPstnOutboundCall
Letztes Änderungsdatum des Themas: 2012-03-26
Testet, ob ein Benutzer einen Anruf an eine Telefonnummer im Telefonfestnetz (Public Switched Telephone Network, PSTN) tätigen kann.
Syntax
Test-CsPstnOutboundCall -TargetFqdn <String> -TargetPstnPhoneNumber <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsPstnOutboundCall [-TargetFqdn <String>] -TargetPstnPhoneNumber <String> -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Detaillierte Beschreibung
Test-CsPstnOutboundCall 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-CsPstnOutboundCall" kann auch im Serverplattformmodus verwendet werden. In diesem Fall müssen Sie nur die SIP-Adresse eines Benutzers angeben, und Lync Server 2010 verwendet Zertifikate zur Authentifizierung dieses Benutzers.
Beim Ausführen von Test-CsPstnOutboundCall versucht das Cmdlet zunächst den Testbenutzer bei Lync Server anzumelden. Nach erfolgreicher Anmeldung versucht das Cmdlet, einen Telefonanruf über das PSTN-Gateway zu tätigen. Dieser Telefonanruf wird mithilfe der Wähleinstellungen, der VoIP-Richtlinie und anderer Richtlinien und Einstellungen durchgeführt, die dem Testkonto zugewiesen sind. Wenn der Anruf beantwortet wird, sendet das Cmdlet DTMF-Codes (Dual-Tone Multifrequency) über das Netzwerk, um die Medienkonnektivität zu überprüfen.
Im Rahmen der Tests wird mit Test-CsPstnOutboundCall ein tatsächlicher Telefonanruf durchgeführt: Das angerufene Telefon klingelt, und der Anruf muss für einen erfolgreichen Abschluss des Tests entgegengenommen werden. Dieser Anruf muss zudem manuell vom Administrator beendet werden.
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-CsPstnOutboundCall"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
TargetFqdn |
Erforderlich |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des zu testenden Pools. |
TargetPstnPhoneNumber |
Erforderlich |
Zeichenfolge |
Die PSTN-Telefonnummer, die während des Tests angerufen werden soll. Die Zieltelefonnummer wird am besten im E.164-Format angegeben, d. h. die Nummer sieht in etwa wie folgt aus: "+14255551298". Die Nummer beginnt mit einem Pluszeichen (+), gefolgt vom Länder-/Regionscode (1), der Ortskennzahl (425) und der Rufnummer (5551298). Verwenden Sie beim Festlegen von Telefonnummern keine Bindestriche, Klammern oder andere Zeichen. Wenn Sie nicht das E.164-Format verwenden, werden die Wähleinstellungen des Testbenutzers an die Nummer angehängt. Lync Server 2010 verwendet in diesem Fall die Wähleinstellungen, um die Nummer in das E.164-Format zu normalisieren. Ist eine Normalisierung der Nummer nicht möglich, kann der Anruf nicht durchgeführt werden, und der Test ist nicht erfolgreich. |
UserCredential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Objekt mit Anmeldeinformationen für das Konto, das getestet wird. 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. Dieser Parameter ist nicht erforderlich, wenn der Befehl Testbenutzer verwendet, die mit den CsHealthMonitoringConfiguration-Cmdlets konfiguriert wurden. Der Parameter ist ebenfalls nicht erforderlich, wenn der Test im Serverplattformmodus ausgeführt wird. In diesem Fall versucht Lync Server 2010, den Benutzer mithilfe von Zertifikaten zu authentifizieren. |
UserSipAddress |
Optional |
SIP-Adresse |
SIP-Adresse für das Benutzerkonto, das getestet wird. Beispiel: -SenderSipAddress "sip:kenmyer@litwareinc.com". Der Parameter "UserSipAddress" muss auf dasselbe Benutzerkonto wie "UserCredential" verweisen. Dieser Parameter ist nicht erforderlich, wenn der Befehl Testbenutzer verwendet, die mit den CsHealthMonitoringConfiguration-Cmdlets konfiguriert wurden. |
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. |
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 |
Zeichenfolge |
Gibt bei Ausführung des Cmdlets auf dem Bildschirm ausführliche Informationen zur Aktivität aus. |
Eingabetypen
Keine. Test-CsPstnOutboundCall akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Test-CsPstnOutboundCall wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567"
In dem vorstehenden Beispiel wird überprüft, ob ein vorab konfigurierter Testbenutzer sich beim Pool "atl-cs-001.litwareinc.com" anmelden und einen Telefonanruf über das PSTN-Gateway tätigen 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 der erste Testbenutzer sich beim System anmelden und ggf. einen Telefonanruf an ein Telefon im Telefonfestnetz tätigen 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 für einen Pool keine Testbenutzer definiert haben, müssen Sie den Parameter "UserSipAddress" sowie die entsprechenden Anmeldeinformationen des Benutzerkontos für den Test angeben. Mit Test-CsPstnOutboundCall werden die Überprüfungen dann mit dem angegebenen Benutzer durchgeführt.
-------------------------- Beispiel 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1
Die Befehle in Beispiel 2 testen, ob ein Testbenutzer (litwareinc\kenmyer) sich bei Lync Server anmelden und dann über das PSTN-Gateway einen Anruf tätigen 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 "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.
Anhand des Objekts mit Anmeldeinformationen ermittelt der zweite Befehl im Beispiel, ob der Testbenutzer sich bei Lync Server anmelden und dann einen Telefonanruf an die Zieltelefonnummer (+15551234567) durchführen kann. Hierzu wird Test-CsPstnOutboundCall mit folgenden Parametern aufgerufen: "TargetFqdn" (der FQDN des Registrierungspools), "UserSipAddress" (die SIP-Adresse des Benutzers, der den Anruf tätigt), "UserCredential" (das Windows PowerShell-Objekt mit Anmeldeinformationen für den Testbenutzer) und "TargetPstnPhoneNumber" (die angerufene Telefonnummer).
-------------------------- Beispiel 3 ---------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress sip:kenmyer@litwareinc.com -TargetPstnPhoneNumber "+15551234567"
In Beispiel 3 wird gezeigt, wie "Test-CsPstnOutboundCall" im Serverplattformmodus verwendet werden kann. In diesem Modus wird die SIP-Adresse des Benutzers angegeben, die Anmeldeinformationen des Benutzers werden jedoch nicht eingeschlossen. Bei dieser Ausführung verwendet Lync Server 2010 Zertifikate für die Authentifizierung des Testbenutzers.