Test-OwaConnectivity

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2010-08-18

Verwenden Sie das Cmdlet Test-OwaConnectivity, um zu überprüfen, ob Microsoft Office Outlook Web Access ordnungsgemäß ausgeführt wird. Mit dem Cmdlet Test-OwaConnectivity können Sie die Outlook Web Access-Konnektivität aller virtuellen Microsoft Exchange 2007-Verzeichnisse auf einem angegebenen Clientzugriffsserver für alle Postfächer auf Servern mit Exchange 2007 im selben Active Directory-Standort testen. Test-OwaConnectivity kann auch zum Testen der Verbindungen für einen einzelnen Exchange 2007 Outlook Web Access-URL verwendet werden.

Syntax

Test-OwaConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-TestType <Internal | External>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-VirtualDirectoryName <String>] [-WhatIf [<SwitchParameter>]]

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

Detaillierte Beschreibung

Mit dem Cmdlet Test-OwaConnectivity können Sie die Konnektivität aller virtuellen Exchange 2007 Outlook Web Access-Verzeichnisse auf einem Clientzugriffsserver oder die Konnektivität eines einzelnen Exchange 2007 Outlook Web Access-URL testen.

Zum Testen aller virtuellen Exchange 2007 Outlook Web Access-Verzeichnisse auf einem Clientzugriffsserver muss ein Active Directory-Testkonto vorhanden sein. Es muss ebenfalls auf jedem Servercomputer mit Exchange 2007, auf dem die Serverfunktion Mailbox installiert ist, ein Testpostfach vorhanden sein, auf das über die zu testenden virtuellen Verzeichnisse zugegriffen werden kann. Sie können die Testkonten und -postfächer während eines Installationsschritts des Postfachservers erstellen. Wenn die Testumgebung nicht während der Postfachserverinstallation erstellt wurde, werden Sie bei Ausführung des Cmdlets Test-OwaConnectivity aufgefordert, das Skript auszuführen, mit dem die Testpostfächer und Testbenutzer erstellt werden.

Wenn der Server, der als Host der Testpostfächer fungiert, nicht verfügbar ist, gibt das Cmdlet Test-OWAConnectivity einen Fehler zurück, der das Problem ggf. nicht eindeutig identifiziert. Um dies zu vermeiden, überprüfen Sie, ob der als Host des Testpostfachs fungierende Server ausgeführt wird und das Postfach verfügbar ist, bevor Sie das Cmdlet Test-OWAConnectivity ausführen.

Wenn das Cmdlet Test-OwaConnectivity ohne einen der Parameter ClientAccessServer oder URL auf einem Clientzugriffsserver ausgeführt wird, testet das Cmdlet den Server, auf dem das Cmdlet ausgeführt wird. Verwenden Sie den Parameter ClientAccessServer, um einen bestimmten Clientzugriffsserver zu testen.

Damit Sie das Cmdlet Test-OwaConnectivity zum Testen der Outlook Web Access-Verbindung für alle virtuellen Exchange 2007-Verzeichnisse ausführen können, muss dem verwendeten Konto die Rolle Exchange-Serveradministrator zugewiesen worden sein, und es muss der lokalen Gruppe Administratoren für den Zielserver angehören.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Um einen einzelnen URL zu testen, führen Sie Test-OwaConnectivity mit dem Parameter URL und den Anmeldeinformationen für ein vorhandenes Exchange 2007-Postfach aus. Wenn sich die URL hinter einem Lastenausgleichsmechanismus befindet, lässt sich nicht vorhersagen, welcher Clientzugriffsserver vom Cmdlet getestet wird. Da bei Verwendung des Parameters URL Anmeldeinformationen als Bestandteil der Parameter erforderlich sind, können Sie jedes Konto zum Ausführen von Test-OwaConnectivity verwenden, wenn der Parameter URL verwendet wird.

Wenn das Cmdlet ein virtuelles Verzeichnis erreicht, das kein SSL (Secure Sockets Layer) erfordert, wird dieses Verzeichnis ausgelassen, wenn nicht der Parameter AllowUnsecureAccess verwendet wird. Wenn der Parameter AllowUnsecureAccess verwendet wird, wird die testbezogene Kommunikation zwischen Servern als unverschlüsselter Text gesendet.

Das Cmdlet Test-OwaConnectivity kann als einmaliger interaktiver Task oder als von MOM (Microsoft Operations Manager) gesteuerter, geplanter Task ausgeführt werden. Um Test-OwaConnectivity als MOM-Task auszuführen, muss die Clientzugriffs-Testumgebung auf den Postfachservern verfügbar sein, die von dem Cmdlet getestet werden.

Parameter

Parameter Erforderlich Typ Beschreibung

AllowUnsecureAccess

Optional

System.Management.Automation.SwitchParameter

Wird dieser Parameter angegeben, wird das Testen virtueller Verzeichnisse aktiviert, für die SSL nicht erforderlich ist. Wird dieser Parameter nicht angegeben, überspringt der Task virtuelle Verzeichnisse, die kein SSL erfordern. Stattdessen wird ein Fehler generiert.

