共用方式為

Get-ReviewItems

模組:
Exchange PowerShell

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

使用 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。

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

適用：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 時，PagingCookie 值都會在 PaginationCookie 屬性中傳回。 如果 PaginationCookie 是空白 (null) ，就不會再擷取任何專案。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-TargetLabelId

適用：Exchange Online

TargetLabelId 參數會指定您要擷取檢閱項目的標籤。 此參數的有效值是標籤的不可變標識碼。

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