Get-ReviewItems

參考

模組:: ExchangePowerShell

適用於:: Exchange Online

此指令程式只能在雲端式服務中使用。

使用Get-ReviewItems來擷取暫止檢閱或已針對特定保留標籤處置的處置檢閱專案清單。它也可以用來擷取特定記錄標籤的已處置專案清單。

此 Cmdlet 只能在信箱匯入匯出角色中使用，而且根據預設，角色不會指派給任何角色群組。若您要使用此 cmdlet，必須將「信箱匯入匯出」角色新增至角色群組 (例如，Organization Management 角色群組)。如需詳細資訊，請參閱將角色新增至角色群組。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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

Description

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

Cmdlet Get-ReviewItems 可用來從處置檢閱匯出擱置或已處置專案的清單。若要深入瞭解處置檢閱，請參閱內容的處置。

範例

範例 1

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

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

$formattedExportItems

此範例會擷取具有不彈性識別碼值 a8cbeaac-e7aa-42ed-8dba-54200537c9c9 之標籤暫止處置專案的第一頁。結果會轉換成每個專案的 PSObject 類型，然後輸出到畫面。

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

此範例會擷取具有不可變標識 a8cbeaac-e7aa-42ed-8dba-54200537c9c9 符之標籤的所有已處置專案，並選取要輸出到畫面的特定資料行。

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

此範例會擷取標籤的所有擱置處置專案，且其識別碼值 a8cbeaac-e7aa-42ed-8dba-54200537c9c9 為。如果有多個頁面的專案存在，命令會繼續執行，直到沒有其他頁面存在為止。結果會匯出至指定的 CSV 檔案。

注意：雖然 Cmdlet 不會對可擷取的專案/頁面數目施加任何限制，但可能會發生其他節流。若要在擷取大量專案時避免節流，建議您在腳本中包含中斷。您可以使用 PagingCookie 參數來挑選腳本在中斷後離開的位置。

參數

-Disposed

Disposed 參數會指定是否要傳回已處置的專案，而不是擱置處置的專案。有效值為：

$true：傳回已處置的專案。
$false：傳回擱置處置的專案。這是預設值。

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

-IncludeHeaders

IncludeHeaders 參數會指定標頭是否以具有檢閱專案的屬性傳回。有效值為：

$true：標頭會以具有檢閱專案的屬性傳回。將輸出轉換成 PowerShell 中的 PSObject 或匯出至 CSV 時，這個選項非常有用。
$false：標頭不會以具有檢閱專案的屬性傳回。這是預設值。

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

-PagingCookie

PagingCookie 參數會識別要擷取的頁面。此參數在下列案例中很有用：

若要避免擷取大量專案時發生節流。
做為從最後一個作業離開的地方開始的方法。

每次成功執行 Cmdlet 時，PagingCookie 值都會在 PaginationCookie 屬性中傳回。如果 PaginationCookie 是空白 (null) ，就不會再擷取任何專案。

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

-TargetLabelId

TargetLabelId 參數會指定您要擷取檢閱專案的標籤。此參數的有效值是標籤的不彈性識別碼。

若要取得標籤的不彈性識別碼值，請將 RetentionLabelName > 取代 < 為標籤的名稱，然後在 powerShell 中執行下列命令Exchange Online： 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

共用方式為