Test-WebServicesConnectivity
Dieses Cmdlet ist nur lokal in Exchange verfügbar.
Verwenden Sie das Cmdlet Test-WebServicesConnectivity, um die Clientkonnektivität mit virtuellen Verzeichnissen der Exchange-Webdienste zu testen.
Hinweis: Dieses Cmdlet funktioniert am besten in Exchange 2010. In höheren Versionen von Exchange wurde die Funktionalität dieses Cmdlets durch verwaltete Verfügbarkeit ersetzt. Um optimale Ergebnisse zu erzielen, verwenden Sie das Cmdlet Invoke-MonitoringProbe, und geben Sie den relevanten aktiven Monitortest an, anstatt dieses Cmdlet zu verwenden.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Test-WebServicesConnectivity
[[-ClientAccessServer] <ServerIdParameter>]
[-AllowUnsecureAccess]
[-Confirm]
[-DomainController <Fqdn>]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-MailboxServer <ServerIdParameter>]
[-ResetTestAccountCredentials]
[-Timeout <UInt32>]
[-TrustAnySSLCertificate]
[-UseAutodiscoverForClientAccessServer]
[-WhatIf]
[<CommonParameters>] Test-WebServicesConnectivity
[[-Identity] <MailboxIdParameter>]
-AutoDiscoverServer <ClientAccessServerIdParameter>
[-Confirm]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] Test-WebServicesConnectivity
[[-Identity] <MailboxIdParameter>]
[-MonitoringContext]
[-Confirm]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] Test-WebServicesConnectivity
[[-Identity] <MailboxIdParameter>]
[-ClientAccessServer <ClientAccessServerIdParameter>]
[-Confirm]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] Beschreibung
Das Cmdlet Test-WebServicesConnectivity testet die Konnektivität von Exchange-Webdiensten, indem eine Verbindung mit einem angegebenen virtuellen Verzeichnis der Exchange-Webdienste, mit virtuellen Exchange-Webdiensten auf einem angegebenen Exchange-Server oder mit virtuellen Exchange-Webdienstverzeichnissen hergestellt wird, die auf der lokalen Active Directory-Website verfügbar sind.
Wenn Sie das Cmdlet erstmalig verwenden, müssen Sie möglicherweise einen Testbenutzer erstellen. Führen Sie den folgenden Befehl aus, um einen Testbenutzer zu erstellen:
&env:ExchangeInstallPath\Scripts\New-TestCasConnectivityUser.ps1$
Die Testergebnisse werden auf dem Bildschirm angezeigt. Das Cmdlet gibt folgende Informationen zurück.
- Quelle: Quellserver.
- ServiceEndpoint: Zielserver.
- Szenario: Die Vorgänge, die getestet werden. Werte sind Autodiscover: SOAP Provider und EWS: GetFolder (Vollmodus) oder EWS: ConvertID (Light-Modus).
- Ergebnis: Die zurückgegebenen Werte sind in der Regel Success oder *FAILURE*.
- Latenz (MS): Die zum Abschließen des Tests erforderliche Zeit in Millisekunden
Sie können die Ergebnisse in eine Datei schreiben, indem Sie die Ausgabe an ConvertTo-Html und Set-Content weiterleiten. Beispiel: Test-WebServicesConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\EWS Test.html".
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-WebServicesConnectivity -AllowUnsecureAccessIn Exchange 2010 testet dieses Beispiel Exchange-Webdienste auf dem lokalen Clientzugriffsserver und ermöglicht es dem Test, eine ungesicherte Verbindung zu verwenden, die kein SSL erfordert. Es wird ein Standardtestkonto verwendet.
Beispiel 2
Test-WebServicesConnectivity -ClientAccessServer MBX01In diesem Beispiel wird die Clientverbindung mit Exchange-Webdiensten auf dem Server mit dem Namen MBX01 getestet.
Parameter
-AllowUnsecureAccess
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der AllowUnsecureAccess-Switch gibt an, ob der Befehl weiterhin über einen ungesicherten Kanal ausgeführt werden soll, für den Secure Sockets Layer (SSL) nicht erforderlich ist. Sie müssen bei dieser Option keinen Wert angeben.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-AutoDiscoverServer
Der Parameter AutoDiscoverServer gibt den Server mit der installierten Clientzugriffs-Serverrolle an, die für "AutoErmittlung" verwendet wird.
Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:
- Sie können jeden Wert verwenden, der den Server eindeutig bestimmt, z. B.:
- Name (Beispiel: Exchange01)
- Distinguished Name (DN) (Beispiel: CN=Exchange01,CN=Servers,CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,CN=First Organization,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=contoso,DC=com)
- Exchange-Legacy-DN (Beispiel /o=First Organization/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=Exchange01)
Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter ClientAccessServer.
| Type: | ClientAccessServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ClientAccessServer
Der Parameter ClientAccessServer gibt den zu testenden Exchange-Server an. Auf diesem Server ist die Clientzugriffs-Serverrolle installiert, und er ist verantwortlich für das Akzeptieren von Clientverbindungen.
Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:
- Name
- Distinguished Name (DN)
- ExchangeLegacyDN
- GUID
Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter AutoDiscoverServer.
| Type: | ServerIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
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 |
-Identity
Der Parameter Identity gibt das Postfach für den Test an. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:
- Name
- Alias
- Distinguished Name (DN)
- Distinguished Name (DN)
- Domäne\benutzername
- E-Mail-Adresse
- GUID
- LegacyExchangeDN
- SamAccountName
- Benutzer-ID oder User Principal Name (UPN)
Bei Verwendung dieses Parameters müssen Sie auch den Parameter MailboxCredential verwenden.
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LightMode
Die Option LightMode weist den Befehl an, nur eine Teilmenge der Tests auszuführen. Sie müssen bei dieser Option keinen Wert angeben.
Wenn Sie diesen Parameter verwenden, wird der Test EWS: ConvertId anstatt dem Test EWS: GetFolder durchgeführt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MailboxCredential
Der Parameter MailboxCredential gibt die Postfachanmeldeinformationen an, die für einen einzelnen Postfachtest verwendet werden.
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.
Dieser Parameter ist erforderlich, wenn Sie den Parameter Identity verwenden.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MailboxServer
Der Parameter MailboxServer gibt die Identität des Exchange-Postfachservers an, auf dem der Test ausgeführt wird.
| 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: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 |
-Timeout
Der Parameter Timeout gibt an, wie lange (in Sekunden) auf den Abschluss des Testvorgangs gewartet wird. Der Standardwert für den Timeout-Parameter 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.
| 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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UseAutodiscoverForClientAccessServer
Dieser Parameter ist nur in Exchange Server 2010 verfügbar.
Der Schalter UseAutodiscoverForClientAccessServer gibt an, ob der Test den AutoErmittlungsdienst verwenden soll, um den Clientzugriffsserver zu suchen. Sie müssen bei dieser Option keinen Wert angeben.
| Type: | SwitchParameter |
| 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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für