Get-ReviewItems

Módulo:

ExchangePowerShell

Aplica-se a:

Exchange Online

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o Get-ReviewItems para recuperar uma lista de itens de revisão de disposição que estão pendentes ou já descartados para um rótulo de retenção específico. Ele também pode ser usado para recuperar uma lista de itens descartados para uma gravadora específica.

Esse cmdlet está disponível apenas na função Exportação de Importação de Caixa de Correio e, por padrão, a função não é atribuída a nenhum grupo de funções. Para usar esse cmdlet, você precisa adicionar a função Exportação de Importação de Caixa de Correio a um grupo de funções (por exemplo, ao grupo de funções gerenciamento de organização). Para obter mais informações, consulte Adicionar uma função a um grupo de funções.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

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

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

O Get-ReviewItems cmdlet pode ser usado para exportar uma lista de itens pendentes ou descartados da revisão de disposição. Para saber mais sobre a revisão de disposição, confira Disposição do conteúdo.

Exemplos

Exemplo 1

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

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

$formattedExportItems

Este exemplo recupera a primeira página de itens pendentes de disposição para o rótulo com o valor a8cbeaac-e7aa-42ed-8dba-54200537c9c9ID imutável . Os resultados são convertidos em tipos PSObject para cada item e, em seguida, saída para a tela.

Exemplo 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

Este exemplo recupera todos os itens descartados para o rótulo com uma ID a8cbeaac-e7aa-42ed-8dba-54200537c9c9 imutável e seleciona colunas específicas para saída para a tela.

Exemplo 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

Este exemplo recupera todos os itens pendentes de disposição para o rótulo com o valor a8cbeaac-e7aa-42ed-8dba-54200537c9c9de ID imutável . Se existirem várias páginas de itens, o comando continuará até que não existam mais páginas. Os resultados são exportados para o arquivo CSV especificado.

Observação: embora o cmdlet não imponha nenhum limite ao número de itens/páginas que podem ser recuperados, outra limitação pode ocorrer. Para evitar a limitação durante a recuperação de um grande número de itens, recomendamos incluir interrupções no script. Você pode usar o parâmetro PagingCookie para continuar de onde o script parou após uma pausa.

Parâmetros

-Disposed

O parâmetro Descartado especifica se deve retornar itens descartados em vez de itens pendentes de disposição. Os valores válidos são:

• $true: retornar itens descartados.
• $false: retornar itens pendentes de disposição. Esse é o valor padrão.

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

-IncludeHeaders

O parâmetro IncludeHeaders especifica se os cabeçalhos são retornados como uma propriedade com os itens de revisão. Os valores válidos são:

• $true: os cabeçalhos são retornados como uma propriedade com os itens de revisão. Essa opção é útil ao converter a saída em um PSObject no PowerShell ou ao exportar para CSV.
• $false: os cabeçalhos não são retornados como uma propriedade com os itens de revisão. Esse é o valor padrão.

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

-PagingCookie

O parâmetro PagingCookie identifica a página a ser recuperada. Esse parâmetro é útil nos seguintes cenários:

• Para evitar limitação durante a recuperação de um grande número de itens.
• Como um método de início de onde a última operação parou.

O valor PagingCookie é retornado na propriedade PaginationCookie sempre que o cmdlet é executado com êxito. Se o PaginationCookie estiver em branco (nulo), não haverá mais itens a serem recuperados.

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

-TargetLabelId

O parâmetro TargetLabelId especifica o rótulo para o qual você deseja recuperar itens de revisão. Um valor válido para esse parâmetro é a ID imutável do rótulo.

Para obter o valor de ID imutável de um rótulo, substitua <RetentionLabelName> pelo nome do rótulo e execute o seguinte comando no 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