Get-ReviewItems
此 cmdlet 仅在基于云的服务中可用。
使用 Get-ReviewItems 检索处于待处理审阅状态或已为特定保留标签释放的处置评审项目列表。 它还可用于检索特定记录标签的已释放项的列表。
此 cmdlet 仅在邮箱导入导出角色中可用，默认情况下，该角色不会分配给任何角色组。 要使用此 cmdlet，需将邮箱导入导出角色添加到角色组（例如，添加到“组织管理”角色组）。 有关详细信息，请参阅向角色组添加角色。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default （默认值）
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
适用：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 参数指定要检索其审阅项目的标签。 此参数的有效值是标签的不可变 ID。
若要获取标签的不可变 ID 值，请将 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。