Get-RecoverableItems

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi di un ambiente o dell'altro.

Usare il cmdlet Get-RecoverableItems elementi per visualizzare gli elementi eliminati nelle cassette postali. Dopo aver individuato gli elementi eliminati, utilizzare il cmdlet Restore-RecoverableItems per ripristinarli.

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

OnPremises 

Get-RecoverableItems
    -Identity <GeneralMailboxOrMailUserIdParameter>
    [-EntryID <String>]
    [-FilterEndTime <DateTime>]
    [-FilterItemType <String>]
    [-FilterStartTime <DateTime>]
    [-LastParentFolderID <String>]
    [-ResultSize <Unlimited>]
    [-SourceFolder <RecoverableItemsFolderType>]
    [-SubjectContains <String>]
    [<CommonParameters>]

Cloud 

Get-RecoverableItems
    -Identity <GeneralMailboxOrMailUserIdParameter[]>
    [-EntryID <String>]
    [-FilterEndTime <DateTime>]
    [-FilterItemType <String>]
    [-FilterStartTime <DateTime>]
    [-LastParentFolderID <String>]
    [-MaxParallelSize <Int32>]
    [-PolicyTag <String[]>]
    [-ResultSize <Unlimited>]
    [-SkipCount <Int32>]
    [-SourceFolder <RecoverableItemsFolderType>]
    [-SubjectContains <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.

Esempio

Esempio 1

Get-RecoverableItems -Identity laura@contoso.com -SubjectContains "FY17 Accounting" -FilterItemType IPM.Note -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"

In questo esempio vengono restituiti tutti i messaggi eliminati ripristinabili disponibili con l'oggetto specificato nella cassetta postale laura@contoso.com per l'intervallo di data/ora specificato.

Esempio 2

Get-RecoverableItems -Identity "malik@contoso.com", "lillian@contoso.com" -FilterItemType IPM.Note -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM"

In questo esempio vengono restituiti tutti i messaggi eliminati ripristinabili disponibili con l'oggetto specificato nelle cassette postali di entrambi malik@contoso.com e lillian@contoso.com per l'intervallo di data/ora specificato.

Parametri

-EntryID

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro EntryID consente di specificare l'elemento eliminato che si vuole ripristinare. Il valore EntryID dell'elemento eliminato è univoco nella cassetta postale.

È possibile trovare il EntryID per elementi specifici usando altri filtri di ricerca nel cmdlet Get-RecoverableItems (oggetto, intervallo di date, ecc.).

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

-FilterEndTime

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

FilterEndTime specifica la data/ora di fine dell'intervallo di date. Questo parametro usa il valore LastModifiedTime dell'elemento.

Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Se ad esempio il computer è configurato per l'utilizzo del formato data breve MM/gg/aaaa, immettere 01/09/2018 per specificare 1 settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

Proprietà dei parametri

Tipo:DateTime
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

-FilterItemType

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro FilterItemType filtra i risultati in base al valore della proprietà MessageClass (ItemClass) specificato dell'elemento eliminato. Ad esempio:

  • IPM.Appointment (riunioni e appuntamenti)
  • IPM. Contatto
  • IPM. File
  • IPM. Avvertenza
  • IPM. Attività

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

-FilterStartTime

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

FilterStartTime specifica la data/ora di inizio dell'intervallo di date. Questo parametro usa il valore LastModifiedTime dell'elemento.

Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Se ad esempio il computer è configurato per l'utilizzo del formato data breve MM/gg/aaaa, immettere 01/09/2018 per specificare 1 settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

Proprietà dei parametri

Tipo:DateTime
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

-Identity

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro Identity consente di specificare la cassetta postale contenente gli elementi eliminati che si desidera visualizzare. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\Nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)

In Exchange Online è possibile specificare più cassette postali separate da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".

Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se si eseguisse il comando Get- senza il parametro Identity. Verificare che tutti gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.

Proprietà dei parametri

Tipo:GeneralMailboxOrMailUserIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

OnPremises
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Cloud
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-LastParentFolderID

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro LastParentFolderID consente di specificare il valore FolderID dell'elemento prima dell'eliminazione. Ad esempio, 53B93149989CA54DBC9702AE619B9CCA000062CE9397.

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

-MaxParallelSize

Applicabile: Exchange Online

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro MaxParallelSize consente di specificare il numero massimo di cassette postali elaborate dal comando in parallelo. Un valore valido è un numero intero compreso tra 1 e 10. In genere, un valore più alto diminuisce il tempo necessario per completare il comando in più cassette postali.

Il valore di questo parametro non ha alcun effetto se il parametro Identity specifica una sola cassetta postale.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Cloud
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PolicyTag

Applicabile: Exchange Online

Questo parametro è disponibile solamente nel servizio basato su cloud.

{{ Descrizione PolicyTag }}

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Cloud
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ResultSize

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.

Proprietà dei parametri

Tipo:Unlimited
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

-SkipCount

Applicabile: Exchange Online

Questo parametro è disponibile solamente nel servizio basato su cloud.

{{ Fill SkipCount Description }}

Proprietà dei parametri

Tipo:Int32
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

-SourceFolder

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro SourceFolder consente di specificare dove cercare gli elementi eliminati nella cassetta postale. I valori validi sono:

  • DeletedItems: cartella Elementi eliminati.
  • RecoverableItems: la cartella Elementi ripristinabili\Eliminazioni. Questa cartella contiene gli elementi eliminati dalla cartella Posta eliminata (posta eliminata temporaneamente).
  • PurgedItems: la cartella Elementi ripristinabili\Purges. Questa cartella contiene gli elementi eliminati dalla cartella Elementi ripristinabili (elementi eliminati definitivamente).

Se non si usa questo parametro, il comando esegue la ricerca in queste tre cartelle.

  • DiscoveryHoldsItems (solo cloud): la cartella Recoverable Items\DiscoveryHolds. Questa cartella contiene gli elementi eliminati dalla cartella Elementi ripristinabili (elementi eliminati definitivamente) e protetti da un blocco. Per cercare gli elementi eliminati in questa cartella, usare questo parametro con il valore DiscoveryHoldsItems.

Proprietà dei parametri

Tipo:RecoverableItemsFolderType
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

-SubjectContains

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Il parametro SubjectContains filtra gli elementi in base al valore di testo specificato nel campo Subject. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

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

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.