Restore-Mailbox
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2009-05-14
Mithilfe des Cmdlets Restore-Mailbox können Sie Postfachinhalte aus einer Datenbank extrahieren, die in eine Speichergruppe für die Wiederherstellung wiederhergestellt wurde.
Syntax
restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> -RSGMailbox <StoreMailboxIdParameter> -TargetFolder <String> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Das Cmdlet Restore-Mailbox kopiert Endbenutzerdaten aus einer Speichergruppe für die Wiederherstellung auf einem beliebigen Server mit Microsoft Exchange Server 2007 in ein Postfach auf einem beliebigen Exchange 2007-Postfachserver in derselben Organisation, der über ausreichenden Speicherplatz und Ressourcen verfügt, um das Postfach zu unterstützen. Das Cmdlet Restore-Mailbox kann nur von einer Speichergruppe für die Wiederherstellung auf einem Server getrennte Postfächer als Datenquelle und verbundene Postfächer als Datenziel verwenden.
Damit Sie das Cmdlet Restore-Mailbox ausführen können, muss dem verwendeten Konto die Rolle Exchange-Serveradministrator zugewiesen worden sein, und es muss der lokalen Gruppe Administratoren für den Quell- und den Zielserver angehören. Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Der Parameter Identity gibt die Identität des Zielpostfachs an. Dieser Parameter ist ein Name oder eine GUID. Wenn das Quellpostfach nicht mithilfe des Parameters RSGMailbox angegeben wird, wird angenommen, dass die Postfach-GUID des Quellpostfachs mit der des Zielpostfachs identisch ist. |
RSGDatabase |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Der Parameter RSGDatabase gibt die Datenbank in der Speichergruppe für die Wiederherstellung an, aus der das Postfach wiederhergestellt werden soll. Folgende Werte können verwendet werden:
|
RSGMailbox |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter |
Der Parameter RSGMailbox gibt das Postfach in der Speichergruppe für die Wiederherstellung an, das als Quellpostfach verwendet werden soll. Dieser Parameter ist erforderlich, wenn das Quellpostfach nicht mit dem Zielpostfach identisch ist. |
TargetFolder |
Erforderlich |
System.String |
Der Parameter TargetFolder gibt den Postfachordner an, der in dem angegebenen Postfach erstellt wird. Wenn das wiederherzustellende Postfach von dem Postfach in der Speichergruppe für die Wiederherstellung abweicht, führt das Cmdlet Restore-Mailbox eine Zusammenführung aus. |
AllContentKeywords |
Optional |
System.String[] |
Der Parameter AllContentKeywords gibt die Filter für alle Folgenden an:
Dies ermöglicht eine OR-Suche (ODER) in allen vorgenannten Feldern. Wenn Ihre Suchkriterien Bestandteil des Betreffs, des Nachrichtentexts oder des Anlageninhalts sind, erhalten Sie Ergebnisse. |
AllowDuplicates |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter AllowDuplicates wird zum Kopieren von Nachrichtenelementen verwendet. Dabei erfolgt keine Überprüfung, ob es sich um Duplikate vorhandener Elemente handelt, und Duplikatelemente werden auch nicht entfernt. Es wird empfohlen, den Parameter AllowDuplicates zusammen mit dem Parameter IncludeFolders zu verwenden. |
AttachmentFilenames |
Optional |
System.String[] |
Der Parameter AttachmentFilenames gibt den Filter für den Dateinamen der Anlage an. In dieser Zeichenfolge können Platzhalterzeichen verwendet werden. 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 fehlerhafte Elemente in einem Postfach ausgelassen werden können, bevor der Exportvorgang fehlschlägt. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter Confirm führt dazu, dass der Befehl die Verarbeitung unterbricht und vom Administrator die Bestätigung der Aufgabe des Befehls erfordert, bevor die Verarbeitung fortgesetzt wird. Der Standardwert lautet "$true". |
ContentKeywords |
Optional |
System.String[] |
Der Parameter ContentKeywords gibt die Schlüsselwortfilter für den Nachrichtentext und den Inhalt von Anlagen im Quellpostfach an. |
EndDate |
Optional |
System.DateTime |
Der Parameter EndDate legt das Enddatum zum Filtern des Inhalts fest, der aus dem Quellpostfach exportiert wird. Nur die Elemente im Postfach, deren Datum vor dem angegebenen Enddatum liegt, werden exportiert. 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 Ordner an, die von dem Export ausgeschlossen werden sollen. Die Ordner werden in der Sprache ausgeschlossen, in der sie eingegeben werden, weil sie nicht lokalisiert sind. So wird beispielsweise durch das Ausschließen des Ordners "Calendar" nur die englische Version dieses Ordners ("Calendar") ausgeschlossen, weil "Calendar" in anderen Sprachen ein anderes Wort ist. |
GlobalCatalog |
Optional |
Microsoft.Exchange.Data.Fqdn |
Der Parameter GlobalCatalog gibt den globalen Katalog an, der für die Suche nach dem Zielpostfach verwendet werden soll. |
IncludeFolders |
Optional |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
Der Parameter IncludeFolders gibt die Liste der Ordner an, die in den Export aufgenommen werden sollen. Die Ordner werden in der Sprache eingeschlossen, in der sie eingegeben werden, weil sie nicht lokalisiert sind. So wird beispielsweise durch das Einschließen des Ordners calendar nur die englische Version dieses Ordners ("Calendar") eingeschlossen, weil "calendar" in anderen Sprachen ein anderes Wort ist. |
Locale |
Optional |
System.Globalization.CultureInfo |
Der Parameter Locale gibt das Gebietsschema für eine wiederherzustellende Nachricht an. Wenn dieser Filter festgelegt ist, werden nur Nachrichten mit dem festgelegten Gebietsschema extrahiert. |
MaxThreads |
Optional |
System.Int32 |
Der Parameter MaxThreads gibt die maximale Anzahl der Threads an, die verwendet werden. |
RecipientKeywords |
Optional |
System.String[] |
Der Parameter RecipientKeywords legt die Schlüsselwortfilter für die Empfänger der Elemente im Quellpostfach fest. Durch diesen Filter wird die Suchzeichenfolge auch dann gefunden, wenn sie Bestandteil eines Worts ist. Dies ist keine Suche nach ganzen Worten. |
ReportFile |
Optional |
Microsoft.Exchange.Data.LocalLongFullPath |
Der Parameter ReportFile gibt den Pfad und Dateinamen für das XML-Berichtsprotokoll an. |
SenderKeywords |
Optional |
System.String[] |
Der Parameter SenderKeywords legt die Schlüsselwortfilter für die Absender der Elemente im Quellpostfach fest. Durch diesen Filter wird die Suchzeichenfolge auch dann gefunden, wenn sie Bestandteil eines Worts ist. Dies ist keine Suche nach ganzen Worten. |
StartDate |
Optional |
System.DateTime |
Der Parameter StartDate gibt das Startdatum an. Das Startdatum muss vor dem Enddatum liegen. |
SubjectKeywords |
Optional |
System.String[] |
Der Parameter SubjectKeywords legt die Schlüsselwortfilter für den Betreff der Elemente im Quellpostfach fest. Durch diesen Filter wird die Suchzeichenfolge auch dann gefunden, wenn sie Bestandteil eines Worts ist. Dies ist keine Suche nach ganzen Worten. |
TargetFolder |
Optional |
System.String |
Der Parameter TargetFolder gibt den Postfachordner an, der in dem angegebenen Postfach erstellt wird. Dieser Parameter ist erforderlich, wenn das wiederherzustellende Postfach nicht mit dem Postfach in der Speichergruppe für die Wiederherstellung identisch ist. (Dies ist z. B. der Fall, wenn der mit dem Parameter Identity angegebene Wert nicht mit dem Wert identisch ist, der mit dem Parameter RSGMailbox angeben wurde.) In diesem Fall führt das Cmdlet Restore-Mailbox eine Zusammenführung aus. Wenn die Werte identisch sind, ist der Parameter TargetFolder nicht erforderlich. |
ValidateOnly |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter ValidateOnly weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Der Standardwert lautet "$true". |
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 kann der Administrator die sich ergebenden Änderungen anzeigen, ohne diese Änderungen tatsächlich auszuführen. Der Standardwert lautet "$true". |
Eingabetypen
Rückgabetypen
Fehler
Ausnahmen
Beispiel
Im folgenden Beispielcode wird im ersten Beispiel ein Postfach für den Benutzer "Scott" aus der Datenbank "MyRSGDatabase" in der Speichergruppe für die Wiederherstellung wiederhergestellt.
Im zweiten Beispiel wird das Postfach von "John" in das Postfach von "Scott" im Ordner Recovery wiederhergestellt.
Im dritten Beispiel wird nur die E-Mail, die den Betreff Meeting hat, das Wort business im Nachrichtentext enthält und sich entweder im Ordner Inbox (Posteingang) oder Calendar (Kalender) befindet, wiederhergestellt. Dieses Beispiel setzt voraus, dass das Postfach in Englisch ist.
Im letzten Beispiel werden alle in der Postfachdatenbank "MyDatabase" enthaltenen Postfächer wiederhergestellt, die sich ebenfalls in der Datenbank "MyRSGDatabase" befinden.
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase -RSGMailbox John -TargetFolder Recovery
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase -SubjectKeywords "Meeting" -ContentKeyword "business" -IncludeFolders \Inbox,\Calendar
Get-Mailbox -Database MyDatabase | Restore-Mailbox -RSGDatabase MyRSGDatabase