Restore-Mailbox

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Server 2010

Dieses Cmdlet ist nur in Exchange Server 2010 verfügbar.

Verwenden Sie das Cmdlet Restore-Mailbox, um Postfachinhalte aus einer wiederhergestellten Datenbank zu extrahieren.

Hinweis: Verwenden Sie in Exchange Server 2010 Service Pack 1 (SP1) oder höher das Cmdlet New-MailboxRestoreRequest anstelle des Cmdlets Restore-Mailbox, um Postfachinhalte aus einer wiederhergestellten Datenbank zu extrahieren.

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

Syntax

Restore-Mailbox
       [-Identity] <MailboxIdParameter>
       -RecoveryDatabase <DatabaseIdParameter>
       -RecoveryMailbox <StoreMailboxIdParameter>
       -TargetFolder <String>
       [-AllowDuplicates]
       [-AllContentKeywords <String[]>]
       [-AttachmentFilenames <String[]>]
       [-BadItemLimit <Int32>]
       [-Confirm]
       [-ContentKeywords <String[]>]
       [-EndDate <DateTime>]
       [-ExcludeFolders <MapiFolderPath[]>]
       [-GlobalCatalog <Fqdn>]
       [-IncludeFolders <MapiFolderPath[]>]
       [-Locale <CultureInfo>]
       [-MaxThreads <Int32>]
       [-RecipientKeywords <String[]>]
       [-SenderKeywords <String[]>]
       [-StartDate <DateTime>]
       [-SubjectKeywords <String[]>]
       [-ValidateOnly]
       [-WhatIf]
       [<CommonParameters>]

Beschreibung

Das Cmdlet Restore-Mailbox kopiert Endbenutzerdaten von jedem Server, auf dem Microsoft Exchange Server 2010 ausgeführt wird, in ein Postfach auf einem Exchange 2010-Postfachserver in derselben Organisation, die über ausreichend Speicherplatz und Ressourcen zur Unterstützung des Postfachs verfügt. Das Cmdlet Restore-Mailbox kann nur getrennte Postfächer auf einem Server als Datenquelle verwenden, und das Cmdlet kann nur verbundene Postfächer als Ziel für Daten verwenden.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase

In diesem Beispiel wird ein Postfach für den Benutzer Scott aus der Datenbank MyRecoveryDatabase wiederhergestellt.

Beispiel 2

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -RecoveryMailbox John -TargetFolder Recovery

In diesem Beispiel wird der Inhalt des Postfachs von John in Scotts Postfach unter dem Ordner Recovery wiederhergestellt.

Beispiel 3

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -SubjectKeywords "Meeting" -ContentKeywords "business" -IncludeFolders \Inbox,\Calendar

In diesem Beispiel wird nur die E-Mail mit dem Betreff Besprechung, dem Nachrichtentext mit dem Wort Business und dem Nachrichtenspeicherort im Posteingang oder Kalenderordner wiederhergestellt. In diesem Beispiel wird davon ausgegangen, dass das Postfach in Englisch ist.

Beispiel 4

Get-Mailbox -Database MyDatabase | Restore-Mailbox -RecoveryDatabase MyRecoveryDatabase

In diesem Beispiel werden alle Postfächer in der Postfachdatenbank MyDatabase, die auch in MyRecoveryDatabase vorhanden sind, per Massenwiederherstellung wiederhergestellt.

Parameter

-AllContentKeywords

Der Parameter AllContentKeywords gibt die Filter für alle folgenden Elemente an:

Betreff
Nachrichtentext
Anlageninhalt

Dies ermöglicht eine OR-Suche in allen diesen Feldern. Wenn Ihre Suchkriterien Teil des Betreffs, des Nachrichtentexts oder der Anlage sind, erhalten Sie Ergebnisse.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-AllowDuplicates

Der Schalter AllowDuplicates kopiert E-Mail-Elemente, ohne zu überprüfen, ob es sich um Duplikate vorhandener Elemente handelt, und ohne doppelte Elemente zu entfernen. Sie müssen bei dieser Option keinen Wert angeben.

Es wird empfohlen, diesen Schalter mit dem IncludeFolders-Parameter zu verwenden.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-AttachmentFilenames

Der AttachmentFilenames-Parameter gibt den Filter für den Dateinamen der Anlage an. Sie können in der Zeichenfolge Einen Feldhalter verwenden. Sie können beispielsweise *.txt verwenden, um Elemente mit einer .txt-Erweiterung zu exportieren.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-BadItemLimit

Der Parameter BadItemLimit gibt die Anzahl der beschädigten Elemente in einem Postfach an, die übersprungen werden sollen, bevor der Exportvorgang fehlschlägt.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ContentKeywords

Der Parameter ContentKeywords gibt die Schlüsselwortfilter für den Nachrichtentext und den Inhalt von Anlagen im Quellpostfach an.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-EndDate

