Test-CsDialInConferencing
Letztes Änderungsdatum des Themas: 2012-03-25
Test-CsDialInConferencing überprüft, ob ein Benutzer an einer Einwahlkonferenzsitzung teilnehmen kann.
Syntax
Test-CsDialInConferencing -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsDialInConferencing [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Detaillierte Beschreibung
Test-CsDialInConferencing 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-CsDialInConferencing versucht, einen Testbenutzer beim System anzumelden. (Wenn Sie mit Testbenutzern arbeiten, verwendet Test-CsDialInConferencing das erste Testkonto, das für diesen Pool konfiguriert wurde.) Ist die Anmeldung erfolgreich, probiert das Cmdlet dann mit den Anmeldeinformationen und Berechtigungen des Benutzers die verfügbaren Zugriffsnummern für Einwahlkonferenzen aus. Der Erfolg oder Misserfolg jedes Einwahlversuchs wird vermerkt, und dann wird der Testbenutzer von Lync Server abgemeldet.
Mit Test-CsDialInConferencing wird nur überprüft, ob die entsprechenden Verbindungen hergestellt werden können. Das Cmdlet tätigt keine echten Anrufe und erstellt keine Einwahlkonferenzen, an denen andere Benutzer teilnehmen können.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Test-CsDialInConferencing lokal auszuführen: RTCUniversalServerAdmins. 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-CsDialInConferencing"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
TargetFqdn |
Erforderlich |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des zu testenden Pools. |
UserCredential |
Erforderlich |
PS-Objekt mit Anmeldeinformationen |
Objekt mit Anmeldeinformationen für das Benutzerkonto, 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 Sie den Test mit den Konfigurationseinstellungen für die Integritätsüberwachung durchführen. |
UserSipAddress |
Erforderlich |
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 durchfü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. |
RegistrarPort |
Optional |
Ganze Zahl |
Der vom Registrierungsdienst verwendete SIP-Port. Dieser Parameter ist nicht erforderlich, wenn die Registrierung den Standardport 5061 verwendet. |
Verbose |
Optional |
Switch-Parameter |
Gibt bei Ausführung des Cmdlets auf dem Bildschirm ausführliche Informationen zur Aktivität aus. |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
Eingabetypen
Keine. Test-CsDialInConferencing akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Test-CsDialInConferencing wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com
Im vorstehenden Beispiel wird überprüft, ob ein vorkonfigurierter Testbenutzer an Einwahlkonferenzen im Pool "atl-cs-001.litwareinc.com" teilnehmen kann. Dieser Befehl funktioniert nur, wenn Testbenutzer für den Pool "atl-cs-001.litwareinc.com" definiert wurden. Wenn dies der Fall ist, dann bestimmt der Befehl, ob der erste Testbenutzer sich bei Lync Server anmelden kann.
Wenn keine Testbenutzer definiert wurden, tritt beim Ausführen des Befehls ein Fehler auf, da nicht bekannt ist, welcher Benutzer angemeldet werden soll. Wenn Sie für einen Pool keinen Testbenutzer definiert haben, müssen Sie den Parameter "UserCredential" und die Anmeldeinformationen des Benutzers verwenden, die der Befehl für die Anmeldung verwenden soll.
-------------------------- Beispiel 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:pilar@litwareinc.com" -UserCredential $cred1
Mit den Befehlen in Beispiel 2 wird überprüft, ob ein bestimmter Benutzer (litwareinc\pilar) an Einwahlkonferenzen im Pool "atl-cs-001.litwareinc.com" teilnehmen 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.
Mit dem zweiten Befehl wird anschließend geprüft, ob sich der Benutzer Pilar Ackerman beim Pool "atl-cs-001.litwareinc.com" anmelden und dann an einer Einwahlkonferenz teilnehmen kann. Hierzu wird Test-CsDialInConferencing mit drei Parametern aufgerufen: "TargetFqdn" (der FQDN des Registrierungspools), "UserCredential" (das Windows PowerShell-Objekt mit den Anmeldeinformationen des Benutzers "Pilar Ackerman") und "UserSipAddress" (die mit den eingegebenen Anmeldeinformationen übereinstimmende SIP-Adresse).