Test-Mailflow (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-11

Mithilfe des Cmdlets Test-Mailflow können Sie herausfinden, ob das Senden und Empfangen von E-Mail über das Systempostfach auf einem Computer, auf dem die Serverfunktion Mailbox installiert ist, erfolgreich möglich ist. Mit diesem Cmdlet kann außerdem überprüft werden, ob E-Mail zwischen Postfachservern im Rahmen eines definierten Wartezeit-Schwellenwerts gesendet wird.

Syntax

Test-Mailflow [-Identity <ServerIdParameter>] [-ActiveDirectoryTimeout <Int32>] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>]

Test-Mailflow [-Identity <ServerIdParameter>] -TargetEmailAddress <String> [-ActiveDirectoryTimeout <Int32>] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>] [-TargetEmailAddressDisplayName <String>]

Test-Mailflow [-Identity <ServerIdParameter>] -TargetMailboxServer <ServerIdParameter> [-ActiveDirectoryTimeout <Int32>] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>]

Test-Mailflow [-Identity <ServerIdParameter>] -AutoDiscoverTargetMailboxServer <SwitchParameter> [-ActiveDirectoryTimeout <Int32>] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>]

Test-Mailflow [-ActiveDirectoryTimeout <Int32>] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>]

Detaillierte Beschreibung

Das Cmdlet Test-Mailflow testet die Übermittlung, den Transport und die Zustellung von Nachrichten. Es überprüft, ob jeder Postfachserver erfolgreiche eine Nachricht versenden kann. Mithilfe dieses Cmdlets kann außerdem überprüft werden, ob das Systempostfach auf einem Postfachserver erfolgreich eine Nachricht an das Systempostfach auf einem anderen Postfachserver senden kann.

Dieser Task bietet hilfreiche Informationen für den Administrator, wenn er manuell ausgeführt wird. Er kann auch mithilfe von Überwachungstools aufgerufen werden, wie z. B. Microsoft Operations Manager (MOM), Exchange Best Practices Analyzer oder Exchange-Problembehandlungs-Assistent. Wenn der Task von MOM aufgerufen wird, werden Warnungen generiert, die Fehler oder niedrige Leistung anzeigen.

Das Cmdlet Test-Mailflow kann einen lokalen oder einen Remotetest ausführen. Wenn keine Parameter angegeben werden, wird ein lokaler Test ausgeführt und der Server sendet eine E-Mail-Testnachricht an sich selbst. Wenn einer der Parameter TargetEmailAddress, TargetMailboxServer oder AutoDiscoverTargetMailboxServer angegeben wird, wird ein Remotetest ausgeführt. Die Parameter TargetEmailAddress, TargetMailboxServer und AutoDiscoverTargetMailboxServer schließen sich gegenseitig aus.

Zum Testen der E-Mail-Zustellung in einem gesamtstrukturübergreifenden Szenario wird der Parameter TargetEmailAddress verwendet. Zum Testen der E-Mail-Zustellung zwischen Postfachservern in derselben Active Directory-Gesamtstruktur wird der Parameter TargetMailboxServer verwendet. Zum automatischen Auffüllen der Liste der Zielserver, auf denen die Nachrichtenübermittlung getestet werden soll, wird der Parameter AutoDiscoverTargetMailboxServer verwendet.

Wenn mehr als einer dieser Parameter angegeben wird, hat der Parameter AutoDiscoverTargetMailboxServer Vorrang vor den Parametern TargetEmailAddress und TargetMailboxServer. Der Parameter TargetMailboxServer hat wiederum Vorrang vor dem Parameter TargetEmailAddress. Wenn ein lokaler Test ausgeführt wird, muss der lokale Server für jede Postfachdatenbank über ein Systempostfach verfügen. Bei Ausführung eines Remotetests müssen die Quell- und Zielserver über ein Systempostfach verfügen, oder es muss ein spezielles Postfach mithilfe von Parametern angegeben werden.

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

  • Exchange-Serveradministrator-Rolle und lokale Gruppe Administratoren für den Server, auf dem das Cmdlet ausgeführt werden soll.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

AutoDiscoverTargetMailboxServer

Erforderlich

System.Management.Automation.SwitchParameter

Der Parameter AutoDiscoverTargetMailboxServer füllt automatisch eine Liste von Zielservern auf, an die eine Testnachricht gesendet werden soll. Der Task fragt den Active Directory-Verzeichnisdienst ab, um alle Postfachserver zu ermitteln, und sendet dann jedem einzeln eine Testnachricht.

