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 che sono in attesa di revisione o già eliminati per un'etichetta di conservazione specifica. Può essere usata anche per recuperare un elenco di elementi eliminati per un'etichetta discografica specifica.
Questo cmdlet è disponibile solo nel ruolo di importazione/esportazione di 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
Default (Impostazione predefinita)
Get-ReviewItems
-TargetLabelId <String>
[-Disposed <Boolean>]
[-IncludeHeaders <Boolean>]
[-PagingCookie <String>]
[<CommonParameters>]
Descrizione
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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 cmdlet può essere usato per esportare un elenco di elementi in sospeso o eliminati dalla revisione dell'eliminazione Get-ReviewItems . 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 attesa di smaltimento per l'etichetta con il valore a8cbeaac-e7aa-42ed-8dba-54200537c9c9ID non modificabile. I risultati vengono convertiti in tipi di PSObject per ogni elemento e quindi inviati allo 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 inviare allo 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 attesa di disposizione per l'etichetta con il valore a8cbeaac-e7aa-42ed-8dba-54200537c9c9ID non modificabile. Se esistono più pagine di elementi, il comando continua fino a quando non ne esistono altre. I risultati vengono esportati nel file CSV specificato.
Nota: anche se questo cmdlet non limita il numero di elementi/pagine che possono essere recuperati, potrebbero verificarsi altre limitazioni. Per evitare limitazioni durante il recupero di un numero elevato di elementi, è consigliabile includere interruzioni nello script. È possibile utilizzare il parametro PagingCookie per riprendere da dove lo script si era interrotto dopo un'interruzione.
Parametri
-Disposed
Applicabile: Exchange Online
Il parametro Dispose consente di specificare se restituire gli elementi eliminati anziché quelli in sospeso per lo smaltimento. I valori validi sono:
- $true: Restituire gli articoli smaltiti.
- $false: restituisce gli elementi in attesa di smaltimento. Questo è il valore predefinito.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-IncludeHeaders
Applicabile: Exchange Online
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 formato CSV.
- $false: le intestazioni non vengono restituite come proprietà con gli elementi di revisione. Questo è il valore predefinito.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PagingCookie
Applicabile: Exchange Online
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 l'ultima operazione era stata interrotta.
Il valore PagingCookie viene restituito nella proprietà PaginationCookie ogni volta che il cmdlet viene eseguito correttamente. Se PaginationCookie è vuoto (Null), non ci sono altri elementi da recuperare.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-TargetLabelId
Applicabile: Exchange Online
Il parametro TargetLabelId consente di specificare l'etichetta per cui si desidera recuperare gli elementi della 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 PowerShell di Exchange Online: Get-ComplianceTag -Identity "<RetentionLabelName>" | select ImmutableId.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.