New-MailboxExportRequest

 

Gilt für:Exchange Server 2013

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet New-MailboxExportRequest, um den Export von Inhalten eines primären Postfachs oder Archivs in eine PST-Datei zu starten.

HinweisHinweis:
Dieses Cmdlet ist nur in der Rolle für den Postfachimport-/export verfügbar. Diese Rolle ist standardmäßig keiner Rollengruppe zugewiesen. Um dieses Cmdlet zu verwenden, müssen Sie die Rolle für den Postfachimport-/export einer Rollengruppe hinzufügen (beispielsweise der Rollengruppe „Organisationsverwaltung“). Weitere Informationen finden Sie unter Verwalten von Rollengruppen im Abschnitt „Hinzufügen einer Rolle zu einer Rollengruppe“.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax.

New-MailboxExportRequest -FilePath <LongPath> -Mailbox <MailboxOrMailUserIdParameter> [-AssociatedMessagesCopyOption <DoNotCopy | MapByMessageClass | Copy>] [-ConflictResolutionOption <KeepSourceItem | KeepLatestItem | KeepAll>] [-ContentFilter <String>] [-ContentFilterLanguage <CultureInfo>] [-ExcludeDumpster <SwitchParameter>] [-ExcludeFolders <String[]>] [-IncludeFolders <String[]>] [-IsArchive <SwitchParameter>] [-RemoteCredential <PSCredential>] [-RemoteHostName <Fqdn>] [-SourceRootFolder <String>] [-TargetRootFolder <String>] [-AcceptLargeDataLoss <SwitchParameter>] [-BadItemLimit <Unlimited>] [-BatchName <String>] [-CompletedRequestAgeLimit <Unlimited>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-InternalFlags <InternalMrsFlag[]>] [-LargeItemLimit <Unlimited>] [-Name <String>] [-Priority <Lowest | Lower | Low | Normal | High | Higher | Highest | Emergency>] [-SkipMerging <SkippableMergeComponent[]>] [-Suspend <SwitchParameter>] [-SuspendComment <String>] [-WhatIf [<SwitchParameter>]] [-WorkloadType <None | Local | Onboarding | Offboarding | TenantUpgrade | LoadBalancing | Emergency | RemotePstIngestion | SyncAggregation | RemotePstExport>]

In diesem Beispiel wird das primäre Postfach von Ayla Kol in eine PST-Datei in den freigegebenen Netzwerkordner "PSTFileShare" auf "SERVER01" exportiert.

New-MailboxExportRequest -Mailbox AylaKol -FilePath "\\SERVER01\PSTFileShare\Ayla_Recovered.pst"

In diesem Beispiel wird das Archiv von Benutzer "Kweku" in eine PST-Datei in den freigegebenen Netzwerkordner "PSTFileShare" auf "SERVER01" exportiert.

New-MailboxExportRequest -Mailbox Kweku -FilePath "\\SERVER01\PSTFileShare\Kweku_Archive.pst" -IsArchive

In diesem Beispiel werden Nachrichten exportiert, die die Worte "company" und "profit" im Nachrichtentext enthalten und von Benutzer "Tony" vor dem 01.01.12 empfangen wurden.

New-MailboxExportRequest -Mailbox Tony -ContentFilter {(body -like "*company*") -and (body -like "*profit*") -and (Received -lt "01/01/2012")} -FilePath "\\SERVER01\PSTFileShare\Tony_CompanyProfits.pst"

In diesem Beispiel werden alle Nachrichten aus dem Posteingang von Benutzer "Kweku" in die PST-Datei "InPlaceHold" exportiert.

New-MailboxExportRequest -Mailbox Kweku -IncludeFolders "#Inbox#" -FilePath \\SERVER01\PSTFileShare\Kweku\InPlaceHold.pst

Sie können pro Postfach mehrere Exportanforderungen erstellen, und jede Anforderung zum Postfachexport muss über einen eindeutigen Namen verfügen. Microsoft Exchange generiert automatisch bis zu 10 eindeutige Namen für eine Anforderung zum Exportieren eines Postfachs. Wenn Sie jedoch mehr als 10 Exportanforderungen für ein Postfach erstellen, müssen Sie beim Erstellen der Exportanforderung einen eindeutigen Namen angeben. Sie können vorhandene Exportanforderungen mit dem Cmdlet Remove-MailboxExportRequest entfernen, bevor Sie eine neue Anforderung mit dem standardmäßigen Anforderungsnamen <Alias>\MailboxExportX starten (dabei ist X = 0–9).

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 verfügen möglicherweise nicht über 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 "Import/Export" im Thema Empfängerberechtigungen.

