Restore-RecoverableItems

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Usare il cmdlet Restore-RecoverableItems items per ripristinare gli elementi eliminati nelle cassette postali. Utilizzare il cmdlet Get-RecoverableItems per trovare gli elementi eliminati da ripristinare.

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

Restore-RecoverableItems
       -Identity <GeneralMailboxOrMailUserIdParameter>
       [-EntryID <String>]
       [-FilterEndTime <DateTime>]
       [-FilterItemType <String>]
       [-FilterStartTime <DateTime>]
       [-LastParentFolderID <String>]
       [-ResultSize <Unlimited>]
       [-SourceFolder <RecoverableItemsFolderType>]
       [-SubjectContains <String>]
       [<CommonParameters>]
Restore-RecoverableItems
       -Identity <GeneralMailboxOrMailUserIdParameter[]>
       [-EntryID <String>]
       [-FilterEndTime <DateTime>]
       [-FilterItemType <String>]
       [-FilterStartTime <DateTime>]
       [-LastParentFolderID <String>]
       [-MaxParallelSize <Int32>]
       [-NoOutput]
       [-PolicyTag <String[]>]
       [-RestoreTargetFolder <String>]
       [-ResultSize <Unlimited>]
       [-SourceFolder <RecoverableItemsFolderType>]
       [-SubjectContains <String>]
       [<CommonParameters>]

Descrizione

Gli elementi vengono ripristinati nel percorso della cartella originale se sono disponibili le informazioni su tali elementi. Se non sono disponibili informazioni, l'elemento viene ripristinato per il tipo di elemento (Posta in arrivo per messaggi, Calendario per riunioni e appuntamenti, ecc.).

È 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.

Esempio

Esempio 1

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

Dopo aver utilizzato il cmdlet Get-RecoverableItems per verificare l'esistenza dell'elemento, in questo esempio viene ripristinato l'elemento eliminato specificato dalla cassetta postale specificata:

  • Cassetta postale: laura@contoso.com
  • Tipo di elemento: Messaggio di posta elettronica
  • Oggetto del messaggio: Contabilità FY18
  • Posizione: Elementi ripristinabili/Eliminazioni
  • Intervallo date: 01/02/2018 - 05/02/2018

Esempio 2

$mailboxes = Import-CSV "C:\My Documents\RestoreMessage.csv"

$mailboxes | foreach {Restore-RecoverableItems -Identity $_.SMTPAddress -SubjectContains "Project X" -SourceFolder DeletedItems -FilterItemType IPM.Note}

In Exchange Server questo esempio ripristina il messaggio di posta elettronica eliminato "Project X" per le cassette postali specificate nel file csv C:\My Documents\RestoreMessage.csv. Il file CSV utilizza il valore dell'intestazione SMTPAddress e contiene l'indirizzo di posta elettronica di ogni cassetta postale su una riga separata come illustrato di seguito:

SMTPAddress

chris@contoso.com

michelle@contoso.com

laura@contoso.com

julia@contoso.com

Il primo comando legge il file CSV nella variabile denominata $mailboxes. Il secondo comando consente di ripristinare il messaggio specificato dalla cartella Elementi eliminati in tali cassette postali.

Esempio 3

Restore-RecoverableItems -Identity "malik@contoso.com","lillian@contoso.com" -FilterItemType IPM.Note -SubjectContains "COGS FY17 Review" -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM" -MaxParallelSize 2

In Exchange Online, dopo aver usato il cmdlet Get-RecoverableItems per verificare l'esistenza dell'elemento, in questo esempio vengono ripristinati gli elementi eliminati specificati nelle cassette postali specificate:

  • Cassette postali: malik@contoso.com, lillian@contoso.com
  • Tipo di elemento: Messaggio di posta elettronica
  • Oggetto del messaggio: COGS FY17 Review
  • Posizione: Elementi ripristinabili/Eliminazioni
  • Intervallo di date: dal 15/3/2019 al 25/3/2019
  • Numero di cassette postali elaborate contemporaneamente: 2

Esempio 4

Get-RecoverableItems administrator | Restore-RecoverableItems

In questo esempio vengono ripristinati in blocco tutti gli elementi ripristinabili per l'amministratore.

Parametri

-EntryID

Il parametro EntryID specifica l'elemento eliminato da ripristinare. Il valore EntryID dell'elemento eliminato è univoco nella cassetta postale.

È possibile trovare l'EntryID per elementi specifici usando altri filtri di ricerca nel cmdlet Get-RecoverableItems (oggetto, intervallo di date e così via).

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

-FilterEndTime

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. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 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".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterItemType

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

  • IPM.Appointment (riunioni e appuntamenti)
  • IPM. Contattare
  • IPM. File
  • IPM. Nota
  • IPM. Attività
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterStartTime

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. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 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".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Il parametro Identity consente di specificare la cassetta postale che contiene gli elementi eliminati che si desidera ripristinare. È 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 altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-LastParentFolderID

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

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

-MaxParallelSize

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 riduce la quantità di tempo necessaria per completare il comando in più cassette postali.

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

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

-NoOutput

Questo parametro è disponibile solamente nel servizio basato su cloud.

L'opzione NoOutput consente di ripristinare direttamente gli elementi eliminati senza alcun output del comando nella console. Con questa opzione non è necessario specificare alcun valore.

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

-PolicyTag

Questo parametro è disponibile solamente nel servizio basato su cloud.

{{ Fill PolicyTag Description }}

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

-RestoreTargetFolder

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro RestoreTargetFolder consente di specificare la cartella di primo livello in cui ripristinare i dati. Se il parametro non viene specificato, il comando ripristina le cartelle nella struttura della cartella principale nell'archivio o nella cassetta postale di destinazione. Il contenuto viene unito nelle cartelle esistenti e vengono create nuove cartelle se non sono già esistenti nella struttura della cartella di destinazione.

Questo parametro è obbligatorio per gli archivi e facoltativo per le cassette postali primarie. Se non esiste, verrà creata una cartella di destinazione. I percorsi validi sono:

  • /
  • /folder1
  • /folder1/folder2
  • folder1
  • folder1/folder2

L'oggetto precedente o finale / verrà ignorato. Verrà quindi considerato come il percorso relativo dell'albero secondario IPM: /Top Of Information Store.

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

-ResultSize

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.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceFolder

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

  • DeletedItems: cartella Elementi eliminati.
  • RecoverableItems: cartella Elementi ripristinabili\Eliminazioni. Questa cartella contiene gli elementi eliminati dalla cartella Posta eliminata (elementi eliminati temporaneamente).
  • PurgedItems: cartella Elementi ripristinabili\Purges. Questa cartella contiene gli elementi che sono stati eliminati dalla cartella Elementi ripristinabili (elementi eliminati in modo rigido).This folder contains items that have been purged from the Recoverable Items folder (hard-deleted items).

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

  • DiscoveryHoldsItems: cartella Elementi ripristinabili\DiscoveryHolds. Questa cartella contiene gli elementi che sono stati eliminati dalla cartella Elementi ripristinabili (elementi eliminati in modo rigido) e sono protetti da un blocco. Per cercare gli elementi eliminati in questa cartella, usare questo parametro con il valore DiscoveryHoldsItems.
Type:RecoverableItemsFolderType
Accepted values:DeletedItems | RecoverableItems | PurgedItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SubjectContains

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

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