Get-ReviewItems

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Online

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il Get-ReviewItems per recuperare un elenco di elementi di revisione dell'eliminazione in sospeso o già eliminati per un'etichetta di conservazione specifica. Può anche essere usato per recuperare un elenco di elementi eliminati per un'etichetta di record specifica.

Questo cmdlet è disponibile solo nel ruolo Importazione esportazione cassette postali e, per impostazione predefinita, il ruolo non è assegnato ad alcun gruppo di ruoli. Per utilizzare il cmdlet, è necessario aggiungere il ruolo di importazione/esportazione delle cassette postali a un gruppo di ruoli (ad esempio, al gruppo di ruoli Gestione organizzazione). Per ulteriori informazioni, vedere Aggiungere un ruolo a un gruppo di ruoli.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Il Get-ReviewItems cmdlet può essere usato per esportare un elenco di elementi in sospeso o eliminati dalla revisione dell'eliminazione. Per altre informazioni sulla revisione dell'eliminazione, vedere Eliminazione del contenuto.

Esempio

Esempio 1

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

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

$formattedExportItems

In questo esempio viene recuperata la prima pagina di elementi in sospeso per l'eliminazione dell'etichetta con il valore a8cbeaac-e7aa-42ed-8dba-54200537c9c9ID non modificabile . I risultati vengono convertiti in tipi PSObject per ogni elemento e quindi visualizzati sullo schermo.

Esempio 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

In questo esempio vengono recuperati tutti gli elementi eliminati per l'etichetta con un ID non modificabile di a8cbeaac-e7aa-42ed-8dba-54200537c9c9 e vengono selezionate colonne specifiche da restituire sullo schermo.

Esempio 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

In questo esempio vengono recuperati tutti gli elementi in sospeso per l'etichetta con il valore a8cbeaac-e7aa-42ed-8dba-54200537c9c9ID non modificabile . Se sono presenti più pagine di elementi, il comando continua fino a quando non esistono più pagine. I risultati vengono esportati nel file CSV specificato.

Nota: anche se il cmdlet non impone alcun limite al numero di elementi/pagine che è possibile recuperare, è possibile che si verifichino altre limitazioni. Per evitare la limitazione durante il recupero di un numero elevato di elementi, è consigliabile includere interruzioni nello script. È possibile usare il parametro PagingCookie per riprendere il punto in cui lo script è rimasto dopo un'interruzione.

Parametri

-Disposed

Il parametro Disposed consente di specificare se restituire gli elementi eliminati anziché gli elementi in sospeso. I valori validi sono:

$true: restituisce gli elementi eliminati.
$false: restituisce elementi in sospeso. Questo è il valore predefinito.

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

-IncludeHeaders

Il parametro IncludeHeaders specifica se le intestazioni vengono restituite come proprietà con gli elementi di revisione. I valori validi sono:

$true: le intestazioni vengono restituite come proprietà con gli elementi di revisione. Questa opzione è utile quando si converte l'output in un PSObject in PowerShell o durante l'esportazione in CSV.
$false: le intestazioni non vengono restituite come proprietà con gli elementi di revisione. Questo è il valore predefinito.

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

-PagingCookie

Il parametro PagingCookie identifica la pagina da recuperare. Questo parametro è utile negli scenari seguenti:

Per evitare la limitazione durante il recupero di un numero elevato di elementi.
Come metodo per iniziare da dove è stata interrotta l'ultima operazione.

Il valore PagingCookie viene restituito nella proprietà PaginationCookie ogni volta che il cmdlet viene eseguito correttamente. Se PaginationCookie è vuoto (null), non sono più presenti elementi da recuperare.

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

-TargetLabelId

Il parametro TargetLabelId consente di specificare l'etichetta per cui si desidera recuperare gli elementi di revisione. Un valore valido per questo parametro è l'ID non modificabile dell'etichetta.

Per ottenere il valore ID non modificabile di un'etichetta, sostituire <RetentionLabelName> con il nome dell'etichetta e quindi eseguire il comando seguente in 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