Restore-Mailbox

Modul:
Exchange PowerShell

Dieses Cmdlet steht nur in Exchange Server 2010 zur Verfügung.

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

Hinweis: Verwenden Sie in Exchange Server 2010 Service Pack 1 (SP1) oder höher das New-MailboxRestoreRequest-Cmdlet anstelle des Restore-Mailbox-Cmdlets, 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

Default (Standard) 

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

Mit dem Cmdlet Restore-Mailbox werden Endbenutzerdaten von einem beliebigen Server, auf dem Microsoft Exchange Server 2010 ausgeführt wird, in ein Postfach auf einem Exchange 2010-Postfachserver im selben organization kopiert, das ü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. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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 von Johns Postfach in Scotts Postfach unter dem Ordner "Wiederherstellung" wiederhergestellt.

Beispiel 3

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

In diesem Beispiel werden nur die E-Mails mit dem Betreff "Besprechung", dem Nachrichtentext, der das Wort "Business" enthält, und dem Speicherort der Nachricht im Ordner "Posteingang" oder "Calendar" 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 MyDatabase-Postfachdatenbank massenweise wiederhergestellt, die auch in MyRecoveryDatabase vorhanden sind.

Parameter

-AllContentKeywords

Anwendbar: Exchange Server 2010

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

  • Subject
  • Nachrichtentext
  • Anlageninhalt

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AllowDuplicates

Anwendbar: Exchange Server 2010

Der Schalter "AllowDuplicates" kopiert E-Mail-Elemente, ohne zu prüfen, ob es sich um Duplikate vorhandener Elemente handelt, und ohne dass doppelte Elemente entfernt werden. Sie müssen keinen Wert für diese Option angeben.

Es wird empfohlen, diese Option mit dem Parameter "IncludeFolders" zu verwenden.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-AttachmentFilenames

Anwendbar: Exchange Server 2010

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-BadItemLimit

Anwendbar: Exchange Server 2010

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Anwendbar: Exchange Server 2010

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

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ContentKeywords

Anwendbar: Exchange Server 2010

Der Parameter ContentKeywords gibt die Schlüsselwort(keyword)-Filter für den Nachrichtentext und den Inhalt von Anlagen im Quellpostfach an.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EndDate

Anwendbar: Exchange Server 2010

Der Parameter EndDate gibt das Enddatum für das Filtern von Inhalten an, die aus dem Quellpostfach exportiert werden sollen. 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 auf dem lokalen Computer konfigurierten Einstellungen für regionale Optionen definiert ist. Wenn Ihr Computer beispielsweise für die Verwendung des kurzen Datumsformats MM/TT/JJJJ konfiguriert ist, geben Sie 01.03.2010 ein, um den 1. März 2010 anzugeben.

Parametereigenschaften

Typ:DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ExcludeFolders

Anwendbar: Exchange Server 2010

Der Parameter ExcludeFolders gibt die Liste der Ordner an, die vom Export ausgeschlossen werden sollen. Ordner werden bei ihrer Eingabe ausgeschlossen. Sie sind nicht lokalisiert. Beispielsweise wird durch das Ausschließen von Kalender nur Kalender in Englisch ausgeschlossen, da Kalender in anderen Sprachen ein anderes Wort ist.

Parametereigenschaften

Typ:

MapiFolderPath[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-GlobalCatalog

Anwendbar: Exchange Server 2010

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

Parametereigenschaften

Typ:Fqdn
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Identity

Anwendbar: Exchange Server 2010

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)

Parametereigenschaften

Typ:MailboxIdParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-IncludeFolders

Anwendbar: Exchange Server 2010

Der Parameter IncludeFolders gibt die Liste der Ordner an, die in den Export aufgenommen werden sollen. Ordner werden einbezogen, wenn sie eingegeben werden. Sie sind nicht lokalisiert. Beispielsweise umfasst das Einschließen von Kalender nur Kalender in englischer Sprache, weil Kalender in anderen Sprachen ein anderes Wort ist.

Parametereigenschaften

Typ:

MapiFolderPath[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Locale

Anwendbar: Exchange Server 2010

Der Parameter Locale gibt die Locale-Einstellung für eine Nachricht an, die wiederhergestellt werden soll. Wenn dieser Filtersatz festgelegt ist, werden nur Nachrichten mit der angegebenen Gebietsschemaeinstellung extrahiert.

Parametereigenschaften

Typ:CultureInfo
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MaxThreads

Anwendbar: Exchange Server 2010

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RecipientKeywords

Anwendbar: Exchange Server 2010

Der Parameter "RecipientKeywords" gibt die Schlüsselwortfilter (keyword) für Empfänger von Elementen im Quellpostfach an. Dieser Filter findet die Suchzeichenfolge, auch wenn sie Teil eines Worts ist. Dies ist keine Suche nach ganzen Wörtern.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RecoveryDatabase

Anwendbar: Exchange Server 2010

Der Parameter RecoveryDatabase 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

Parametereigenschaften

Typ:DatabaseIdParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RecoveryMailbox

Anwendbar: Exchange Server 2010

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.

Parametereigenschaften

Typ:StoreMailboxIdParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-SenderKeywords

Anwendbar: Exchange Server 2010

Der Parameter SenderKeywords gibt die Schlüsselwort (keyword)-Filter für Absender von Elementen im Quellpostfach an. Dieser Filter findet die Suchzeichenfolge, auch wenn sie Teil eines Worts ist. Dies ist keine Suche nach ganzen Wörtern.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StartDate

Anwendbar: Exchange Server 2010

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

Parametereigenschaften

Typ:DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SubjectKeywords

Anwendbar: Exchange Server 2010

Der Parameter SubjectKeywords gibt die Schlüsselwort(keyword)-Filter für die Betreffzeilen von Elementen im Quellpostfach an. Dieser Filter findet die Suchzeichenfolge, auch wenn sie Teil eines Worts ist. Dies ist keine Suche nach ganzen Wörtern.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TargetFolder

Anwendbar: Exchange Server 2010

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. (Der mit dem Identity-Parameter angegebene Wert ist z. B. nicht identisch mit dem Wert, der mit dem RecoveryMailbox-Parameter angegeben wird.) In diesem Fall führt der Befehl Restore-Mailbox eine Zusammenführung durch. Wenn die Werte identisch sind, ist der Parameter "TargetFolder" nicht erforderlich.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ValidateOnly

Anwendbar: Exchange Server 2010

Der ValidateOnly-Schalter gibt an, ob der potenzielle Erfolg oder Misserfolg des Befehls ausgewertet werden soll, ohne Änderungen vorzunehmen. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Anwendbar: Exchange Server 2010

Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.