Get-ReviewItems
Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.
Verwenden Sie die Get-ReviewItems, um eine Liste von Elementen zur Dispositionsüberprüfung abzurufen, die entweder zur Überprüfung 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 Plattenbezeichnung 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
Default (Standard)
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. 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.
Das Get-ReviewItems Cmdlet kann verwendet werden, um eine Liste ausstehender oder verworfener Elemente aus der Dispositionsüberprüfung zu exportieren. Weitere Informationen zur Dispositionsü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 der Elemente abgerufen, deren Disposition für die Bezeichnung mit dem unveränderlichen ID-Wert a8cbeaac-e7aa-42ed-8dba-54200537c9c9aussteht. Die Ergebnisse werden für jeden Artikel 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 das Etikett mit der unveränderlichen ID abgerufen a8cbeaac-e7aa-42ed-8dba-54200537c9c9 und bestimmte Spalten für die Ausgabe auf dem Bildschirm ausgewählt.
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 mit ausstehender Disposition für die Bezeichnung mit dem unveränderlichen ID-Wert a8cbeaac-e7aa-42ed-8dba-54200537c9c9abgerufen. Wenn mehrere Seiten mit Elementen vorhanden sind, wird der Befehl fortgesetzt, bis keine weiteren Seiten mehr vorhanden sind. Die Ergebnisse werden in die angegebene CSV-Datei exportiert.
Hinweis: Obwohl dieses Cmdlet die Anzahl der Elemente/Seiten, die abgerufen werden können, nicht einschränkt, kann es zu einer anderen Drosselung kommen. Um eine Drosselung beim Abrufen einer großen Anzahl von Elementen zu verhindern, empfehlen wir, Pausen in Ihr Skript einzuschließen. Sie können den PagingCookie-Parameter verwenden, um dort weiterzumachen, wo das Skript nach einer Pause beendet wurde.
Parameter
-Disposed
Anwendbar: Exchange Online
Der Parameter Disposed gibt an, ob verworfene Elemente anstelle von Elementen zurückgegeben werden sollen, deren Disposition aussteht. Gültige Werte sind:
- $true: Entsorgte Artikel zurückgeben.
- $false: Senden Sie Elemente zurück, deren Disposition aussteht. Dieser Wert ist der Standardwert.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-IncludeHeaders
Anwendbar: Exchange Online
Der Parameter IncludeHeaders gibt an, ob Header als Eigenschaft mit den Überprüfungselementen zurückgegeben werden. Gültige Werte sind:
- $true: Kopfzeilen werden als Eigenschaft mit den Prüfelementen zurückgegeben. Diese Option ist nützlich, wenn Sie die Ausgabe in ein PSObject in PowerShell konvertieren oder in CSV exportieren.
- $false: Kopfzeilen werden nicht als Eigenschaft mit den Überprüfungselementen zurückgegeben. Dieser Wert ist der Standardwert.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-PagingCookie
Anwendbar: Exchange Online
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, um dort zu beginnen, wo der letzte Vorgang aufgehört hat.
Der PagingCookie-Wert wird jedes Mal in der PaginationCookie-Eigenschaft zurückgegeben, wenn das Cmdlet erfolgreich ausgeführt wird. Wenn das PaginationCookie leer (null) ist, gibt es keine weiteren Elemente, die abgerufen werden können.
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 |
-TargetLabelId
Anwendbar: Exchange Online
Der Parameter TargetLabelId gibt die Bezeichnung an, für die Sie Prüfelemente 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| 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.