Get-ReviewItems

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Online

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie die Get-ReviewItems, um eine Liste von Löschungsüberprüfungselementen abzurufen, die entweder ausstehen oder bereits für eine bestimmte Aufbewahrungsbezeichnung verworfen wurden. Es kann auch verwendet werden, um eine Liste der verworfenen Elemente für eine bestimmte Datensatzbezeichnung abzurufen.

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

Get-ReviewItems
   -TargetLabelId <String>
   [-Disposed <Boolean>]
   [-IncludeHeaders <Boolean>]
   [-PagingCookie <String>]
   [<CommonParameters>]

Beschreibung

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.

Das Get-ReviewItems Cmdlet kann verwendet werden, um eine Liste ausstehender oder verworfener Elemente aus der Löschungsprüfung zu exportieren. Weitere Informationen zur Löschungsüberprüfung finden Sie unter Disposition von Inhalten.

Beispiele

Beispiel 1

$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true

$formattedExportItems = $itemsPendingDisposition.ExportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers

$formattedExportItems

In diesem Beispiel wird die erste Seite von Elementen mit ausstehender Löschung für die Bezeichnung mit dem unveränderlichen ID-Wert a8cbeaac-e7aa-42ed-8dba-54200537c9c9abgerufen. Die Ergebnisse werden für jedes Element in PSObject-Typen konvertiert und dann auf dem Bildschirm ausgegeben.

Beispiel 2

$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true -Disposed $true

$formattedExportItems = $itemsPendingDisposition.ExportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers

$formattedExportItems | Select Subject,Location,ReviewAction,Comment,DeletedBy,DeletedDate

In diesem Beispiel werden alle verworfenen Elemente für die Bezeichnung mit der unveränderlichen ID abgerufen a8cbeaac-e7aa-42ed-8dba-54200537c9c9 und bestimmte Spalten ausgewählt, die an den Bildschirm ausgegeben werden sollen.

Beispiel 3

$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true

$exportItems = $itemsPendingDisposition.ExportItems

While (![string]::IsNullOrEmpty($itemsPendingDisposition.PaginationCookie))
{
    $itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true -PagingCookie $itemsPendingDisposition.PaginationCookie
    $exportItems += $itemsPendingDisposition.ExportItems
}

$exportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers | Export-Csv C:\temp\ItemsPendingDisposition.csv -NoTypeInformation

In diesem Beispiel werden alle Elemente abgerufen, die für die Bezeichnung mit dem unveränderlichen ID-Wert a8cbeaac-e7aa-42ed-8dba-54200537c9c9ausstehen. Wenn mehrere Seiten mit Elementen vorhanden sind, wird der Befehl fortgesetzt, bis keine weiteren Seiten vorhanden sind. Die Ergebnisse werden in die angegebene CSV-Datei exportiert.

Hinweis: Das Cmdlet erzwingt zwar keine Beschränkung für die Anzahl der Elemente/Seiten, die abgerufen werden können, aber es kann zu einer anderen Drosselung kommen. Um eine Drosselung beim Abrufen einer großen Anzahl von Elementen zu verhindern, wird empfohlen, Unterbrechungen in Ihr Skript einzulegen. Sie können den PagingCookie-Parameter verwenden, um dort weiter zu arbeiten, wo das Skript nach einer Pause aufgehört hat.

Parameter

-Disposed

Der Disposed-Parameter gibt an, ob verworfene Elemente anstelle von ausstehenden Elementen zurückgegeben werden sollen. Gültige Werte sind:

$true: Gibt verworfene Elemente zurück.
$false: Gibt Elemente zurück, die ausstehen. Dies ist der Standardwert.

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

-IncludeHeaders

Der IncludeHeaders-Parameter gibt an, ob Header als Eigenschaft mit den Überprüfungselementen zurückgegeben werden. Gültige Werte sind:

$true: Header werden als Eigenschaft mit den Überprüfungselementen zurückgegeben. Diese Option ist beim Konvertieren der Ausgabe in ein PSObject in PowerShell oder beim Exportieren in CSV nützlich.
$false: Header werden nicht als Eigenschaft mit den Überprüfungselementen zurückgegeben. Dies ist der Standardwert.

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

-PagingCookie

Der PagingCookie-Parameter identifiziert die abzurufende Seite. Dieser Parameter ist in den folgenden Szenarien nützlich:

Um eine Drosselung beim Abrufen einer großen Anzahl von Elementen zu vermeiden.
Als Methode zum Starten an der Stelle, an der der letzte Vorgang aufgehört hat.

Der PagingCookie-Wert wird bei jeder erfolgreichen Ausführung des Cmdlets in der PaginationCookie-Eigenschaft zurückgegeben. Wenn PaginationCookie leer (NULL) ist, sind keine weiteren Elemente mehr abzurufen.

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

-TargetLabelId

Der Parameter TargetLabelId gibt die Bezeichnung an, für die Sie Überprüfungselemente abrufen möchten. Ein gültiger Wert für diesen Parameter ist die unveränderliche ID der Bezeichnung.

Um den unveränderlichen ID-Wert einer Bezeichnung abzurufen, ersetzen Sie <RetentionLabelName> durch den Namen der Bezeichnung, und führen Sie dann den folgenden Befehl in Exchange Online PowerShell aus: Get-ComplianceTag -Identity "<RetentionLabelName>" | select ImmutableId.

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