Get-ReviewItems

  • 参考
模块:
ExchangePowerShell
适用于:
Exchange Online

此 cmdlet 仅在基于云的服务中可用。

使用Get-ReviewItems检索处于待处理审阅状态或已为特定保留标签释放的处置评审项目列表。 它还可用于检索特定记录标签的已释放项的列表。

此 cmdlet 仅在邮箱导入导出角色中可用，默认情况下，该角色不分配给任何角色组。 要使用此 cmdlet，需将邮箱导入导出角色添加到角色组（例如，添加到“组织管理”角色组）。 有关详细信息，请参阅向角色组添加角色。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

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

说明

您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 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

此示例检索具有不可变 ID 值的 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

此示例检索具有不可变 ID 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

此示例检索具有不可变 ID 值的 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 参数指定要检索其审阅项目的标签。 此参数的有效值是标签的不可变 ID。

若要获取标签的不可变 ID 值，请将 RetentionLabelName> 替换为<标签的名称，然后在 Exchange Online PowerShell 中运行以下命令：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