Restore-Mailbox (RTM)

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-05

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[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]

restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> -RSGMailbox <StoreMailboxIdParameter> -TargetFolder <String> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <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.

Mithilfe einer Speichergruppe für die Wiederherstellung können Sie Daten aus einer Sicherungskopie der Datenbank wiederherstellen, ohne den Benutzerzugriff auf aktuelle Daten zu stören. Die Speichergruppe für die Wiederherstellung kann außerdem im Falle eines Datenverlusts beim Abrufen von Daten hilfreich sein. Auf einem Server kann sich nur eine Speichergruppe für die Wiederherstellung befinden.

Damit Sie das Cmdlet Restore-Mailbox ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • Die Exchange-Serveradministrator-Rolle und die lokale Gruppe Administratoren für den Quell- und 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.

Die Server sind Teil einer einzelnen Gesamtstruktur oder einer Ressourcengesamtstruktur. Postfachdaten können nur in Postfächer innerhalb der gleichen Gesamtstruktur exportiert werden. Die Konten des Active Directory-Verzeichnisdiensts, die dem Postfach zugeordnet sind, können sich in einer externen Gesamtstruktur befinden, die Postfachdaten können jedoch nicht auf Server in anderen Gesamtstrukturen exportiert werden.

Die wiederhergestellte und die Quelldatenbank müssen von einem Exchange 2007-Server stammen.

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.

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.

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.

AttachmentFilenames

Optional

System.String[]

Der Parameter AttachmentFilenames gibt den Filter für den Dateinamen der Anlage 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üsselwortfilter für den Nachrichtentext und den Inhalt von Anlagen im Quellpostfach an.

EndDate

Optional

System.DateTime

Der Parameter EndDate gibt das Enddatum zum Filtern des aus dem Quellpostfach zu exportierenden Inhalts an. 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 vom Export auszuschließenden Ordner an. Die Ordner werden in der Sprache ausgeschlossen, in der sie eingegeben werden, weil sie nicht lokalisiert sind. So werden beispielsweise durch die Eingabe von calendar nur die Ordner Calendar in englischer Schreibweise 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 wird.

IncludeFolders

Optional

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

Der Parameter IncludeFolders gibt die Liste der zu exportierenden Ordner an. Die Ordner werden in der Sprache eingeschlossen, in der sie eingegeben werden, weil sie nicht lokalisiert sind. So werden beispielsweise durch die Eingabe von calendar nur die Ordner Calendar in englischer Schreibweise einsgeschlossen, 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.

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 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.

ValidateOnly

Optional

System.Management.Automation.SwitchParameter

Der Parameter ValidateOnly weist den Befehl an, die für das Objekt auszuführenden Aktionen lediglich zu simulieren. Der Standardwert lautet "$true".

Eingabetypen

Rückgabetypen

Fehler

Fehler

Beschreibung

 

 

Ausnahmen

Ausnahmen

Beschreibung

 

 

Beispiel

In dem folgenden Beispielcode wird im ersten Beispiel ein Postfach für den Benutzer "Chris" aus der Datenbank "MyRSGDatabase" in der Speichergruppe für die Wiederherstellung wiederhergestellt. Im zweiten Beispiel wird das Postfach von "Ricardo" in das Postfach von "Chris" im Ordner "Recovery" wiederhergestellt. Im dritten Beispiel werden nur die E-Mails, die den Betreff "Meeting" haben UND das Wort "business" im Nachrichtentext enthalten UND sich entweder im Ordner Inbox (Posteingang) oder Calendar (Kalender) befinden, 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 chris -RSGDatabase MyRSGDatabase
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -RSGMailbox Ricardo -TargetFolder Recovery
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -SubjectKeywords "Meeting" -ContentKeyword "business" -IncludeFolders \Inbox,\Calendar
Get-mailbox -Database MyDatabase | Restore-Mailbox -RSGDatabase MyRSGDatabase