Test-WebServicesConnectivity

 

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

Letztes Änderungsdatum des Themas: 2010-08-18

Das Cmdlet Test-WebServicesConnectivity führt grundlegende Vorgänge zur Überprüfung der Funktionalität von Exchange-Webdiensten auf einem Microsoft Exchange Server 2007-Computer aus, auf dem die Serverfunktion ClientAccess installiert ist.

Syntax

Test-WebServicesConnectivity [-ClientAccessServer <ServerIdParameter>] [-AllowUnsecureAccess <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-ResetTestAccountCredentials <SwitchParameter>] [-Site <AdSiteIdParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-UseAutodiscoverForClientAccessServer <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das Cmdlet Test-WebServicesConnectivity ermöglicht Ihnen das Testen der Funktionalität der Exchange-Webdienste. Wenn ein Testfehler auftritt, wird eine Meldung in der Exchange-Verwaltungsshell angezeigt.

Damit Sie das Cmdlet Test-WebServicesConnectivity 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 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

AllowUnsecureAccess

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter ermöglicht dem Cmdlet Test-WebServicesConnectivity das Fortsetzen der Ausführung über einen ungesicherten Kanal, der kein SSL (Secure Sockets Layer) erfordert.

ClientAccessServer

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Dieser Parameter gibt den Clientzugriffsserver an, der bei der Ausführung des Cmdlets Test-WebServicesConnectivity verwendet werden soll.

Confirm

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt den Benutzer, 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

Der Parameter DomainController gibt den Domänencontroller an, der zum Schreiben dieser Konfigurationsänderung in den Active Directory-Verzeichnisdienst verwendet werden soll. Verwenden Sie den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers, der verwendet werden soll.

LightMode

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter ist für das Diagnose-Cmdlet Test-PopConnectivity 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 gibt das Postfach an, das bei der Ausführung des Cmdlets Test-WebServicesConnectivity verwendet werden soll.

MailboxServer

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Dieser Parameter gibt die Identität des Exchange 2007-Postfachservers an, auf dem der Test ausgeführt wird.

MonitoringContext

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter gibt an, ob das Testergebnis an Microsoft Operations Manager (MOM) weitergegeben wird. Wenn dieser Parameter auf $true festgelegt ist, wird das Testergebnis an MOM weitergegeben. Wenn dieser Parameter auf $false festgelegt ist, wird das Testergebnis nur auf der Befehlszeile ausgegeben.

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.

Timeout

Optional

System.UInt32

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

TrustAnySSLCertificate

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter ermöglicht dem Test die Verwendung aller verfügbaren SSL-Zertifikate.

UseAutodiscoverForClientAccessServer

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter gibt an, ob der Test den AutoErmittlungsdienst verwenden soll, um den Clientzugriffsserver aufzufinden.

WhatIf

Optional

System.Management.Automation.SwitchParameter

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

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Das folgende Codebeispiel testet die Exchange-Webdienste auf dem lokalen Clientzugriffsserver und gestattet dem Test die Verwendung einer ungesicherten Verbindung, die kein SSL erfordert. Es wird ein Standardtestkonto verwendet.

Test-WebServicesConnectivity -AllowUnsecureAccess