Test-ImapConnectivity
Dieses Cmdlet ist nur lokal in Exchange verfügbar.
Verwenden Sie das Cmdlet Test-ImapConnectivity, um zu überprüfen, ob die Verbindung mit dem Microsoft Exchange-IMAP4-Dienst ordnungsgemäß funktioniert.
Hinweis: Dieses Cmdlet funktioniert am besten in Exchange 2010. In höheren Versionen von Exchange wird 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
Default (Standardwert)
Test-ImapConnectivity
[[-ClientAccessServer] <ServerIdParameter>]
[-Confirm]
[-ConnectionType <ProtocolConnectionType>]
[-DomainController <Fqdn>]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-MailboxServer <ServerIdParameter>]
[-MonitoringContext]
[-PerConnectionTimeout <Int32>]
[-PortClientAccessServer <Int32>]
[-ResetTestAccountCredentials]
[-Timeout <UInt32>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Das Cmdlet Test-ImapConnectivity testet die IMAP4-Konnektivität durch das Herstellen einer Verbindung mit dem angegebenen Postfach, dem angegebenen Exchange-Server oder allen Exchange-Servern, die am lokalen Active Directory-Standort 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.
- CasServer: Der Exchange-Server, mit dem der Client verbunden ist.
- LocalSite: Der Name des lokalen Active Directory-Standorts.
- Szenario: Die Vorgänge, die getestet werden. Der Test der IMAP4-Konnektivität stellt eine Verbindung mit dem Server mithilfe des IMAP4-Protokolls her, sucht nach der Testnachricht und löscht diese zusammen mit sämtlichen Nachrichten, die älter als 24 Stunden sind.
- Resultat: Die zurückgegebenen Werte sind normalerweise „Erfolg“, „Übersprungen“ oder „Fehlgeschlagen“.
- Latenz (ms): Die erforderliche Zeit zum Abschließen des Tests in Millisekunden.
- Fehler: Fehlermeldungen, die aufgetreten sind.
Sie können die Ergebnisse in eine Datei schreiben, indem Sie die Ausgabe an ConvertTo-Html und Set-Content weiterleiten. Beispiel: Test-IMAPConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\IMAP Test.html".
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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.
Hinweis: Wenn Sie in Exchange 2013 oder höher diesen Befehl ausführen, um ein einzelnes Postfach auf einem Exchange-Server zu testen, auf dem die aktive Postfachdatenbankkopie für das Postfach nicht gehostet wird, wird möglicherweise die folgende Fehlermeldung angezeigt:
Unable to create MailboxSession object to access the mailbox [user@contoso.com]. Detailed error information: [Microsoft.Exchange.Data.Storage.WrongServerException]: The user and the mailbox are in different Active Directory sites. Inner error [Microsoft.Mapi.MapiExceptionMailboxInTransit]: MapiExceptionMailboxInTransit: Detected site violation (hr=0x0, ec=1292)
Wenn Sie diesen Fehler erhalten, führen Sie den Befehl erneut auf dem Server aus, der die aktive Postfachdatenbankkopie hostet, um zu überprüfen, dass IMAP für das Postfach funktioniert.
Beispiele
Beispiel 1
Test-ImapConnectivity -ClientAccessServer Contoso12 -MailboxCredential (Get-Credential contoso\kweku)
In diesem Beispiel wird die Client-IMAP4-Konnektivität für den Server mit der Bezeichnung "Contoso12" mithilfe der Anmeldeinformationen des Benutzers "contoso\kweku" getestet.
Beispiel 2
Test-ImapConnectivity -ClientAccessServer Contoso12
In diesem Beispiel werden die Client-IMAP4-Konnektivität des Servers mit der Bezeichnung „Contoso12“ sowie alle Exchange-Postfächer getestet.
Parameter
-ClientAccessServer
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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
Parametereigenschaften
| Typ: | ServerIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise 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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ConnectionType
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Der Parameter ConnectionType gibt die Art der Verbindung an, die für die Verbindung mit dem IMAP4-Dienst verwendet wird. Gültige Werte sind:
- Nur-Text
- SSL
- TLS
Parametereigenschaften
| Typ: | ProtocolConnectionType |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DomainController
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Parametereigenschaften
| Typ: | Fqdn |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-LightMode
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Durch die Option LightMode wird der Befehl angewiesen, nur die Anmeldung am Server mithilfe des IMAP4-Protokolls zu testen. Sie müssen keinen Wert für diese Option angeben.
Wenn Sie diese Option nicht verwenden, wird auch das Senden und Empfangen von Nachrichten mithilfe des IMAP4-Protokolls durch den Befehl getestet.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MailboxCredential
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MailboxServer
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Der Parameter MailboxServer gibt den Exchange-Postfachserver an, den Sie testen möchten. Dieser Parameter identifiziert den Back-End-Server, der Proxyverbindungen vom Front-End-Server akzeptiert, wo die Clients eine Verbindung herstellen.
Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:
- Name
- Distinguished Name (DN)
- ExchangeLegacyDN
- GUID
Wenn Sie diesen Parameter nicht verwenden, werden die Verbindungen zu allen Postfachservern im lokalen Active Directory-Standort getestet.
Parametereigenschaften
| Typ: | ServerIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MonitoringContext
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PerConnectionTimeout
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Der Parameter PerConnectionTimeout gibt die Länge des Wartezeitraums pro Verbindung (in Sekunden) für den Abschluss des Testvorgangs an. Gültige Werte liegen zwischen 0 und 120 Sekunden. Die Standardeinstellung ist 120 Sekunden.
Es wird empfohlen, diesen Parameter mit einem Wert von mindestens 5 Sekunden zu konfigurieren.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PortClientAccessServer
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Der Parameter PortClientAccessServer gibt den Port an, der verwendet wird, um eine Verbindung mit dem Clientzugriffsserver herzustellen. Der Standardport für IMAP4 ist 143. Der Bereich gültiger Werte ist 0 bis 65.535.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ResetTestAccountCredentials
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Timeout
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Der Parameter Timeout gibt an, wie lange (in Sekunden) auf den Abschluss des Testvorgangs gewartet wird. Gültige Werte liegen zwischen 0 und 3600 Sekunden (1 Stunde). Die Standardeinstellung ist 180 Sekunden (3 Minuten).
Es wird empfohlen, diesen Parameter mit einem Wert von mindestens 5 Sekunden zu konfigurieren.
Parametereigenschaften
| Typ: | UInt32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-TrustAnySSLCertificate
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.
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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.