Der Gruppe "Exchange Trusted Subsystem" müssen die folgenden Berechtigungen für den Netzwerkshare zugewiesen werden, auf den PST-Dateien exportiert oder importiert werden sollen.

  • So importieren Sie PST-Dateien aus dem Share: Leseberechtigungen

  • So speichern Sie exportierte PST-Dateien in dem Share: Lese-/Schreibberechtigung

Ohne diese Berechtigungen wird in einer Fehlermeldung angezeigt, dass Exchange keine Verbindung mit der PST-Datei auf dem Netzwerkshare herstellen kann.

 

Parameter Erforderlich Typ Beschreibung

FilePath

Erforderlich

Microsoft.Exchange.Data.LongPath

Der Parameter FilePath gibt den Pfad der Netzwerkfreigabe für die PST-Datei an, in die Daten exportiert werden. Beispiel: \\SERVER01\PST Files\exported.pst.

Der Gruppe "Exchange Trusted Subsystem" müssen die folgenden Berechtigungen für den Netzwerkshare zugewiesen werden, auf den PST-Dateien exportiert oder importiert werden sollen.

  • So importieren Sie PST-Dateien aus dem Share: Leseberechtigungen

  • So speichern Sie exportierte PST-Dateien in dem Share: Lese-/Schreibberechtigung

Ohne diese Berechtigungen wird in einer Fehlermeldung angezeigt, dass Exchange keine Verbindung mit der PST-Datei auf dem Netzwerkshare herstellen kann.

Mailbox

Erforderlich

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter

Der Parameter Mailbox gibt das Postfach oder den E-Mail-aktivierten Benutzer an, aus dem/für den die Inhalte exportiert werden. Folgende Werte können verwendet werden:

  • Alias

  • SMTP-Adresse

  • Anzeigename

AcceptLargeDataLoss

Optional

System.Management.Automation.SwitchParameter

Die AcceptLargeDataLoss-Option gibt an, dass die Anforderung fortgesetzt werden soll, auch wenn eine große Anzahl von großen Elementen im Quellpostfach nicht in das Zielpostfach kopiert werden kann. Sie müssen diese Option verwenden, wenn Sie den BadItemLimit- oder LargeItemLimit-Parameter auf den Wert 51 oder höher festlegen. Andernfalls führt der Befehl zu einem Fehler.

AssociatedMessagesCopyOption

Optional

Microsoft.Exchange.MailboxReplicationService.FAICopyOption

Der Parameter AssociatedMessagesCopyOption gibt an, ob zugeordnete Nachrichten kopiert werden, wenn die Anforderung verarbeitet wird. Zugeordnete Nachrichten sind besondere Nachrichten, die ausgeblendete Daten mit Informationen zu Regeln, Ansichten und Formularen enthalten. In der Standardeinstellung werden zugeordnete Nachrichten kopiert. Dieser Parameter akzeptiert die folgenden Werte:

  • DoNotCopy   Die zugeordneten Nachrichten werden nicht kopiert.

  • MapByMessageClass   Diese Option ermittelt die zugehörige zugeordnete Nachricht, indem das Attribut MessageClass der Quellnachricht überprüft wird. Wird eine zugeordnete Nachricht dieser Klasse sowohl in den Quell- als auch in den Zielordnern gefunden, wird die zugeordnete Nachricht im Zielordner überschrieben. Befindet sich keine zugeordnete Nachricht im Zielordner, wird im Zielordner eine Kopie erstellt.

  • Copy   Diese Option kopiert zugeordnete Nachrichten von der Quelle in das Ziel. Wenn der gleiche Nachrichtentyp am Quell- und Zielspeicherort vorliegt, werden die zugeordneten Nachrichten dupliziert. Hierbei handelt es sich um die Standardeinstellung.

HinweisHinweis:
Die Inhaltsfilterung gilt nicht für zugeordnete Nachrichten.

BadItemLimit

Optional

Microsoft.Exchange.Data.Unlimited

