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.