Freigeben über

Get-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 Get-RecoverableItems Items, 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 von malik@contoso.com und lillian@contoso.com für den angegebenen Datums-/Uhrzeitbereich zurückgegeben.

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 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 durch Kommas getrennt angeben. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Achtung: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt haben. Vergewissern Sie sich, dass listen von Werten für den Identity-Parameter 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 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

-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

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

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