Export-Message
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-06-28
Verwenden Sie das Cmdlet Export-Message, um eine Nachricht aus einer Warteschlange auf einem Computer, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist, in einen angegebenen Dateipfad in einer Microsoft Exchange Server 2007-Organisation zu kopieren.
Syntax
Export-Message -Identity <MessageIdentity> -Path <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Das Cmdlet Export-Message kopiert Nachrichten aus einer Übermittlungswarteschlange, aus der Warteschlange "Nicht erreichbar" oder aus der Warteschlange für nicht verarbeitete Nachrichten, die sich auf einem Hub-Transport- oder Edge-Transport-Server befinden, in einen angegebenen Dateipfad. Bevor Sie eine Nachricht exportieren, müssen Sie die Nachricht zuerst anhalten. Nachrichten in der Warteschlange für nicht verarbeitete Nachrichten sind bereits angehalten. Sie können den Befehl Export-Message zum Kopieren von Nachrichten zur Übermittlung in das Wiedergabeverzeichnis eines anderen Transportservers verwenden. Um eine Nachricht zu kopieren, die sich auf einem Remoteserver befindet, schließen Sie den Servernamen als Teil der Nachrichtenidentität ein. Die Identität ist zwingend erforderlich und muss eine Nachricht in einer Warteschlange eindeutig identifizieren.
Damit Sie das Cmdlet Export-Message 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
Um das Cmdlet Export-Message auf einem Computer ausführen zu können, auf dem die Serverfunktion Edge-Transport installiert ist, müssen Sie sich mit einem Konto anmelden, das Mitglied der lokalen Gruppe Administratoren auf diesem Computer ist.
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 |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
Verwenden Sie den Identity-Parameter, um die ganze Zahl MessageIdentity anzugeben. Dabei handelt es sich um eine ganze Zahl, die eine bestimmte Nachrichten- und eine optionale Server- und Warteschlangenidentität darstellt. Für diesen Parameter gilt die folgende Syntax:
|
Path |
Erforderlich |
System.String |
Verwenden Sie den Parameter Path, um den Pfad der Datei anzugeben, in die die Nachricht exportiert wird. Der Wert des Parameters Path kann ein Dateiname, ein Verzeichnis und ein Dateiname oder nur ein Verzeichnis sein. Das Zielverzeichnis muss vorhanden sein, bevor Nachrichten exportiert werden können. Dieses Verzeichnis müssen Sie selbst erstellen. Wenn kein absoluter Pfad angegeben ist, wird das aktuelle Arbeitsverzeichnis der Exchange-Verwaltungsshell verwendet. Die im Parameter Path verwendeten Verzeichnisse können sich lokal auf dem Exchange 2007-Computer befinden, oder es kann sich dabei um einen UNC-Pfad (Universal Naming Convention) für eine Freigabe auf einem Remoteserver handeln. Wenn Sie ein vorhandenes Verzeichnis ohne Dateinamen im Wert des Parameters Path angeben, werden die Namen der Nachrichtendateien automatisch auf InterneNachrichtenID.eml festgelegt. Die InterneNachrichtenID ist eine Nachrichten-ID, die vom Exchange 2007-Server zugeordnet wird, der momentan die Nachricht verarbeitet. Ihr Konto muss über die Schreibberechtigung für das Zielverzeichnis verfügen. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter Confirm 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. |
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 Parameters WhatIf 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 |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Die folgenden Beispiele zeigen, wie Nachrichten aus einer Warteschlange in eine Datei exportiert werden. Das erste Beispiel zeigt das Exportieren einer einzelnen Nachricht in den angegebenen Dateipfad.
Das zweite Beispiel zeigt, wie der Befehl Get-Message zum Abrufen aller Nachrichten aus der angegebenen Warteschlange verwendet wird. Die Abfrageergebnisse werden anschließend mithilfe einer Pipe an den Befehl Export-Message umgeleitet, und alle Nachrichten werden in EML-Dateien kopiert, die Namen aufweisen, die auf der InterneNachrichtenID basieren.
Weitere Informationen zum Verwenden der Exchange-Verwaltungsshell für Aufgaben der Warteschlangenanzeige Sie unter Verwenden der Exchange-Verwaltungsshell zum Verwalten von Warteschlangen.
Export-Message -Identity ExchSrv1\contoso.com\1234 -Path "c:\exportfolder\filename.eml"
Get-Message -Queue "Server1\contoso.com" | Export-Message -Path "c:\exportfolder"