Test-OwaConnectivity

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Server 2010

Dieses Cmdlet ist nur in Exchange Server 2010 verfügbar.

Verwenden Sie das Cmdlet Test-OwaConnectivity, um zu überprüfen, ob Microsoft Office Outlook Web App erwartungsgemäß ausgeführt wird. Das Cmdlet Test-OwaConnectivity kann verwendet werden, um Outlook Web App Konnektivität für alle virtuellen Microsoft Exchange Server 2010-Verzeichnisse auf einem angegebenen Clientzugriffsserver für alle Postfächer auf Servern mit Exchange zu testen, die sich am selben Active Directory-Standort befinden. Das Cmdlet Test-OwaConnectivity kann auch verwendet werden, um die Konnektivität für eine einzelne Exchange-Outlook Web App-URL zu testen.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Test-OwaConnectivity
    [-URL] <String>
    -MailboxCredential <PSCredential>
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Test-OwaConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-RSTEndpoint <String>]
    [-TestType <OwaConnectivityTestType>]
    [-VirtualDirectoryName <String>]
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Test-OwaConnectivity testet die Konnektivität aller virtuellen Exchange Outlook Web App Verzeichnisse auf einem Clientzugriffsserver oder testet die Konnektivität einer einzelnen Exchange Outlook Web App URL.

Um alle virtuellen Exchange Outlook Web App Verzeichnisse auf einem Clientzugriffsserver zu testen, muss ein Active Directory-Testkonto vorhanden sein. Außerdem muss an jedem Active Directory-Standort ein Testpostfach vorhanden sein, das Postfächer hostet, auf die über die virtuellen Verzeichnisse zugegriffen werden kann, die getestet werden. Wenn die Testumgebung während des Setups des Postfachservers nicht erstellt wurde, werden Sie aufgefordert, das Skript auszuführen, das die Testpostfächer und Testbenutzer erstellt, wenn Sie das Cmdlet Test-OwaConnectivity ausführen.

Wenn der Server, auf dem das Testpostfach gehostet wird, nicht verfügbar ist, gibt das Cmdlet Test-OwaConnectivity einen Fehler zurück, der das Problem möglicherweise nicht eindeutig identifiziert. Um dies zu vermeiden, überprüfen Sie, ob der Server, auf dem das Testpostfach gehostet wird, ausgeführt wird und ob das Postfach verfügbar ist, bevor Sie das Cmdlet Test-OwaConnectivity ausführen. Dazu können Sie das Cmdlet Test-MapiConnectivity verwenden.

Wenn Sie das Cmdlet Test-OwaConnectivity auf einem Clientzugriffsserver ausführen, ohne den ClientAccessServer-Parameter oder den URL-Parameter zu verwenden, testet das Cmdlet den Server, auf dem Sie das Cmdlet ausführen. Verwenden Sie zum Testen eines bestimmten Clientzugriffsservers den Parameter ClientAccessServer.

Führen Sie zum Testen einer einzelnen URL das Cmdlet Test-OwaConnectivity mit dem URL-Parameter und den Anmeldeinformationen für ein vorhandenes Exchange-Postfach aus. Wenn sich die URL hinter einem Lastenausgleich befindet, können Sie nicht vorhersagen, welchen Clientzugriffsserver der Befehl testen wird. Da Anmeldeinformationen als Teil der Parameter erforderlich sind, wenn Sie den URL-Parameter verwenden, können Sie ein beliebiges Konto verwenden, um das Cmdlet Test-OwaConnectivity auszuführen, wenn Sie den URL-Parameter verwenden.

Wenn der Befehl auf ein virtuelles Verzeichnis stößt, für das Secure Sockets Layer (SSL) nicht erforderlich ist, überspringt der Befehl dieses Verzeichnis, es sei denn, der Parameter AllowUnsecureAccess wird verwendet. Wenn der AllowUnsecureAccess-Parameter verwendet wird, wird die Kommunikation zwischen Servern für die Zwecke des Tests in Klartext gesendet.

Das cmdlet Test-OwaConnectivity kann als einmalige interaktive Aufgabe oder als geplante Aufgabe unter Microsoft System Center Operations Manager 2007-Steuerelement ausgeführt werden. Um das cmdlet Test-OwaConnectivity als System Center Operations Manager 2007-Aufgabe auszuführen, muss das Clientzugriffstestpostfach auf den Postfachservern verfügbar sein, die das Cmdlet testet.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Test-OwaConnectivity -URL:https://mail.contoso.com/owa -MailboxCredential:(get-credential contoso\kweku)

In diesem Beispiel wird die Konnektivität für die URL https://mail.contoso.com/owa mithilfe der Anmeldeinformationen für den Benutzer contoso\kweku getestet.

Beispiel 2

Test-OwaConnectivity -ClientAccessServer:Contoso12 -AllowUnsecureAccess

