Get-ReviewItems
此指令程式只能在雲端式服務中使用。
使用 Get-ReviewItems 擷取擱置審查或已針對特定保留標籤處置的處置檢閱項目清單。 它還可用於檢索特定唱片公司的處置項目清單。
此 Cmdlet 僅適用於信箱匯入匯出角色，而且根據預設，此角色不會指派給任何角色群組。 若您要使用此 cmdlet，必須將「信箱匯入匯出」角色新增至角色群組 (例如，Organization Management 角色群組)。 如需詳細資訊，請參閱 將角色新增至角色群組。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-ReviewItems
-TargetLabelId <String>
[-Disposed <Boolean>]
[-IncludeHeaders <Boolean>]
[-PagingCookie <String>]
[<CommonParameters>]
Description
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
Get-ReviewItems Cmdlet 可用來從處置檢閱匯出擱置或處置項目的清單。 若要深入瞭解處置檢閱，請參閱 處置內容。
範例
範例 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
適用：Exchange Online
Disposed 參數會指定是否要傳回已處置的項目，而不是擱置中的項目。 有效值為：
- $true：退回棄置的物品。
- $false：退回待處理的項目。 此值為預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludeHeaders
適用：Exchange Online
IncludeHeaders 參數會指定是否要將標頭作為檢閱項目的屬性傳回。 有效值為：
- $true：標頭會以檢閱項目的屬性形式傳回。 在 PowerShell 中將輸出轉換為 PSObject 或匯出至 CSV 時，此選項非常有用。
- $false：標頭不會以屬性與檢閱項目一起傳回。 此值為預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PagingCookie
適用：Exchange Online
PagingCookie 參數會識別要擷取的頁面。 此參數在下列案例中很有用：
- 為了避免在擷取大量項目時節流。
- 作為從上一個作業停止的地方開始的方法。
每次成功執行 cmdlet 時，會在 PaginationCookie 屬性中傳回 PagingCookie 值。 如果 PaginationCookie 為空白 (null) ，則不會再有項目可擷取。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TargetLabelId
適用：Exchange Online
TargetLabelId 參數會指定您要擷取其檢閱項目的標籤。 此參數的有效值是標籤的固定識別碼。
若要取得標籤的固定識別碼值，請以<標籤名稱取代 RetentionLabelName>，然後在 Exchange Online PowerShell 中執行下列命令。 Get-ComplianceTag -Identity "<RetentionLabelName>" | select ImmutableId
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。