Get-ReviewItems
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize o Get-ReviewItems para obter uma lista de itens de revisão de eliminação que estão pendentes ou já eliminados para uma etiqueta de retenção específica. Também pode ser utilizado para obter uma lista de itens eliminados para uma etiqueta de registo específica.
Este cmdlet só está disponível na função Importar Exportação da Caixa de Correio e, por predefinição, a função não está atribuída a nenhum grupo de funções. Para utilizar este cmdlet, tem de adicionar a função Importar Exportação da Caixa de Correio a um grupo de funções (por exemplo, ao grupo de funções Gestão da Organização). Para obter mais informações, veja 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 (Padrão)
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, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 utilizado para exportar uma lista de itens pendentes ou eliminados da revisão de eliminação. Para saber mais sobre a revisão da eliminação, veja Disposition of content (Eliminação de conteúdos).
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 obtém a primeira página de itens com disposição pendente para a etiqueta com o valor a8cbeaac-e7aa-42ed-8dba-54200537c9c9ID imutável . Os resultados são convertidos em tipos PSObject para cada item e, em seguida, são exportados para o ecrã.
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 obtém todos os itens eliminados para a etiqueta com um ID imutável de a8cbeaac-e7aa-42ed-8dba-54200537c9c9 e seleciona colunas específicas para exportar para o ecrã.
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 obtém todos os itens com disposição pendente para a etiqueta com o valor a8cbeaac-e7aa-42ed-8dba-54200537c9c9ID imutável . Se existirem múltiplas páginas de itens, o comando continuará até que não existam mais páginas. Os resultados são exportados para o ficheiro CSV especificado.
Nota: embora este cmdlet não limite o número de itens/páginas que podem ser obtidos, poderá ocorrer outra limitação. Para impedir a limitação durante a obtenção de um grande número de itens, recomendamos a inclusão de quebras no script. Pode utilizar o parâmetro PagingCookie para retomar onde o script ficou após uma pausa.
Parâmetros
-Disposed
Aplicável: Exchange Online
O parâmetro Eliminado especifica se pretende devolver itens eliminados em vez de itens com disposição pendente. Os valores válidos são:
- $true: devolver itens eliminados.
- $false: devolver itens com disposição pendente. Este valor é a predefiniçã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 devolvidos como uma propriedade com os itens de revisão. Os valores válidos são:
- $true: os cabeçalhos são devolvidos como uma propriedade com os itens de revisão. Esta opção é útil ao converter a saída num PSObject no PowerShell ou ao exportar para CSV.
- $false: os cabeçalhos não são devolvidos como uma propriedade com os itens de revisão. Este valor é a predefiniçã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 obter. Este parâmetro é útil nos seguintes cenários:
- Para evitar limitações durante a obtenção de um grande número de itens.
- Como método de início da última operação.
O valor PagingCookie é devolvido na propriedade PaginationCookie sempre que o cmdlet é executado com êxito. Se PaginationCookie estiver em branco (nulo), não existem mais itens a obter.
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 a etiqueta para a qual pretende obter os itens de revisão. Um valor válido para este parâmetro é o ID imutável da etiqueta.
Para obter o valor ID imutável de uma etiqueta, substitua <RetentionLabelName> pelo nome da etiqueta e, em seguida, execute o seguinte comando no Exchange Online PowerShell: 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.