Test-CsWebAppAnonymous
Letztes Änderungsdatum des Themas: 2012-03-26
Prüft, ob anonyme Benutzer mit Microsoft Lync Web App an einer Microsoft Lync Server 2010-Konferenz teilnehmen können.
Syntax
Test-CsWebAppAnonymous -TargetFqdn <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsWebAppAnonymous -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Test-CsWebAppAnonymous [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Detaillierte Beschreibung
Mit dem Cmdlet Test-CsWebAppAnonymous können Administratoren prüfen, ob anonyme Benutzer mit Lync Web App an einer Konferenz teilnehmen können. Wenn Sie Test-CsWebAppAnonymous ausführen, versucht das Cmdlet, mithilfe des Webticketdiensts ein anonymes Webticket abzurufen. Wenn das Ticket abgerufen werden kann und die Benutzer authentifiziert werden können, versucht Test-CsWebAppAnonymous über Lync Web App eine Verbindung mit Lync Server 2010 herzustellen. Nachdem die Verbindung hergestellt wurde, versucht das Cmdlet, gesonderte Konferenzen für Sofortnachrichten, Anwendungsfreigabe und Datenzusammenarbeit einzurichten.
Viele Administratoren verwenden die Cmdlets vom Typ "CsHealthMonitoringConfiguration", um für jeden Registrierungspool Testbenutzer einzurichten. Bei diesen Testbenutzern handelt es sich um ein Paar von Benutzerkonten, das für synthetische Transaktionen vorkonfiguriert wurde. (Dies sind in der Regel Testkonten und keine Konten tatsächlicher Benutzer.) Wenn Testbenutzer für einen Pool konfiguriert wurden, können Administratoren Test-CsWebAppAnonymous für diesen Pool durchführen, ohne die Identität (und die Anmeldeinformationen) der für den Test verwendeten Benutzerkonten anzugeben.
Alternativ können Administratoren Test-CsWebAppAnonymous unter Verwendung eines tatsächlichen Benutzerkontos ausführen. Denken Sie beim Ausführen der Tests mit einem tatsächlichen Benutzerkonto daran, dass Sie den Anmeldenamen und das Kennwort jedes Benutzers angeben müssen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
TargetFqdn |
Optional |
Zeichenfolge |
Vollqualifizierter Domänenname (FQDN) des zu testenden Pools. Beispiel: -TargetFqdn atl-cs-001.litwareinc.com |
UserCredential |
Optional |
PSCredential |
Objekt mit Anmeldeinformationen für das erste der beiden zu testenden Benutzerkonten. 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\pilar" zurück und speichert dieses Objekt in der Variablen "$x": $x = Get-Credential "litwareinc\pilar" Sie müssen beim Ausführen dieses Befehls das Benutzerkennwort angeben. Dieser Parameter ist nicht erforderlich, wenn für den Befehl Testbenutzer verwendet werden, die mit den "CsHealthMonitoringConfiguration"-Cmdlets konfiguriert wurden. |
UserSipAddress |
Optional |
Zeichenfolge |
Die SIP-Adresse für das erste der beiden zu testenden Benutzerkonten. Beispiel: -UserSipAddress "sip:kenmyer@litwareinc.com" Dieser Parameter ist nicht erforderlich, wenn für den Befehl Testbenutzer verwendet werden, die mit den "CsHealthMonitoringConfiguration"-Cmdlets konfiguriert wurden. |
External |
Optional |
Switch-Parameter |
Bewirkt, sofern angegeben, dass Test-CsWebAppAnonymous das externe Webrelay des REACH-Servers (Roaming-Enabled Architecture) testet. Wird dieser Parameter nicht angegeben, testet das Cmdlet das interne Webrelay, das als Vermittler zwischen dem internen Netzwerk und dem Internet dient. |
TargetUri |
Optional |
Zeichenfolge |
URI (Uniform Resource Identifier) des REACH-Servers. Beispiel: -TargetUri "https://atl-cs-001.litwareinc.com/reach" Sie können die Parameter "TargetUri" und "TargetFqdn" nicht in demselben Befehl verwenden. |
WebCredential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Objekt mit Anmeldeinformationen für das Benutzerkonto, das im Test verwendet werden soll. 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" Dieser Parameter ist erforderlich, wenn entweder der Parameter "TargetUri" oder der Parameter "User2SipAddress" angegeben wird und der Computer, auf dem Sie den Befehl ausführen, kein Serverzertifikat hat. |
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. |
Eingabetypen
Keine.
Rückgabetypen
Mit Test-CsWebAppAnonymous wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsWebAppAnonymous -TargetFqdn atl-cs-001.litwareinc.com
Im Befehl in Beispiel 1 wird geprüft, ob ein Testbenutzer, der für den Pool "atl-cs-001.litwareinc.com" konfiguriert ist, über Lync Web App anonym an einer Konferenz teilnehmen kann. Dieser Befehl hat nur Erfolg, wenn Sie einen Testbenutzer für den Pool mithilfe der Cmdlets vom Typ "CsHealthMonitoringConfiguration" konfiguriert haben.
-------------------------- Beispiel 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsWebApp -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1
Mit den vorstehenden Befehlen wird geprüft, ob der Benutzer Ken Myer über Lync Web App anonym an einer Konferenz teilnehmen kann. Um mit einem tatsächlichen Benutzerkonto arbeiten zu können, wird im ersten Befehl im Beispiel das Cmdlet Get-Credential zum Erstellen eines Windows PowerShellAnmeldeinformationsobjekts für den Benutzer "litwareinc\kenmyer" verwendet. Dieses (in der Variablen "$cred1" gespeicherte) Anmeldeinformationsobjekt wird anschließend im zweiten Befehl des Beispiels an den Parameter "UserCredential" übergeben. Zusätzlich zum Parameter "UserCredential" wird der Parameter zusammen mit der SIP-Adresse von Ken Myer einbezogen.