TargetEmailAddress

Erforderlich

System.String

Der Parameter TargetEmailAddress gibt die SMTP-Adresse (Simple Mail Transfer Protocol) des Postfachs an, an das Testnachrichten gesendet werden. Verwenden Sie diesen Parameter zum Senden von Testnachrichten an einen Postfachserver in einer Remotegesamtstruktur. Wenn dieser Parameter verwendet wird, handelt es sich bei dem Test immer um einen Remotetest.

TargetMailboxServer

Erforderlich

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Der Parameter TargetMailboxServer gibt mindestens einen Postfachserver in der lokalen Exchange-Organisation an, an den Testnachrichten gesendet werden.

ActiveDirectoryTimeout

Optional

System.Int32

Der Parameter ActiveDirectoryTimeout gibt die Anzahl von Sekunden an, die verstreichen kann, bevor der Task den Administrator mit einer Meldung über die Verzögerung informiert. Die Standardeinstellung ist 15 Sekunden.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Verwenden Sie den Parameter DomainController, um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, an den dieser Befehl bindet und der diese Änderung in Active Directory schreibt.

ErrorLatency

Optional

System.Int32

Der Parameter ErrorLatency gibt an, wie lange auf die Zustellung einer Testnachricht gewartet werden soll, bis in MOM ein Fehlerereignis protokolliert wird. Wenn eine Testnachricht an den lokalen Postfachserver gesendet wird, ist die Standardeinstellung 15 Sekunden, beim Senden einer Testnachricht an einen Remotepostfachserver 180 Sekunden.

ExecutionTimeout

Optional

System.Int32

Der Parameter ExecutionTimeout gibt die maximale Dauer an, über die dieser Task ausgeführt werden kann, bevor der Test als Fehler eingestuft wird. Geht vor Ablauf dieser Zeit keine Testnachricht oder ein Übermittlungsbericht ein, wird der Task beendet und ein Fehler gemeldet. Wenn der Task in der Exchange-Verwaltungsshell ausgeführt wird, ist die Standardeinstellung 240 Sekunden. Bei Verwendung des Parameters MonitoringContext beträgt die Standardeinstellung 15 Sekunden.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Der Parameter Identity gibt den Namen des Quellpostfachservers oder die SMTP-Adresse des Quellpostfachs an, von dem aus eine Testnachricht gesendet wird. Die Standardeinstellung ist der lokale Postfachserver.

MonitoringContext

Optional

System.Boolean

Der Parameter MonitoringContext wird nur verwendet, wenn MOM für die Serverüberwachung verwendet wird. Wenn Sie für den Wert $true festlegen, füllt das Cmdlet das Objekt MonitoringContext mit Ereignissen und Leistungsindikatoren, die von MOM verwendet werden. Der Standardwert für diesen Parameter ist $false.

TargetEmailAddressDisplayName

Optional

System.String

Der Parameter TargetEmailAddressDisplayName gibt den Anzeigenamen des Postfachs an, an das Testnachrichten gesendet werden.

Eingabetypen

Rückgabetypen

Das Cmdlet Test-Mailflow gibt die folgenden Eigenschaften zurück, die Sie bei der Behebung von Problemen in der Nachrichtenübermittlung unterstützen:

  • MailFlowResult   Diese Eigenschaft zeigt entweder Erfolg oder Fehler an.

  • MessageLatencyTime   Diese Eigenschaft zeigt die Zeit in Sekunden an, die das Senden einer Testnachricht an den empfangenden Postfachserver benötigt hat.

  • IsRemoteTest   Diese Eigenschaft zeigt an, ob die Testnachricht an einen anderen Server als den lokalen Postfachserver oder ob sie an eine E-Mail-Adresse gesendet wurde.

Fehler

Fehler Beschreibung

 

Ausnahmen

Ausnahmen Beschreibung

 

Beispiel

Im ersten Beispiel wird das Senden einer Testnachricht vom Server Mailbox1 an den Server Mailbox2 gezeigt.

Im zweiten Beispiel wird das Senden einer Testnachricht vom Server Mailbox1 an die E-Mail-Adresse john@contoso.com gezeigt. In diesem Beispiel wird die Testnachricht an einen Postfachserver in einer Remotegesamtstruktur gesendet.

Test-Mailflow Mailbox1 -TargetMailboxServer Mailbox2
Test-Mailflow Mailbox1 -TargetEmailAddress john@contoso.com