Get-ReviewItems
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-54200537c9c9
ID 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-54200537c9c9
ID 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 |