ClientAccessServer

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Dieser Parameter gibt den Namen des zu testenden Clientzugriffsservers an. Wird dieser Parameter angegeben, werden alle virtuellen Exchange 2007 Outlook Web Access-Verzeichnisse auf dem Clientzugriffsserver mit allen Exchange 2007-Postfachservern im lokalen Active Directory-Standort getestet. Virtuelle Microsoft Exchange 2000 Server- und Microsoft Exchange Server 2003-Verzeichnisse werden nicht getestet. Postfächer, die sich nicht auf Exchange 2007-Postfachservern befinden, werden nicht getestet. Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter URL.

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Parameter Confirm bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen des Domänencontrollers anzugeben, der Daten aus dem Verzeichnisdienst Active Directory abruft, fügen Sie dem Cmdlet den Parameter DomainController hinzu.

LightMode

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter ist für das Diagnose-Cmdlet Test-OwaConnectivity nicht implementiert. Wenn Sie diesen Parameter verwenden, ändert sich das Verhalten des Cmdlets nicht.

Hinweis

Dieses Cmdlet wird für andere Exchange 2007-Diagnose-Cmdlets implementiert. Insbesondere wird es dann verwendet, wenn Sie eine weniger intensive Version eines Cmdlets ausführen möchten.

MailboxCredential

Optional

System.Management.Automation.PSCredential

Dieser Parameter enthält die Postfachanmeldeinformationen für den Test eines einzelnen URLs.

MailboxServer

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Dieser Parameter gibt den Namen des zu testenden Postfachservers an. Wird der Parameter nicht angegeben, werden alle Postfachserver im lokalen Active Directory-Standort getestet.

MonitoringContext

Optional

System.Management.Automation.SwitchParameter

Wird dieser Parameter angegeben, unterliegt die Taskausführung der MOM-Planung. Wird dieser Task mit diesem Parameter, jedoch ohne MOM ausgeführt, wird ein Fehler generiert. Wird dieser Parameter nicht angegeben, muss der Task interaktiv von einem Administrator ausgeführt werden.

ResetTestAccountCredentials

Optional

System.Management.Automation.SwitchParameter

Der Parameter ResetTestAccountCredentials setzt das Kennwort für das Testkonto zurück, das zum Ausführen dieses Befehls verwendet wird. Das Kennwort für das Testkonto wird üblicherweise alle 7 Tage zurückgesetzt, wenn Sie Ihre Exchange-Umgebung mithilfe von Microsoft System Center Operations Manager verwalten. Bei Verwendung dieses Kennzeichens wird das Zurücksetzen des Kennworts immer dann erzwungen, wenn dies aus Sicherheitsgründen notwendig ist.

Site

Optional

Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter

Der Parameter Site wird zum Angeben des Active Directory-Standorts verwendet.

TestType

Optional

Microsoft.Exchange.Monitoring.OwaConnectivityTestType

Dieser Parameter bestimmt, ob das Cmdlet interne oder externe URLs testet. Werte sind Internal und External. Dieser Parameter kann nicht zusammen mit dem Parameter URL verwendet werden. Wird keiner der Parameter TestType oder URL angegeben, wird standardmäßig TestType:Internal verwendet.

Timeout

Optional

System.UInt32

Dieser Parameter gibt die Länge des Wartezeitraums (in Sekunden) für den Abschluss des Testvorgangs an. Der Standardwert für Timeout ist 30 Sekunden. Sie müssen für Timeout einen Wert größer als 0 Sekunden und kleiner als 1 Stunde (3600 Sekunden) angeben. Es wird empfohlen, diesen Parameter immer mit einem Wert von mindestens 5 Sekunden zu konfigurieren.

TrustAnySSLCertificate

Optional

System.Management.Automation.SwitchParameter

Wenn dieser Parameter verwendet wird, werden Fehler bei der SSL-Zertifikatsüberprüfung nicht gemeldet. Dies kann beim Testen interner URLs hilfreich sein, weil das Zuweisen mehrerer Zertifikate für ein einzelnes virtuelles Verzeichnis in IIS (Internetinformationsdienste) nicht unterstützt wird. Falls ein Verzeichnis verschiedene URLs für den internen und den externen Zugriff verwendet und über ein Zertifikat verfügt, gilt dieses Zertifikat normalerweise für die externe URL. Dieser Parameter lässt zu, dass der Task eine interne URL überprüfen kann, ohne eine Fehler zu generieren, wenn das Zertifikat nicht der URL entspricht.

URL

Optional

System.String

Dieser Parameter gibt den zu testenden Outlook Web Access-URL an. Wenn dieser Parameter verwendet wird, wird nur der angegebene URL getestet. Verwenden Sie den Parameter URL nicht zusammen mit dem Parameter ClientAccessServer. Der Parameter URL kann nicht gemeinsam mit dem Parameter TestType verwendet werden.

VirtualDirectoryName

Optional

System.String

Dieser Parameter gibt den Namen des zu testenden virtuellen Verzeichnisses auf einem bestimmten Clientzugriffsserver an. Wird dieser Parameter nicht angegeben, werden alle virtuellen Outlook Web Access-Verzeichnisse getestet, die Exchange 2007-Postfächer unterstützen.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Das erste Codebeispiel testet die Konnektivität für den URL https://mail.contoso.com/owa, wobei die Anmeldeinformationen des Benutzers contoso\kweku verwendet werden.

Das zweite Codebeispiel testet die Konnektivität für einen bestimmten Clientzugriffsserver (Contoso12). Es werden alle virtuellen Outlook Web Access-Verzeichnisse getestet, die Exchange 2007-Postfächer unterstützen. Dabei werden die virtuellen Verzeichnisse berücksichtigt, für die SSL nicht erforderlich ist.

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