Export-Mailbox (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-05
Verwenden Sie das Cmdlet Export-Mailbox, um den Inhalt eines Postfachs in einen bestimmten Postfachordner zu verschieben.
Syntax
export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-DeleteContent <SwitchParameter>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]
Detaillierte Beschreibung
Damit Sie das Cmdlet Export-Mailbox 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.
Sie können keine Daten aus einem Postfach in einer Gesamtstruktur in ein Postfach in einer anderen Gesamtstruktur exportieren. Quell- und Zielpostfächer müssen sich in derselben Gesamtstruktur befinden.
Mit dem Cmdlet Export-Mailbox werden alle leeren Ordner sowie alle Ordner mit Sonderfunktionen in das Zielverzeichnis exportiert. Es stehen folgende Ordner mit Sonderfunktionen zur Verfügung:
Inbox
Gelöschte Elemente
Drafts
Junk-E-Mail
Outbox
Gesendete Elemente
Journal
Kalender
Kontakte
Notizen
Aufgaben
Das Cmdlet Export-Mailbox exportiert auch Nachrichten aus dem Papierkorb. Weitere Informationen zu Nachrichten im Papierkorb finden Sie unter Wiederherstellen von gelöschten Elementen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Der Parameter Identity gibt das Postfach an, dessen Inhalt exportiert wird. Folgende Werte können verwendet werden:
Wird das Get-Mailbox-Befehlsobjekt mithilfe einer Pipeline übergeben, muss dieser Parameter nicht angegeben werden. |
TargetFolder |
Erforderlich |
System.String |
Der Parameter TargetFolder gibt den Postfachordner auf oberster Ebene an, der in dem mit dem Parameter TargetMailbox angegebenen Postfach erstellt wird. Dieser Ordner enthält einen Unterordner namens Wiederhergestellte Daten - <Alias des Quellpostfachs> - <Datum/Uhrzeit (Zeitstempel)>. Der Unterordner enthält die exportierten Daten. Wenn der von Ihnen angegebene Zielordner für das Zielpostfach bereits vorhanden ist, werden die exportierten Daten dem vorhandenen Ordner hinzugefügt. Wenn der Zielordner nicht vorhanden ist, wird er erstellt. |
TargetMailbox |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Der Parameter TargetMailbox gibt das Postfach an, in dem der Zielordner erstellt wird. Das angegebene Postfach muss bereits bestehen, damit der Befehl erfolgreich ausgeführt werden kann. |
AllContentKeywords |
Optional |
System.String[] |
Der Parameter AllContentKeywords gibt die Schlüsselwörter für den zu verschiebenden Inhalt an. Findet der Befehl ein im Nachrichtentext, Anlageninhalt oder Betreff angegebenes Schlüsselwort, so werden die entsprechenden Nachrichten exportiert. Hinweis Dies unterscheidet sich von der Verwendung der Parameter ContentKeywords und SubjectKeywords. Bei Verwendung der Parameter ContentKeywords und SubjectKeywords exportiert der Befehl nur Nachrichten, die sowohl das für den Parameter ContentKeywords angegebene Schlüsselwort im Nachrichtentext oder Anlageninhalt als auch das für den Parameter SubjectKeywords angegebene Schlüsselwort im Betreff aufweisen. |
AttachmentFilenames |
Optional |
System.String[] |
Der Parameter AttachmentFilenames gibt den Filter für Anlagen an. Sie können Platzhalterzeichen in der Zeichenfolge verwenden. Zum Exportieren von Elementen mit der Erweiterung TXT können Sie beispielsweise "*.txt" verwenden. |
BadItemLimit |
Optional |
System.Int32 |
Der Parameter BadItemLimit gibt an, wie viele beschädigte Elemente in einem Postfach ausgelassen werden können, bevor der Exportvorgang fehlschlägt. |
ContentKeywords |
Optional |
System.String[] |
Der Parameter ContentKeywords gibt die Schlüsselwörter für den zu verschiebenden Inhalt an. Findet der Befehl ein im Nachrichtentext oder Anlageninhalt angegebenes Schlüsselwort, so werden die entsprechenden Nachrichten exportiert. |
DeleteContent |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter DeleteContent legt fest, dass der Inhalt aus dem Quellpostfach nach dem Export in einen Ordner gelöscht wird. Der Quellordner wird nicht gelöscht. |
EndDate |
Optional |
System.DateTime |
Der Parameter EndDate gibt das Enddatum zum Filtern des aus dem Quellpostfach zu exportierenden Inhalts an. Es werden nur die Elemente im Postfach exportiert, deren Datum entweder vor dem Enddatum liegt oder diesem entspricht. Verwenden Sie bei Eingabe eines bestimmten Datums das kurze Datumsformat entsprechend den unter Regionale Einstellungen auf dem lokalen Computer konfigurierten Konventionen. Wenn Ihr Computer zum Verwenden des kurzen Datumsformats TT.MM.JJJJ konfiguriert ist, geben Sie für den 1. März 2006 Folgendes ein: 01.03.2006. |
ExcludeFolders |
Optional |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
Der Parameter ExcludeFolders gibt die Liste der vom Export auszuschließenden Ordner an. |
GlobalCatalog |
Optional |
Microsoft.Exchange.Data.Fqdn |
Der Parameter GlobalCatalog gibt den globalen Katalog an, der für die Suche nach dem Zielpostfach verwendet wird. |
IncludeFolders |
Optional |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
Der Parameter IncludeFolders gibt die Liste der zu exportierenden Ordner an. |
Locale |
Optional |
System.Globalization.CultureInfo |
Der Parameter Locale gibt das Gebietsschema der zu exportierenden Nachrichten an. Mit dem Befehl werden nur Nachrichten mit dem angegebenen Gebietsschema exportiert. |
MaxThreads |
Optional |
System.Int32 |
Der Parameter MaxThreads gibt die maximale Anzahl der Threads an, die verwendet werden. |
ReportFile |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
Der Parameter ReportFile gibt den Pfad und den Dateinamen für das XML-Berichtsprotokoll an. |
StartDate |
Optional |
System.DateTime |
Der Parameter StartDate gibt das Startdatum zum Filtern des aus dem Quellpostfach zu exportierenden Inhalts an. Es werden nur die Elemente im Postfach exportiert, deren Datum nach dem angegebenen Startdatum liegt. Verwenden Sie bei Eingabe eines bestimmten Datums das kurze Datumsformat entsprechend den unter Regionale Einstellungen auf dem lokalen Computer konfigurierten Konventionen. Wenn Ihr Computer zum Verwenden des kurzen Datumsformats TT.MM.JJJJ konfiguriert ist, geben Sie für den 1. März 2006 Folgendes ein: 01.03.2006. |
SubjectKeywords |
Optional |
System.String[] |
Der Parameter SubjectKeywords legt die Schlüsselwortfilter für den Betreff der Elemente im Quellpostfach fest. |
ValidateOnly |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter ValidateOnly weist den Befehl an, die für das Objekt auszuführenden Aktionen lediglich zu simulieren. Durch Verwendung des Parameters ValidateOnly kann der Administrator die resultierenden Änderungen anzeigen, ohne diese Änderungen tatsächlich auszuführen. Hinweis Wenn Sie den Befehl Export-Mailbox mit diesem Parameter ausführen, werden keine Filter auf die Nachrichten angewendet. Es wird nur überprüft, ob die Quell- und Zielpostfächer vorhanden sind. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
Beispiel
Das erste Beispiel zeigt, wie der Inhalt des Postfachs des Benutzers john@contoso.com in den Ordner MyData im Postfach ExportMailbox exportiert wird.
Das zweite Beispiel zeigt, wie Sie mithilfe von Filtern die Elemente im Quellpostfach festlegen, die in den Export einbezogen werden. In diesem Beispiel werden alle Elemente aus dem Postfach des Benutzers contoso\john exportiert, die das Schlüsselwort "merger" im Nachrichtentext oder Anlageninhalt enthalten, über eine Anlage mit dem Namen *orgchart* verfügen und ein Datum nach dem 01.03.2006, 12:01:00 Uhr aufweisen.
Im dritten Beispiel wird aufgezeigt, wie Sie nach bestimmten Elementen suchen und diese aus einem Postfach löschen können. In diesem Beispiel werden zuerst alle Postfächer der Datenbank DB1 abgerufen, und anschließend wird nach Elementen mit der Zeichenfolge "Virus message" im Betreff gesucht. Diese Elemente werden in ein anderes Postfach exportiert und aus dem Quellpostfach gelöscht.
Aus dem vierten Beispiel geht hervor, dass Sie die Ausgabe des Befehls Get-User mittels Pipelining an den Befehl Export-Mailbox umleiten können. Darüber hinaus werden in diesem Beispiel zwei Ordner vom Export ausgeschlossen. Die Elemente der Ordner Junk-E-Mail und Kontakte aus Johns Postfach werden nicht nach ExportMailbox exportiert.
Hinweis
Sie können auch die Ausgabe des Befehls Get-Recipient oder Get-Mailbox mittels Pipelining an Export-Mailbox umleiten.
Export-Mailbox -Identity john@contoso.com -TargetMailbox ExportMailbox -TargetFolder MyData
Export-Mailbox -Identity contoso\john -TargetMailbox ExportMailbox -TargetFolder MyData -ContentKeywords "merger" -AttachmentFilenames "*orgchart*" -StartDate "03/01/2006 12:01:00"
Get-Mailbox -Database DB1 | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder VirusData -SubjectKeywords "Virus message" -DeleteContent
Get-User john | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder MyData -ExcludeFolders "\Junk E-Mail","\Contacts"