Get-ReviewItems

  • Referencia
Módulo:
ExchangePowerShell
Se aplica a:
Exchange Online

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el Get-ReviewItems para recuperar una lista de elementos de revisión de eliminación que están pendientes de revisión o que ya están eliminados para una etiqueta de retención específica. También se puede usar para recuperar una lista de elementos eliminados para una etiqueta de registro específica.

Este cmdlet solo está disponible en el rol Exportación de importación de buzones y, de forma predeterminada, el rol no está asignado a ningún grupo de roles. Para usar este cmdlet, deberá agregar el rol de importación y exportación de buzón de correo a un grupo de roles (por ejemplo, al grupo de roles de administración de la organización). Para obtener más información, vea Agregar un rol a un grupo de roles.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

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

Description

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

El Get-ReviewItems cmdlet se puede usar para exportar una lista de elementos pendientes o eliminados de la revisión de eliminación. Para más información sobre la revisión de eliminación, consulte Eliminación del contenido.

Ejemplos

Ejemplo 1

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

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

$formattedExportItems

En este ejemplo se recupera la primera página de elementos pendientes de eliminación de la etiqueta con el valor a8cbeaac-e7aa-42ed-8dba-54200537c9c9de identificador inmutable . Los resultados se convierten en tipos PSObject para cada elemento y, a continuación, se envían a la pantalla.

Ejemplo 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

En este ejemplo se recuperan todos los elementos eliminados de la etiqueta con un identificador inmutable de a8cbeaac-e7aa-42ed-8dba-54200537c9c9 y se seleccionan columnas específicas para la salida a la pantalla.

Ejemplo 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

En este ejemplo se recuperan todos los elementos pendientes de eliminación de la etiqueta con el valor a8cbeaac-e7aa-42ed-8dba-54200537c9c9de identificador inmutable . Si existen varias páginas de elementos, el comando continúa hasta que no existan más páginas. Los resultados se exportan al archivo CSV especificado.

Nota: Aunque el cmdlet no impone ningún límite al número de elementos o páginas que se pueden recuperar, puede producirse otra limitación. Para evitar la limitación al recuperar un gran número de elementos, se recomienda incluir interrupciones en el script. Puede usar el parámetro PagingCookie para seleccionar dónde dejó el script después de una interrupción.

Parámetros

-Disposed

El parámetro Disposed especifica si se deben devolver elementos eliminados en lugar de elementos pendientes de eliminación. Los valores admitidos son:

  • $true: devolver elementos eliminados.
  • $false: Devolver elementos pendientes de eliminación. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-IncludeHeaders

El parámetro IncludeHeaders especifica si los encabezados se devuelven como una propiedad con los elementos de revisión. Los valores admitidos son:

  • $true: los encabezados se devuelven como una propiedad con los elementos de revisión. Esta opción es útil al convertir la salida en un PSObject en PowerShell o al exportar a CSV.
  • $false: los encabezados no se devuelven como una propiedad con los elementos de revisión. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PagingCookie

El parámetro PagingCookie identifica la página que se va a recuperar. Este parámetro es útil en los siguientes escenarios:

  • Para evitar la limitación al recuperar un gran número de elementos.
  • Como método de inicio donde se dejó la última operación.

El valor pagingCookie se devuelve en la propiedad PaginationCookie cada vez que el cmdlet se ejecuta correctamente. Si PaginationCookie está en blanco (null), no hay más elementos que recuperar.

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

-TargetLabelId

El parámetro TargetLabelId especifica la etiqueta para la que desea recuperar los elementos de revisión. Un valor válido para este parámetro es el identificador inmutable de la etiqueta.

Para obtener el valor de identificador inmutable de una etiqueta, reemplace <RetentionLabelName> por el nombre de la etiqueta y, a continuación, ejecute el siguiente comando en 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