Get-RecoverableItems

Modul:
Exchange PowerShell

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

Verwenden Sie das Cmdlet Get-RecoverableItems Elemente, um gelöschte Elemente in Postfächern anzuzeigen. Nachdem Sie die gelöschten Elemente gefunden haben, verwenden Sie das Cmdlet Restore-RecoverableItems, 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 

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

Cloud 

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

Beschreibung

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

Get-RecoverableItems -Identity laura@contoso.com -SubjectContains "FY17 Accounting" -FilterItemType IPM.Note -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"

In diesem Beispiel werden alle verfügbaren wiederherstellbaren gelöschten Nachrichten mit dem angegebenen Betreff im Postfach laura@contoso.com für den angegebenen Datums-/Uhrzeitbereich zurückgegeben.

Beispiel 2

Get-RecoverableItems -Identity "malik@contoso.com", "lillian@contoso.com" -FilterItemType IPM.Note -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM"

In diesem Beispiel werden alle verfügbaren wiederherstellbaren gelöschten Nachrichten mit dem angegebenen Betreff in den Postfächern beider malik@contoso.comlillian@contoso.com und für den angegebenen Datums-/Uhrzeitbereich zurückgegeben.

Parameter

-EntryID

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

Der Parameter EntryID 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 für das Get-RecoverableItems Cmdlet verwenden (Betreff, Datumsbereich usw.).

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 01.09.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 Parameter FilterItemType filtert die Ergebnisse nach dem angegebenen Eigenschaftswert MessageClass (ItemClass) 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 01.09.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 anzeigen 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 angeben, die durch Kommas getrennt sind. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Vorsicht: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte so zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt hätten. Überprüfen Sie, ob alle Wertelisten für den Parameter "Identity" korrekt sind und keine nicht vorhandenen $null-Werte enthalten.

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 Ordner-ID-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 der Postfächer an, die vom Befehl parallel verarbeitet werden. Ein gültiger Wert ist eine ganze Zahl zwischen 1 und 10. Typischerweise verringert ein höherer Wert die Zeit, die benötigt wird, um den Befehl für mehrere Postfächer auszuführen.

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

-PolicyTag

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill PolicyTag-Beschreibung }}

Parametereigenschaften

Typ:

String[]

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

-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

-SkipCount

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill SkipCount Description }}

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

-SourceFolder

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

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

  • DeletedItems: Der Ordner „Gelöschte Objekte“.
  • RecoverableItems: Der Ordner "Wiederherstellbare Elemente\Löschungen". Dieser Ordner enthält Elemente, die aus dem Ordner "Gelöschte Elemente" gelöscht wurden (vorläufig gelöschte Elemente).
  • PurgedItems: Der Ordner "Wiederherstellbare Elemente\Löschungen". Dieser Ordner enthält Elemente, die aus dem Ordner "Wiederherstellbare Elemente" gelöscht wurden (hartgelö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" gelöscht wurden (hartgelöschte Elemente), die durch eine Sperre geschützt sind. Um in diesem Ordner nach gelöschten Elementen zu suchen, verwenden Sie diesen Parameter mit dem Wert DiscoveryHoldsItems.

Parametereigenschaften

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

-SubjectContains

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

Der Parameter SubjectContains filtert die Elemente nach dem angegebenen Textwert im Feld "Subject". 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.