Test-MapiConnectivity (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-05

Mithilfe des Cmdlets Test-MapiConnectivity können Sie die Serverfunktionalität überprüfen, indem Sie sich bei dem von Ihnen angegebenen Postfach anmelden. Wenn Sie kein Postfach angeben, führt das Cmdlet die Anmeldung bei dem Systempostfach in der von Ihnen angegebenen Datenbank durch.

Syntax

Test-MAPIConnectivity [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-Server <ServerIdParameter>]

Test-MAPIConnectivity -Database <DatabaseIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>]

Test-MAPIConnectivity -Identity <MailboxIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>]

Detaillierte Beschreibung

Damit Sie das Cmdlet Test-MapiConnectivity ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • die Rolle Exchange-Serveradministrator und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver

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.

Verwenden Sie das Cmdlet Test-MapiConnectivity, um die Serverfunktionalität zu überprüfen. Dieses Cmdlet führt die Anmeldung bei dem von Ihnen angegebenen Postfach oder bei dem Systempostfach durch, wenn Sie den Parameter Identity nicht angeben, und ruft eine Liste der Elemente im Posteingang ab. Durch das Anmelden bei dem Postfach werden zwei kritische Protokolle getestet, die verwendet werden, wenn ein Client eine Verbindung mit einem Postfachserver herstellt: MAPI und LDAP. Während der Authentifizierung überprüft das Cmdlet Test-MapiConnectivity indirekt, ob der MAPI-Server, der Exchange-Informationsspeicher und der Verzeichnisdienstzugriff (Directory Service Access, DSAccess) funktionieren.

Das Cmdlet führt die Anmeldung bei dem von Ihnen angegebenen Postfach mit den Anmeldeinformationen des Kontos durch, mit dem Sie auf dem lokalen Computer angemeldet sind. Im Anschluss an eine erfolgreiche Authentifizierung greift das Cmdlet Test-MapiConnectivity auf das Postfach zu, um zu überprüfen, ob die Datenbank funktioniert. Wenn eine erfolgreiche Verbindung mit einem Postfach hergestellt wird, ermittelt das Cmdlet zusätzlich die Zeit, zu der der Anmeldeversuch unternommen wurde.

Mit dem Befehl können drei verschiedene Parameter verwendet werden: Database, Identity und Server.

  • Der Parameter Database akzeptiert eine Datenbankidentität und testet, ob eine Anmeldung bei dem Systempostfach in der angegebenen Datenbank möglich ist.

  • Der Parameter Identity akzeptiert eine Postfachidentität und testet, ob eine Anmeldung bei einem bestimmten Postfach möglich ist.

  • Der Parameter Server akzeptiert eine Serveridentität und testet, ob eine Anmeldung bei jedem Systempostfach auf dem angegebenen Server möglich ist.

Parameter

Parameter Erforderlich Typ Beschreibung

Database

Erforderlich

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Der Parameter Database gibt die Datenbank an, in der die Verbindung mit dem Systempostfach getestet werden soll. Wenn Sie diesen Parameter oder den Parameter Identity nicht angeben, prüft der Befehl das Systempostfach in jeder Datenbank auf dem angegebenen Server. Die Überprüfung erfolgt auf dem lokalen Server, wenn Sie den Parameter Server nicht angeben.

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Der Parameter Identity gibt ein zu testendes Postfach an. Folgende Werte können verwendet werden:

  • GUID

  • Distinguished Name (DN)

  • Domäne\Konto

  • Benutzerprinzipalname (User Principal Name, UPN)

  • Legacy-Exchange-DN

  • SMTP-Adresse (Simple Mail Transfer Protocol)

  • Alias

  • Dieser Parameter akzeptiert Pipelineeingaben von den Cmdlets Get-Mailbox und Get-Recipient. Wenn ein Objekt von dem Cmdlet Get-Mailbox oder Get-Recipient per Pipeline übergeben wird, ist dieser Parameter nicht erforderlich.

  • Wenn Sie diesen Parameter nicht angeben, prüft das Cmdlet das Systempostfach in der von Ihnen angegebenen Datenbank.

ActiveDirectoryTimeout

Optional

System.Int32

Der Parameter ActiveDirectoryTimeout gibt den Zeitraum in Sekunden an, der für jede Active Directory-Operation zulässig ist, bevor es zum Timeout kommt. Die Standardeinstellung ist 15 Sekunden.

AllConnectionsTimeout

Optional

System.Int32

Der Parameter ConnectionTimeout gibt den Zeitraum in Sekunden an, den das erfolgreiche Herstellen sämtlicher Verbindungen dauern darf, bevor für das Cmdlet ein Timeout eintritt. Der Countdown für den Timeout beginnt erst, wenn alle für das Einrichten der Verbindungen erforderlichen Informationen von Active Directory abgerufen wurde. Der Standardwert ist 90 Sekunden.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Der Parameter DomainController gibt den Domänencontroller an, der für den Zugriff auf 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.

MonitoringContext

Optional

System.Boolean

Der Parameter MonitoringContext gibt an, ob die Ergebnisse des Befehls Überwachungsereignisse und Leistungsindikatoren umfassen sollen. Die beiden möglichen Werte für diesen Parameter sind $true oder $false. Wenn Sie $true angeben, beinhalten die Ergebnisse zusätzlich zu den Informationen über MAPI-Transaktionen noch Überwachungsereignisse und Leistungsindikatoren.

PerConnectionTimeout

Optional

System.Int32

Der Parameter PerConnectionTimeout gibt den Zeitraum in Sekunden an, den das erfolgreiche Herstellen einer Verbindung dauern darf, bevor es zum Timeout der Verbindung kommt. Die Standardeinstellung ist 10 Sekunden.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Der Parameter Server gibt den Server an, auf dem die MAPI-Verbindung getestet werden soll. Der Befehl testet die MAPI-Verbindung mit jedem Systempostfach auf dem angegebenen Server.

Wenn Sie diesen Parameter nicht angeben, prüft der Befehl das Postfach auf dem lokalen Server.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

Ausnahmen

Ausnahmen Beschreibung

 

Beispiel

Das erste Beispiel testet die Verbindung mit dem Server "Server01".

Das zweite Beispiel testet die Verbindung mit einem Postfach, das als Domänenname und Benutzername angegeben wurde.

Test-MapiConnectivity -Server "Server01"
Test-MapiConnectivity -Identity "midwest\john"