Get-ReviewItems
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 disposición que están pendientes de revisión o que ya se han eliminado para una etiqueta de retención específica. También se puede usar para recuperar una lista de artículos desechados para un sello discográfico específico.
Este cmdlet solo está disponible en el rol de exportación e importación de buzón 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.
Sintaxis
Default (valor predeterminado)
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 artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que tiene asignados. 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 disposición. Para obtener más información sobre la revisión de la disposición, consulte Disposició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 para la etiqueta con el valor a8cbeaac-e7aa-42ed-8dba-54200537c9c9de id. inmutable. Los resultados se convierten a 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 desechados para la etiqueta con un identificador inmutable y a8cbeaac-e7aa-42ed-8dba-54200537c9c9 se seleccionan columnas específicas para enviarlas 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 disposición para la etiqueta con el valor a8cbeaac-e7aa-42ed-8dba-54200537c9c9de id. 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 este cmdlet no limita el número de elementos o páginas que se pueden recuperar, pueden producirse otras limitaciones. 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 continuar donde lo dejó el script después de un descanso.
Parámetros
-Disposed
Aplicable: Exchange Online
El parámetro Disposed especifica si se devolverán los elementos eliminados en lugar de los elementos pendientes de eliminación. Los valores admitidos son:
- $true: Devolver los artículos desechados.
- $false: Devuelva los artículos pendientes de disposición. Este valor es el predeterminado.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IncludeHeaders
Aplicable: Exchange Online
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 valor es el predeterminado.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PagingCookie
Aplicable: Exchange Online
El parámetro PagingCookie identifica la página que se va a recuperar. Este parámetro es útil en los escenarios siguientes:
- Para evitar la limitación al recuperar un gran número de elementos.
- Como método para empezar donde lo dejó la última operación.
El valor de PagingCookie se devuelve en la propiedad PaginationCookie cada vez que el cmdlet se ejecuta correctamente. Si PaginationCookie está en blanco (nulo), no hay más elementos que recuperar.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TargetLabelId
Aplicable: Exchange Online
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 Id. inmutable de la etiqueta.
Para obtener el valor de Id. inmutable de una etiqueta, reemplace <RetentionLabelName> por el nombre de la etiqueta y, luego, ejecute el siguiente comando en PowerShell de Exchange Online: Get-ComplianceTag -Identity "<RetentionLabelName>" | select ImmutableId.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.