Commands › Exchange Online

Get-ReviewItems

Exchange Online ExchangeOnlineManagement Get-*

Use the Get-ReviewItems to retrieve a list of disposition review items that are either pending review or already disposed for a specific retention label. It can also be used to retrieve a list of disposed items for a specific record label. To use this cmdlet, you need to add the Mailbox Import Export role to a role group (for example, to the Organization Management role group). For more information, see Add a role to a role group.

Quick start script

# Get-ReviewItems — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Run and inspect
Get-ReviewItems -TargetLabelId <String> | Format-List

# 3. Export for evidence / drift tracking
Get-ReviewItems | Export-Clixml .\ReviewItems-$(Get-Date -Format yyyyMMdd).xml

Syntax

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

Parameters (4)

Parameter	Type	Required	What it controls
-TargetLabelId	String	yes	The TargetLabelId parameter specifies the label that you want to retrieve review items for. A valid value for this parameter is the immutable ID of the label.
-Disposed	Boolean		The Disposed parameter specifies whether to return disposed items instead of items pending disposition. Valid values are:
-IncludeHeaders	Boolean		The IncludeHeaders parameter specifies whether headers are returned as a property with the review items. Valid values are:
-PagingCookie	String		The PagingCookie parameter identifies the page to retrieve. This parameter is useful in the following scenarios:

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.