Freigeben über

Restore-RecoverableItems

Modul:
Exchange PowerShell

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen können für die eine oder die andere Umgebung exklusiv sein.

Verwenden Sie das Cmdlet Restore-RecoverableItems Items, um gelöschte Elemente in Postfächern wiederherzustellen. Nachdem Sie die gelöschten Elemente gefunden haben, verwenden Sie das Get-RecoverableItems-Cmdlet, um diese wiederherzustellen.

Dieses Cmdlet ist nur in der Postfachimport-/-exportrolle verfügbar, und standardmäßig ist diese Rolle keiner Rollengruppe zugewiesen. Zur Verwendung dieses Cmdlets müssen Sie die Postfachimport-/-exportrolle einer Rollengruppe hinzufügen (zum Beispiel der Rollengruppe „Organisationsverwaltung“). Weitere Informationen finden Sie unter Hinzufügen einer Rolle zu einer Rollengruppe.

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

Syntax

OnPremises 

Restore-RecoverableItems
    -Identity <GeneralMailboxOrMailUserIdParameter>
    [-EntryID <String>]
    [-FilterEndTime <DateTime>]
    [-FilterItemType <String>]
    [-FilterStartTime <DateTime>]
    [-LastParentFolderID <String>]
    [-ResultSize <Unlimited>]
    [-SourceFolder <RecoverableItemsFolderType>]
    [-SubjectContains <String>]
    [<CommonParameters>]

Cloud 

Restore-RecoverableItems
    -Identity <GeneralMailboxOrMailUserIdParameter[]>
    [-EntryID <String>]
    [-FilterEndTime <DateTime>]
    [-FilterItemType <String>]
    [-FilterStartTime <DateTime>]
    [-LastParentFolderID <String>]
    [-MaxParallelSize <Int32>]
    [-NoOutput]
    [-PolicyTag <String[]>]
    [-RestoreTargetFolder <String>]
    [-ResultSize <Unlimited>]
    [-SourceFolder <RecoverableItemsFolderType>]
    [-SubjectContains <String>]
    [<CommonParameters>]

Beschreibung

Elemente werden am ursprünglichen Ordnerspeicherort wiederhergestellt, wenn die Informationen für das Element verfügbar sind. Wenn die Informationen nicht gefunden werden können, wird das Element im Standardordner für den Elementtyp wiederhergestellt (Posteingang für Nachrichten, Kalender für Besprechungen und Termine usw.).

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-RecoverableItems -Identity laura@contoso.com -FilterItemType IPM.Note -SubjectContains "FY18 Accounting" -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"

Nach Verwendung des Get-RecoverableItems-Cmdlets, um das Vorhandensein des Elements zu prüfen, wird in diesem Beispiel das angegebene gelöschte Element aus dem angegebenen Postfach wiederhergestellt:

  • Briefkasten: laura@contoso.com
  • Elementtyp: E-Mail-Nachricht
  • Betreff der Nachricht: Buchhaltung für das Geschäftsjahr 18
  • Speicherort: Wiederherstellbare Elemente\Löschungen
  • Datumsbereich: 2.1.2018 bis 2.5.2018

Beispiel 2

$mailboxes = Import-CSV "C:\My Documents\RestoreMessage.csv"

$mailboxes | foreach {Restore-RecoverableItems -Identity $_.SMTPAddress -SubjectContains "Project X" -SourceFolder DeletedItems -FilterItemType IPM.Note}

In Exchange Server wird in diesem Beispiel die gelöschte E-Mail-Nachricht "Project X" für die Postfächer wiederhergestellt, die in der CSV-Datei (C:\My Documents\RestoreMessage.csv) angegeben sind. Die CSV-Datei verwendet den Kopfzeilenwert SMTPAddress und enthält die E-Mail-Adresse für jedes Postfach in einer separaten Zeile:

SMTPAddress
chris@contoso.com
michelle@contoso.com
laura@contoso.com
julia@contoso.com

Der erste Befehl liest die CSV-Datei in die Variable namens $mailboxes. Der zweite Befehl stellt die angegebene Nachricht aus dem Ordner „Gelöschte Elemente“" in diesen Postfächer wieder her.

Beispiel 3

Restore-RecoverableItems -Identity "malik@contoso.com","lillian@contoso.com" -FilterItemType IPM.Note -SubjectContains "COGS FY17 Review" -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM" -MaxParallelSize 2

In Exchange Online werden in diesem Beispiel die angegebenen gelöschten Elemente in den angegebenen Postfächern wiederhergestellt, nachdem Sie das Cmdlet Get-RecoverableItems verwendet haben, um das Vorhandensein des Elements zu überprüfen:

  • Postfächer: malik@contoso.com, lillian@contoso.com
  • Elementtyp: E-Mail-Nachricht
  • Betreff der Nachricht: COGS GY17 Review
  • Speicherort: Wiederherstellbare Elemente\Löschungen
  • Datumsbereich: 15.03.2019 bis 25.03.2019
  • Anzahl der gleichzeitig verarbeiteten Postfächer: 2

Beispiel 4

Get-RecoverableItems administrator | Restore-RecoverableItems

In diesem Beispiel werden alle wiederherstellbaren Elemente für den Administrator per Massenvorgang wiederhergestellt.

Parameter

-EntryID

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Der EntryID-Parameter gibt das gelöschte Element an, das Sie wiederherstellen möchten. Der Wert EntryID für das gelöschte Element ist in dem Postfach eindeutig.

Sie können die EntryID für bestimmte Elemente finden, indem Sie andere Suchfilter im cmdlet Get-RecoverableItems (Betreff, Datumsbereich usw.) verwenden.

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

-FilterEndTime

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

FilterEndTime gibt das Enddatum/die Endzeit des Datumsbereichs an. Dieser Parameter verwendet den LastModifiedTime-Wert des Elements.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn der Computer beispielsweise für die Verwendung des kurzen Datumsformats MM/TT/jjjj konfiguriert ist, geben Sie 09/01/2018 ein, um den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".

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

-FilterItemType

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Der FilterItemType-Parameter filtert die Ergebnisse nach dem angegebenen MessageClass (ItemClass)-Eigenschaftswert des gelöschten Elements. Zum Beispiel:

  • IPM.Appointment (Besprechungen und Termine)
  • IPM.Contact
  • IPM. Datei
  • IPM.Note
  • IPM.Task

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

-FilterStartTime

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

FilterStartTime gibt das Startdatum/die Startzeit des Datumsbereichs an. Dieser Parameter verwendet den LastModifiedTime-Wert des Elements.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn der Computer beispielsweise für die Verwendung des kurzen Datumsformats MM/TT/jjjj konfiguriert ist, geben Sie 09/01/2018 ein, um den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".

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

-Identity

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Der Parameter Identity gibt das Postfach an, das die gelöschten Elemente enthält, die 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)

In Exchange Online können Sie mehrere Postfächer durch Kommas getrennt angeben. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Parametereigenschaften

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

Parametersätze

OnPremises
Position:1
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Cloud
Position:1
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-LastParentFolderID

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Der Parameter LastParentFolderID gibt den FolderID-Wert des Elements an, bevor es gelöscht wurde. Beispiel: 53B93149989CA54DBC9702AE619B9CCA000062CE9397.

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

-MaxParallelSize

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter MaxParallelSize gibt die maximale Anzahl von Postfächern an, die vom Befehl parallel verarbeitet werden. Ein gültiger Wert ist eine ganze Zahl von 1 bis 10. In der Regel verringert ein höherer Wert die Zeit, die zum Ausführen des Befehls für mehrere Postfächer benötigt wird.

Der Wert dieses Parameters hat keine Auswirkung, wenn der Parameter Identity nur ein Postfach angibt.

Parametereigenschaften

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

Parametersätze

Cloud
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NoOutput

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der NoOutput-Schalter stellt die gelöschten Elemente direkt ohne Befehlsausgabe in der Konsole wieder her. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

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

Parametersätze

Cloud
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PolicyTag

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill PolicyTag Description }}

Parametereigenschaften

Typ:

String[]

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

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RestoreTargetFolder

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter RestoreTargetFolder gibt den Ordner der obersten Ebene an, in dem Daten wiederhergestellt werden sollen. Wenn Sie diesen Parameter nicht angeben, werden Ordner auf oberster Ebene in der Ordnerstruktur des Zielpostfachs oder -archivs wiederhergestellt. Die Inhalte werden mit den vorhandenen Ordnern zusammengeführt, und falls Ordner in der Zielstruktur nicht vorhanden sind, werden neue Ordner erstellt.

Dieser Parameter ist nur für primäre Postfächer verfügbar und wird für Archivpostfächer ignoriert. Wenn er nicht vorhanden ist, wird ein Zielordner erstellt. Gültige Pfade sind:

  • /
  • /folder1
  • /folder1/folder2
  • folder1
  • folder1/folder2

Die vorangehenden oder nachfolgenden / werden ignoriert. Anschließend wird es als relativer Pfad der IPM-Unterstruktur behandelt: /Top Of Information Store.

Parametereigenschaften

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

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResultSize

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Wenn Sie alle Anforderungen zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert ist 1000.

Parametereigenschaften

Typ:Unlimited
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

-SourceFolder

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Der SourceFolder-Parameter gibt an, wo nach gelöschten Elementen im Postfach gesucht werden soll. Gültige Werte sind:

  • DeletedItems: Der Ordner „Gelöschte Objekte“.
  • RecoverableItems: Der Ordner "Wiederherstellbare Elemente\Deletes". Dieser Ordner enthält Elemente, die aus dem Ordner Gelöschte Elemente (vorläufig gelöschte Elemente) gelöscht wurden.
  • PurgedItems: Der Ordner "Wiederherstellbare Elemente\Purges". Dieser Ordner enthält Elemente, die aus dem Ordner "Wiederherstellbare Elemente" gelöscht wurden (endgültig gelöschte Elemente).

Wenn Sie diesen Parameter nicht verwenden, durchsucht der Befehl diese drei Ordner.

  • DiscoveryHoldsItems (nur Cloud): Der Ordner "Wiederherstellbare Elemente\DiscoveryHolds". Dieser Ordner enthält Elemente, die aus dem Ordner "Wiederherstellbare Elemente" (endgültig gelöschte Elemente) gelöscht wurden und durch einen Halteraum geschützt sind. Verwenden Sie diesen Parameter mit dem Wert DiscoveryHoldsItems, um in diesem Ordner nach gelöschten Elementen zu suchen.

Parametereigenschaften

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

Parametersätze

OnPrem
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SubjectContains

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Der Parameter SubjectContains filtert die gelöschten Elemente nach dem angegebenen Textwert im Feld Betreff. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

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

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.