In diesem Beispiel wird die Konnektivität eines bestimmten Clientzugriffsservers Contoso12 und alle virtuellen Exchange Outlook Web App Verzeichnisse getestet, die Exchange-Postfächer unterstützen. Dazu gehören die virtuellen Verzeichnisse, für die SSL nicht erforderlich ist.

Parameter

-AllowUnsecureAccess

Der AllowUnsecureAccess-Switch gibt an, ob virtuelle Verzeichnisse getestet werden, die kein SSL erfordern. Sie müssen keinen Wert für diese Option angeben.

Wenn Sie diesen Schalter nicht verwenden, überspringt der Befehl virtuelle Verzeichnisse, die kein SSL erfordern, und ein Fehler wird generiert.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ClientAccessServer

Dieser Parameter ist nur in Exchange Server 2010 verfügbar.

Der Parameter ClientAccessServer gibt den Namen des zu testden Clientzugriffsservers an. Wenn dieser Parameter enthalten ist, werden alle virtuellen Exchange Outlook Web App Verzeichnisse auf dem Clientzugriffsserver mit allen Exchange-Postfachservern am lokalen Active Directory-Standort getestet.

Verwenden Sie diesen Parameter nicht mit dem URL-Parameter.

Type:	ServerIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DomainController

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LightMode

Der LightMode-Parameter ist für diesen Diagnosebefehl nicht implementiert. Die Verwendung dieses Parameters ändert nicht das Verhalten des Befehls.

Dieser Parameter wird für andere Exchange-Diagnosebefehle implementiert, bei denen er zum Ausführen einer weniger intensiven Version eines Befehls verwendet wird.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxCredential

Der Parameter MailboxCredential gibt die Postfachanmeldeinformationen für einen einzelnen URL-Test an.

Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.

Der Parameter MailboxCredential ist nur bei Verwendung des URL-Parameters erforderlich.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxServer

Der Parameter MailboxServer gibt den Namen des zu testden Postfachservers an. Wenn nicht angegeben, werden alle Postfachserver am lokalen Active Directory-Standort getestet.

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MonitoringContext

Die Option MonitoringContext schließt die zugeordneten Überwachungsereignisse und Leistungsindikatoren in die Ergebnisse ein. Sie müssen keinen Wert für diese Option angeben.

In der Regel sind Überwachungsereignisse und Leistungsindikatoren in den Ergebnissen eingeschlossen, wenn die Ausgabe an den Microsoft System Center Operations Manager (SCOM) übergeben wird.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ResetTestAccountCredentials

Der Parameter ResetTestAccountCredentials setzt das Kennwort für das Testkonto zurück, das zur Ausführung dieses Befehls verwendet wird. Sie müssen keinen Wert für diese Option angeben.

Das Kennwort für das Testkonto wird normalerweise alle 7 Tage zurückgesetzt. Verwenden Sie diese Option, um das Zurücksetzen eines Kennworts immer dann zu erzwingen, wenn dies aus Sicherheitsgründen notwendig ist.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RSTEndpoint

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TestType

Der Parameter TestType gibt an, ob der Befehl interne oder externen URLs testet. Gültige Werte sind Internal und External. Sie können diesen Parameter nicht mit dem URL-Parameter verwenden. Wenn weder der TestType-Parameter noch der URL-Parameter angegeben ist, ist der Standardwert TestType:Internal.

Type:	OwaConnectivityTestType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Timeout

Der Parameter Timeout gibt an, wie lange (in Sekunden) auf den Abschluss des Testvorgangs gewartet wird. Der Standardwert für den Parameter Timeout beträgt 30 Sekunden. Sie müssen einen Timeoutwert größer als 0 Sekunden und kleiner als 1 Stunde (3,600 Sekunden) angeben. Es wird empfohlen, diesen Parameter immer mit einem Wert von mindestens 5 Sekunden zu konfigurieren.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TrustAnySSLCertificate

Mit dem Schalter TrustAnySSLCertificate kann Exchange Zertifikate von nicht vertrauenswürdigen Zertifizierungsstellen (Certification Authorities, CAs) akzeptieren. Sie müssen keinen Wert für diese Option angeben.

Der Switch TrustAnySSLCertificate gibt an, ob SSL-Zertifikatsüberprüfungsfehler ignoriert werden sollen. Sie müssen keinen Wert für diese Option angeben.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-URL

Der URL-Parameter gibt die url an, die getestet werden soll. Dieser Parameter ist nur erforderlich, wenn Sie eine einzelne Outlook Web App-URL testen möchten.

Wenn dieser Parameter verwendet wird, ist auch der Parameter MailboxCredential erforderlich.

Sie können den URL-Parameter nicht mit den Parametern TestType oder ClientAccessServer verwenden.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-VirtualDirectoryName

Der Parameter VirtualDirectoryName gibt den Namen des virtuellen Verzeichnisses an, das auf einem bestimmten Clientzugriffsserver getestet werden soll. Wenn dieser Parameter nicht enthalten ist, werden alle exchange Outlook Web App virtuellen Verzeichnisse getestet, die Exchange-Postfächer unterstützen.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.