Der BadItemLimit-Parameter gibt die maximale Anzahl von ungültigen Elementen an, die zulässig sind, bevor die Anforderung einen Fehler verursacht. Ein ungültiges Element ist ein fehlerhaftes Element im Quellpostfach, das nicht in das Zielpostfach kopiert werden kann. Der Grenzwert für ungültige Elemente enthält auch fehlende Elemente. Fehlende Elemente sind Elemente im Quellpostfach, die im Zielpostfach nicht gefunden werden können, wenn die Anforderung für den Abschluss bereit ist.

Eine gültige Eingabe für diesen Parameter ist eine Ganzzahl oder der Wert unlimited. Der Standardwert ist 0. Dies bedeutet, dass bei der Anforderung ein Fehler auftritt, wenn ungültige Elemente entdeckt werden. Wenn Sie nichts dagegen haben, ein paar ungültige Elemente zurückzulassen, können Sie den Parameter auf einen angemessenen Wert festlegen (wir empfehlen 10 oder weniger), damit die Anforderung fortgesetzt werden kann. Wenn zu viele fehlerhafte Elemente gefunden werden, nutzen Sie evtl. das Cmdlet New-MailboxRepairRequest, um zu versuchen, die beschädigten Elemente im Quellpostfach zu beheben und die Anforderung zu wiederholen.

HinweisHinweis:
Wenn Sie den Wert auf 51 oder höher festlegen, müssen Sie auch den AcceptLargeDataLoss-Switch verwenden. Andernfalls führt der Befehl zu einem Fehler.

BatchName

Optional

System.String

Der Parameter BatchName gibt einen beschreibenden Namen für das Exportieren von Postfächern im Batch an. Sie können den Namen im Parameter BatchName als Suchzeichenfolge verwenden, wenn Sie das Cmdlet Get-MailboxExportRequest verwenden.

CompletedRequestAgeLimit

Optional

Microsoft.Exchange.Data.Unlimited

Der Parameter CompletedRequestAgeLimit gibt an, wie lange die abgeschlossene Anforderung beibehalten wird, bis sie automatisch entfernt wird. Der Standardwert von CompletedRequestAgeLimit beträgt 30 Tage.

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.

ConflictResolutionOption

Optional

Microsoft.Exchange.MailboxReplicationService.ConflictResolutionOption

Der Parameter ConflictResolutionOption gibt die Aktion an, die der Microsoft Exchange-Postfachreplikationsdienst ausführen soll, wenn das Ziel über mehrere übereinstimmende Nachrichten verfügt. Dieser Parameter nimmt die folgenden Werte an:

  • KeepSourceItem

  • KeepLatestItem

  • KeepAll

Der Standardwert ist KeepSourceItem.

ContentFilter

Optional

System.String

Der Parameter ContentFilter gibt den Nachrichteninhalt an, nach dem gesucht werden soll. In die PST-Datei werden lediglich Inhalte exportiert, die mit dem Parameter ContentFilter übereinstimmen.

ContentFilterLanguage

Optional

System.Globalization.CultureInfo

Der Parameter ContentFilterLanguage gibt die Sprache des Parameters ContentFilter für Zeichenfolgensuchen an.

Eine gültige Eingabe für den Parameter ContentFilterLanguage sind die Zeichenfolgennamen, die in der Spalte Kulturname in der Klassenreferenz der Microsoft .NET-Klassenbibliothek aufgeführt sind. Die Klassenreferenz ist unter CultureInfo-Klasse verfügbar.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Der DomainController-Parameter gibt den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers an, der diese Konfigurationsänderung in Active Directory schreibt.

ExcludeDumpster

Optional

System.Management.Automation.SwitchParameter

Der Parameter ExcludeDumpster gibt an, ob der Ordner "Wiederherstellbare Elemente" ausgeschlossen wird. Sie müssen diesem Parameter keinen Wert hinzufügen. Wenn Sie diesen Parameter nicht angeben, wird der Ordner Wiederherstellbare Elemente mit den folgenden Unterordnern kopiert:

  • Deletions

  • Versions

  • Purges

ExcludeFolders

Optional

System.String[]

Der Parameter ExcludeFolders gibt die Liste der Ordner an, die vom Export ausgeschlossen werden sollen.

Für Ordnernamen wird die Groß-/Kleinschreibung nicht berücksichtigt, und es gelten keine Zeichenbeschränkungen. Verwenden Sie die folgende Syntax:

<FolderName>/*   Verwenden Sie diese Syntax, um einen persönlichen Ordner unterhalb des Ordners anzugeben, der im Parameter SourceRootFolder festgelegt ist, z. B. "MyProjects" oder "MyProjects/FY2010".

#<FolderName>#/*   Verwenden Sie diese Syntax, um einen bekannten Ordner unabhängig von der für den Ordnernamen verwendeten Sprache anzugeben. Beispielsweise gibt #Inbox# den Ordner "Posteingang" an, selbst wenn der türkische Ordnername (Gelen Kutusu) verwendet wird. Zu den bekannten Ordnern zählen:

  • Posteingang

  • SentItems

  • DeletedItems

  • Kalender

  • Kontakte

  • Entwürfe

  • Journal

  • Aufgaben

  • Anmerkungen

  • JunkEmail

  • CommunicationHistory

  • Voicemail

  • Fax

  • Konflikte

  • SyncIssues

  • LocalFailures

  • ServerFailures

Wenn der Benutzer einen persönlichen Ordner mit dem gleichen Namen wie dem eines bekannten Ordners erstellt und den Namen in Rautensymbole (#) einschließt, können Sie einen umgekehrten Schrägstrich (\) als Escapezeichen verwenden, um diesen Ordner anzugeben. Wenn ein Benutzer beispielsweise einen Ordner namens "#Notizen#" erstellt und Sie diesen Ordner (nicht den Standardordner "Notizen") angeben möchten, verwenden Sie die folgende Syntax: \#Notes\#.

HinweisHinweis:
Platzhalterzeichen können in Ordnernamen nicht verwendet werden.

IncludeFolders

Optional

System.String[]

Der Parameter IncludeFolders gibt die Liste der Ordner an, die in den Export aufgenommen werden sollen.

Für Ordnernamen wird die Groß-/Kleinschreibung nicht berücksichtigt, und es gelten keine Zeichenbeschränkungen. Verwenden Sie die folgende Syntax:

<FolderName>/*   Verwenden Sie diese Syntax, um einen persönlichen Ordner unterhalb des Ordners anzugeben, der im Parameter SourceRootFolder festgelegt ist, z. B. "MyProjects" oder "MyProjects/FY2010".

#<FolderName>#/*   Verwenden Sie diese Syntax, um einen bekannten Ordner unabhängig von der für den Ordnernamen verwendeten Sprache anzugeben. Beispielsweise gibt #Inbox# den Ordner "Posteingang" an, selbst wenn der türkische Ordnername (Gelen Kutusu) verwendet wird. Zu den bekannten Ordnern zählen:

  • Posteingang

  • SentItems

  • DeletedItems

  • Kalender

  • Kontakte

  • Entwürfe

  • Journal

  • Aufgaben

  • Anmerkungen

  • JunkEmail

  • CommunicationHistory

  • Voicemail

  • Fax

  • Konflikte

  • SyncIssues

  • LocalFailures

  • ServerFailures

Wenn der Benutzer einen persönlichen Ordner mit dem gleichen Namen wie dem eines bekannten Ordners erstellt und den Namen in Rautensymbole (#) einschließt, können Sie einen umgekehrten Schrägstrich (\) als Escapezeichen verwenden, um diesen Ordner anzugeben. Wenn ein Benutzer beispielsweise einen Ordner namens "#Notizen#" erstellt und Sie diesen Ordner (nicht den Standardordner "Notizen") angeben möchten, verwenden Sie die folgende Syntax: \#Notes\#.

HinweisHinweis:
Platzhalterzeichen können in Ordnernamen nicht verwendet werden.

InternalFlags

Optional

Microsoft.Exchange.Management.RecipientTasks.InternalMrsFlag[]

Der Parameter InternalFlags gibt die optionalen Schritte in der Anforderung an. Dieser Parameter wird in erster Linie zu Debuggingzwecken verwendet.

IsArchive

Optional

System.Management.Automation.SwitchParameter

Der Parameter IsArchive gibt an, dass Daten aus dem Benutzerarchiv exportiert werden.

LargeItemLimit

Optional

Microsoft.Exchange.Data.Unlimited

Der Parameter LargeItemLimit gibt die maximale Anzahl von großen Elementen an, die zulässig sind, bevor die Anforderung einen Fehler verursacht. Ein großes Element ist eine Nachricht im Quellpostfach, die die maximale Nachrichtengröße überschreitet, die im Zielpostfach zulässig ist. Wenn das Zielpostfach keine speziell konfigurierte maximale Nachrichtengröße aufweist, wird der unternehmensweite Wert verwendet.

Weitere Informationen über die Werte der maximalen Nachrichtengröße finden Sie in den folgenden Themen:

Eine gültige Eingabe für diesen Parameter ist eine Ganzzahl oder der Wert unlimited. Der Standardwert ist 0. Dies bedeutet, dass bei der Anforderung ein Fehler auftritt, wenn große Elemente entdeckt werden. Wenn Sie nichts dagegen haben, ein paar große Elemente zurückzulassen, können Sie den Parameter auf einen angemessenen Wert festlegen (wir empfehlen 10 oder weniger), damit die Anforderung fortgesetzt werden kann.

HinweisHinweis:
Wenn Sie den Wert auf 51 oder höher festlegen, müssen Sie auch den AcceptLargeDataLoss-Switch verwenden. Andernfalls führt der Befehl zu einem Fehler.

Name

Optional

System.String

Der Parameter Name gibt den Namen einer spezifischen Anforderung für Nachverfolgung und Anzeigezwecke an. Da pro Postfach mehrere Exportanforderungen vorhanden sein können, stellt Exchange dem Namen den Postfachalias voran. Wenn Sie beispielsweise eine Exportanforderung für ein Benutzerpostfach mit dem Alias "Kweku" erstellen und den Wert für diesen Parameter auf "PC1toArchive" festlegen, lautet die Identität dieser Exportanforderung "Kweku\PC1toArchive".

Wenn Sie keinen Namen mit diesem Parameter angeben, generiert Exchange bis zu 10 Anforderungsnamen pro Postfach. Dieser Name lautet "MailboxExportX" (hierbei ist X = 0–9). Die Identität der Anforderung wird als <Alias>\MailboxExport X angezeigt und kann in Suchen verwendet werden.

Priority

Optional

Microsoft.Exchange.MailboxReplicationService.RequestPriority

Der Parameter Priority gibt die Priorität an, mit der diese Anforderung in der Anforderungswarteschlange verarbeitet werden soll. Anforderungen werden basierend auf Serverintegrität, Status, Priorität und letzter Aktualisierung in einer bestimmten Reihenfolge verarbeitet.

RemoteCredential

Optional

System.Management.Automation.PSCredential

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

RemoteHostName

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

SkipMerging

Optional

Microsoft.Exchange.Management.RecipientTasks.SkippableMergeComponent[]

Der Parameter SkipMerging gibt Exportschritte an, die übersprungen werden sollen. Dieser Parameter wird in erster Linie zu Debuggingzwecken verwendet.

SourceRootFolder

Optional

System.String

Der Parameter SourceRootFolder gibt den Stammordner des Postfachs an, aus dem Daten exportiert werden. Wenn dieser Parameter nicht angegeben ist, werden über den Befehl alle Ordner exportiert.

Suspend

Optional

System.Management.Automation.SwitchParameter

Die Option Suspend gibt an, ob die Anforderung angehalten werden soll. Wenn Sie diese Option verwenden, wird die Anforderung in die Warteschlange eingereiht, erreicht jedoch erst den Status InProgress, wenn Sie die Anforderung mit dem entsprechenden Cmdlet fortsetzen. Sie müssen mit dieser Option keinen Wert angeben.

SuspendComment

Optional

System.String

Der SuspendComment-Parameter gibt eine Beschreibung an, warum die Anforderung angehalten wurde. Dieser Parameter kann nur zusammen mit dem Suspend-Parameter verwendet werden.

TargetRootFolder

Optional

System.String

Der Parameter TargetRootFolder gibt den Ordner der obersten Ebene an, in den Daten exportiert werden. Wenn Sie diesen Parameter nicht angeben, werden Ordner auf oberster Ebene in die Ordnerstruktur der PST-Zieldatei exportiert. Die Inhalte werden mit den vorhandenen Ordnern zusammengeführt, und falls Ordner in der Zielstruktur nicht vorhanden sind, werden neue Ordner erstellt.

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 dieWhatIf-Option muss kein Wert angegeben werden.

WorkloadType

Optional

Microsoft.Exchange.MailboxReplicationService.RequestWorkloadType

Der WorkloadType-Parameter ist für die interne Verwendung von Microsoft reserviert.

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Rückgabetypen bzw. Ausgabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets . Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

 
Anzeigen: