Freigeben über

Restore-RecoverableItems

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Exchange Server 2016, Exchange Server 2019, Exchange Online

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

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

Restore-RecoverableItems
       -Identity <GeneralMailboxOrMailUserIdParameter>
       [-EntryID <String>]
       [-FilterEndTime <DateTime>]
       [-FilterItemType <String>]
       [-FilterStartTime <DateTime>]
       [-LastParentFolderID <String>]
       [-ResultSize <Unlimited>]
       [-SourceFolder <RecoverableItemsFolderType>]
       [-SubjectContains <String>]
       [<CommonParameters>]
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. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den 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:

  • Postfach: 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

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterEndTime

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 auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum 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".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterItemType

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
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterStartTime

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 auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum 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".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

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

Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-LastParentFolderID

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-MaxParallelSize

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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-NoOutput

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 bei dieser Option keinen Wert angeben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PolicyTag

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill PolicyTag Description }}

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RestoreTargetFolder

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 für Archive erforderlich und optional für primäre Postfächer. Wenn er nicht vorhanden ist, wird ein Zielordner erstellt. Gültige Pfade sind:

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

Das vorangehende oder nachfolgende / wird ignoriert. Anschließend wird er als relativer Pfad der IPM-Unterstruktur behandelt: /Top Of Information Store.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

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.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceFolder

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: 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.
Type:RecoverableItemsFolderType
Accepted values:DeletedItems | RecoverableItems | PurgedItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SubjectContains

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 (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online