Get-ReviewItems
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 descarte que estão pendentes de revisão ou já descartados para um rótulo de retenção específico. 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 Importação da 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 Importação da Caixa de Correio a um grupo de funções (por exemplo, para o grupo de funções Gerenciamento da 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.
Sintaxe
Default (Default)
Get-ReviewItems
-TargetLabelId <String>
[-Disposed <Boolean>]
[-IncludeHeaders <Boolean>]
[-PagingCookie <String>]
[<CommonParameters>]
Description
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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, consulte Disposição de 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 disposition para o rótulo com o valor a8cbeaac-e7aa-42ed-8dba-54200537c9c9de ID imutável . Os resultados são convertidos em tipos PSObject para cada item e, em seguida, enviados 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 a etiqueta com uma ID imutável e a8cbeaac-e7aa-42ed-8dba-54200537c9c9 seleciona colunas específicas para saída na 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 disposition para o rótulo com o valor a8cbeaac-e7aa-42ed-8dba-54200537c9c9de ID imutável . Se houver várias páginas de itens, o comando continuará até que não haja mais páginas. Os resultados são exportados para o arquivo CSV especificado.
Observação: embora esse cmdlet não limite o número de itens/páginas que podem ser recuperados, outra limitação pode ocorrer. Para evitar limitação ao recuperar um grande número de itens, recomendamos incluir quebras no script. Você pode usar o parâmetro PagingCookie para retomar de onde o script parou após um intervalo.
Parâmetros
-Disposed
Aplicável: Exchange Online
O parâmetro Disposed especifica se os itens descartados devem ser devolvidos em vez dos itens pendentes disposition. Os valores válidos são:
- $true: Devolva os itens descartados.
- $false: Devolver itens pendentes disposição. Esse valor é o padrão.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IncludeHeaders
Aplicável: Exchange Online
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 valor é o padrão.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PagingCookie
Aplicável: Exchange Online
O parâmetro PagingCookie identifica a página a ser recuperada. Esse parâmetro é útil nos seguintes cenários:
- Para evitar limitação ao recuperar um grande número de itens.
- Como um método de começar 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TargetLabelId
Aplicável: Exchange Online
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 PowerShell do Exchange Online: Get-ComplianceTag -Identity "<RetentionLabelName>" | select ImmutableId
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.