Der Parameter EndDate gibt das Enddatum zum Filtern von Inhalten an, die aus dem Quellpostfach exportiert werden. Nur Elemente im Postfach, deren Datum vor dem Enddatum liegt, werden exportiert. Wenn Sie ein bestimmtes Datum eingeben, verwenden Sie das kurze Datumsformat, das in den Einstellungen für regionale Optionen definiert ist, die auf dem lokalen Computer konfiguriert sind. Wenn Ihr Computer beispielsweise für die Verwendung des kurzen Datumsformats mm/tt/jjjj konfiguriert ist, geben Sie 03/01/2010 ein, um den 1. März 2010 anzugeben.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ExcludeFolders

Der Parameter ExcludeFolders gibt die Liste der Ordner an, die vom Export ausgeschlossen werden sollen. Ordner werden ausgeschlossen, wenn sie eingegeben werden. Sie sind nicht lokalisiert. Das Ausschließen von Kalendern schließt beispielsweise nur kalender in englischer Sprache aus, da kalender in anderen Sprachen ein anderes Wort ist.

Type:	MapiFolderPath[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-GlobalCatalog

Der Parameter GlobalCatalog gibt den globalen Katalog an, der für die Suche nach dem Zielpostfach verwendet werden soll.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Identity

Der Parameter Identity gibt das Postfach an, das Sie wiederherstellen möchten. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:

Name
Alias
Distinguished Name (DN)
Distinguished Name (DN)
Domäne\benutzername
E-Mail-Adresse
GUID
LegacyExchangeDN
SamAccountName
Benutzer-ID oder User Principal Name (UPN)

Type:	MailboxIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-IncludeFolders

Der Parameter IncludeFolders gibt die Liste der Ordner an, die in den Export aufgenommen werden sollen. Ordner werden bei der Eingabe eingeschlossen. Sie sind nicht lokalisiert. Beispielsweise schließt das Einschließen von Kalender nur Kalender in Englisch ein, da kalender in anderen Sprachen ein anderes Wort ist.

Type:	MapiFolderPath[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Locale

Der Parameter Locale gibt die Gebietsschemaeinstellung für eine wiederherzustellende Nachricht an. Bei diesem Filtersatz werden nur Nachrichten mit der angegebenen Gebietsschemaeinstellung extrahiert.

Type:	CultureInfo
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MaxThreads

Der Parameter MaxThreads gibt die maximale Anzahl der zu verwendenden Threads an.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RecipientKeywords

Der Parameter RecipientKeywords gibt die Schlüsselwortfilter für Empfänger von Elementen im Quellpostfach an. Dieser Filter findet die Suchzeichenfolge auch dann, wenn sie Teil eines Worts ist. Dies ist keine ganze Wortsuche.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RecoveryDatabase

Der RecoveryDatabase-Parameter gibt die Wiederherstellungsdatenbank an, aus der Sie das Postfach wiederherstellen. Sie können jeden beliebigen Wert verwenden, sofern er die Datenbank eindeutig kennzeichnet. Beispiel:

Name
Distinguished Name (DN)
GUID

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RecoveryMailbox

Der Parameter RecoveryMailbox gibt das Postfach an, das als Quellpostfach verwendet werden soll. Dieser Parameter ist erforderlich, wenn sich das Quellpostfach vom Zielpostfach unterscheidet.

Sie identifizieren das Postfach anhand seines GUID-Werts. Sie finden den GUID-Wert mit den Cmdlets Get-Mailbox oder Get-MailboxStatistics.

Type:	StoreMailboxIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SenderKeywords

Der Parameter SenderKeywords gibt die Schlüsselwortfilter für Absender von Elementen im Quellpostfach an. Dieser Filter findet die Suchzeichenfolge auch dann, wenn sie Teil eines Worts ist. Dies ist keine ganze Wortsuche.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-StartDate

Der Parameter StartDate gibt das Startdatum an. Das Startdatum muss vor dem Enddatum stehen.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-SubjectKeywords

Der Parameter SubjectKeywords gibt die Schlüsselwortfilter für Themen von Elementen im Quellpostfach an. Dieser Filter findet die Suchzeichenfolge auch dann, wenn sie Teil eines Worts ist. Dies ist keine ganze Wortsuche.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TargetFolder

Der Parameter TargetFolder gibt den Postfachordner an, der für das angegebene Postfach erstellt wird. Dieser Parameter ist erforderlich, wenn sich das wiederherzustellende Postfach vom Zielpostfach unterscheidet. (Beispielsweise ist der mit dem Identity-Parameter angegebene Wert nicht mit dem wert identisch, der mit dem RecoveryMailbox-Parameter angegeben wird.) In diesem Fall führt der Befehl Restore-Mailbox eine Zusammenführung aus. Wenn die Werte identisch sind, ist der TargetFolder-Parameter nicht erforderlich.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ValidateOnly

Der Schalter ValidateOnly weist den Befehl an, die Bedingungen und Anforderungen auszuwerten, die zum Ausführen des Vorgangs erforderlich sind, und meldet dann, ob der Vorgang erfolgreich ist oder fehlschlägt. Sie müssen keinen Wert für diese Option angeben.

Bei Verwendung dieses Schalters werden keine Änderungen vorgenommen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

Eingaben

Input types

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.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.