Freigeben über


Test-CsWebApp

 

Letztes Änderungsdatum des Themas: 2012-03-27

Prüft, ob authentifizierte Benutzer mit Microsoft Lync Web App an einer Microsoft Lync Server 2010-Konferenz teilnehmen können.

Syntax

Test-CsWebApp -TargetFqdn <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]

Test-CsWebApp [-TargetFqdn <String>] -User2Credential <PSCredential> -User2SipAddress <String> -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]

Test-CsWebApp -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]

Detaillierte Beschreibung

Mit dem Cmdlet Test-CsWebApp können Administratoren prüfen, ob authentifizierte Benutzer mit Lync Web App an einer Konferenz teilnehmen können. Wenn Sie Test-CsWebApp ausführen, versucht das Cmdlet, mithilfe des Webticketdiensts Webtickets für ein Paar von Testbenutzern abzurufen. Wenn die Tickets abgerufen und die Benutzer authentifiziert werden können, versucht Test-CsWebApp, ü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-CsWebApp 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-CsWebApp unter Verwendung tatsächlicher Benutzerkonten ausführen. Denken Sie beim Ausführen der Tests mit tatsächlichen Benutzerkonten 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

User2Credential

Optional

PSCredential

Objekt mit Anmeldeinformationen für das zweite der beiden zu testenden Benutzerkonten. Bei dem an "User2Credential" ü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 "$y":

$y = Get-Credential "litwareinc\kenmyer"

Sie müssen beim Ausführen dieses Befehls das Benutzerkennwort angeben.

User2SipAddress

Optional

Zeichenfolge

Die SIP-Adresse für das zweite der beiden zu testenden Benutzerkonten. Beispiel:

-User2SipAddress "sip:pilar@litwareinc.com"

Dieser Parameter ist nicht erforderlich, wenn für den Befehl Testbenutzer verwendet werden, die mit den "CsHealthMonitoringConfiguration"-Cmdlets konfiguriert wurden.

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.

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

SwitchParameter

Bewirkt, sofern angegeben, dass Test-CsWebApp 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 die Parameter "UserSipAddress/User2SipAddress" angegeben werden 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 TestOutput

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-CsWebApp wird eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurückgegeben.

Beispiel

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

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

Im vorstehenden Beispiel wird geprüft, ob ein Paar Testbenutzer, die für den Pool "atl-cs-001.litwareinc.com" konfiguriert sind, über Lync Web App an einer Konferenz teilnehmen kann. Dieser Befehl hat nur Erfolg, wenn Sie Testbenutzer für den Pool mithilfe der Cmdlets vom Typ "CsHealthMonitoringConfiguration" konfiguriert haben.

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

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

Test-CsWebApp -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1 -User2SipAddress "sip:pilar@litwareinc.com" -User2Credential $cred2

Mit den Befehlen in Beispiel 2 wird geprüft, ob die Benutzer Ken Myer und Pilar Ackerman über Lync Web App an einer Konferenz teilnehmen können. Um mit tatsächlichen Benutzerkonten arbeiten zu können, wird in den ersten beiden Befehlen im Beispiel das Cmdlet "Get-Credential" zum Erstellen eines Windows PowerShell-Anmeldeinformationsobjekts für die beiden Benutzer ("litwareinc\kenmyer" und "litwareinc\pilar") verwendet. Diese (in den Variablen "$cred1" und "$cred2" gespeicherten) Anmeldeinformationsobjekte dienen anschließend als Parameterwerte für die Parameter "UserCredential" und "User2Credential" im letzten Befehl des Beispiels. Zusätzlich zu den Parametern mit den Benutzeranmeldeinformationen werden die Parameter "UserSipAddress" und "User2SipAddress" sowie die SIP-Adressen der beiden im Test verwendeten Benutzerkonten einbezogen.