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:

  • GUID der Datenbank

  • Datenbankname

  • Servername\Datenbankname

  • Servername\Speichergruppe\Datenbankname

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:

  • Betreff

  • Nachrichtentext

  • Anlageninhalt

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