Test-Message
Gilt für: Exchange Server 2010
Letztes Änderungsdatum des Themas: 2009-07-30
Verwenden Sie das Cmdlet Test-Message, um die Auswirkungen von Posteingangsregeln auf eine spezifische Nachricht zu überprüfen. Wenn unerwartet mit einer Nachricht umgegangen wird, können Sie diese Nachricht mit diesem Cmdlet erneut übermitteln und ausführliche Informationen darüber erfassen, wie sie von den Regeln verarbeitet wird.
Syntax
Test-Message -Recipients <ProxyAddressCollection> [-Confirm [<SwitchParameter>]] [-DeliverMessage <SwitchParameter>] [-MessageFileData <Byte[]>] [-Sender <SmtpAddress>] [-SendReportTo <RecipientIdParameter>] [-WhatIf [<SwitchParameter>]]
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Recipients |
Erforderlich |
Microsoft.Exchange.Data.ProxyAddressCollection |
Der Parameter Recipients gibt die Liste von E-Mail-Adressen an, die als Empfänger der Testnachricht dienen sollen, wenn keine EML-Datei angegeben wird. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Die Option Confirm bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für die Option Confirm muss kein Wert angegeben werden. |
DeliverMessage |
Optional |
System.Management.Automation.SwitchParameter |
Die Option DeliverMessage gibt an, dass die Nachricht an das Endziel gesendet werden soll. Wenn Sie diese Option nicht angeben, wird die erneut übermittelte Nachricht den Empfängern nicht zugestellt, sondern lediglich Daten zur Problembehandlung generiert und an den angegebenen Empfänger gesendet. |
MessageFileData |
Optional |
System.Byte[] |
Der Parameter MessageFileData gibt Daten zu Dateien an, die mithilfe des Cmdlets Get-Content aus einer EML-Datei abgerufen werden. Weitere Informationen zur Syntax, die bei Verwendung dieses Parameters erforderlich ist, finden Sie unter Grundlegendes zum Import und Export von Dateien in der Exchange-Verwaltungsshell. |
Sender |
Optional |
Microsoft.Exchange.Data.SmtpAddress |
Der Parameter Sender gibt die E-Mail-Adressen an, die als Absender der Testnachricht dienen soll, wenn keine EML-Datei angegeben wird. |
SendReportTo |
Optional |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter |
Der Parameter SendReportTo gibt die E-Mail-Adresse an, an die der endgültige Bericht gesendet werden soll. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Die Option WhatIf weist den Befehl an, die für das Objekt auszuführenden Aktionen zu simulieren. Durch Verwendung der Option WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für die Option WhatIf muss kein Wert angegeben werden. |
Detaillierte Beschreibung
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. In diesem Thema sind zwar alle Parameter für das Cmdlet aufgeführt, aber Sie besitzen möglicherweise keinen Zugriff auf einige Parameter, falls diese nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Testen der Verarbeitung von Transportregeln" im Thema Transportberechtigungen.
Beispiele
BEISPIEL 1
In diesem Beispiel wird eine bestimmte E-Mail-Nachricht erneut übermittelt und der endgültige Bericht an die E-Mail-Adresse "postmaster@contoso.com" gesendet.
Test-Message -MessageFileData ([Byte[]]$(Get-Content -path c:\testmessage.eml" -encoding byte -ReadCount 0)) -SendReportTo postmaster@contoso.com