Export-Mailbox (RTM)

  • Artikel

 

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:

  • Alias

  • SMTP-Adresse (Simple Mail Transfer Protocol)

  • Anzeigename

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"