Test-ImapConnectivity
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-ImapConnectivity, um zu überprüfen, ob der IMAP4-Dienst ordnungsgemäß ausgeführt wird. Mit dem Cmdlet Test-ImapConnectivity können Sie die IMAP4-Funktionen eines angegebenen Clientzugriffsservers für alle Postfächer auf Exchange 2007-Servern am gleichen Active Directory-Standort testen.
Syntax
Test-ImapConnectivity [-ClientAccessServer <ServerIdParameter>] [-Confirm [<SwitchParameter>]] [-ConnectionType <Plaintext | Tls | Ssl>] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-PerConnectionTimeout <Int32>] [-PortClientAccessServer <Int32>] [-ResetTestAccountCredentials <SwitchParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Verwenden Sie das Cmdlet Test-ImapConnectivity, um zu überprüfen, ob der IMAP4-Dienst ordnungsgemäß ausgeführt wird. Mithilfe des Cmdlets Test-ImapConnectivity können Sie die IMAP4-Funktionalität für einen angegebenen Clientzugriffsserver testen.
Damit Sie das Cmdlet Test-PopConnectivity zum Testen der IMAP4-Funktionalität auf einem Clientzugriffsserver ausführen können, muss dem verwendeten Konto die Exchange-Serveradministrator-Rolle 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.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
ClientAccessServer |
Optional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Dieser Parameter gibt den Namen des zu testenden Clientzugriffsservers an. Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter URL. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Confirm-Parameter 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. |
ConnectionType |
Optional |
Microsoft.Exchange.Monitoring.ProtocolConnectionType |
Dieser Parameter gibt den Verbindungstyp an, der verwendet wird, um eine Verbindung mit dem Clientzugriffsserver herzustellen. |
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 Cmdlet Test-ImapConnectivity 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. |
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, wird der Task vom Planungsmodul von Microsoft Operations Manager (MOM) ausgeführt. 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. |
PerConnectionTimeout |
Optional |
System.Int32 |
Dieser Parameter gibt die Länge des Wartezeitraums pro Verbindung (in Sekunden) für den Abschluss des Testvorgangs an. Der Standardwert für PerConnectionTimeout ist 24 Sekunden. Sie müssen einen Timeoutwert größer als 0 Sekunden und kleiner als 120 Sekunden angeben. Es wird empfohlen, diesen Parameter immer mit einem Wert von mindestens 5 Sekunden zu konfigurieren. |
PortClientAccessServer |
Optional |
System.Int32 |
Dieser Parameter gibt den Port an, der verwendet wird, um eine Verbindung mit dem Clientzugriffsserver herzustellen, der mit dem Cmdlet Test-ImapConnectivity verwendet wird. |
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. |
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 (Secure Sockets Layer) nicht gemeldet. Dieser Parameter lässt zu, dass das Cmdlet Test-ImapConnectivity den IMAP4-Dienst überprüft, ohne eine Fehler zu generieren, wenn das Zertifikat nicht der URL des Clientzugriffsservers entspricht. |
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 Parameter WhatIf muss kein Wert angegeben werden. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Beispiel
Das erste Codebeispiel testet die IMAP4-Konnektivität für den Clientzugriffsserver "Contoso12", wobei die Anmeldeinformationen des Benutzers "contoso\kweku" verwendet werden.
Das zweite Codebeispiel testet die IMAP4-Konnektivität für einen bestimmten Clientzugriffsserver namens "Contoso12", wobei alle Exchange 2007-Postfächer getestet werden.
Test-ImapConnectivity -ClientAccessServer:Contoso12 -MailboxCredential:(get-credential contoso\kweku)
Test-ImapConnectivity -ClientAccessServer:Contoso12