Restore-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 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 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 

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

Cloud 

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

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 viene ripristinato il messaggio di posta elettronica eliminato "Project X" per le cassette postali specificate nel file con valori delimitati da virgole (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: Revisione COGS FY17
  • Posizione: Elementi ripristinabili/Eliminazioni
  • Intervallo di date: dal 15/03/2019 al 25/03/2019
  • Numero di cassette postali elaborate contemporaneamente: 2

Esempio 4

Get-RecoverableItems administrator | Restore-RecoverableItems

Questo esempio ripristina in blocco tutti gli elementi ripristinabili per l'amministratore.

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 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".

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

-NoOutput

Applicabile: Exchange Online

Questo parametro è disponibile solamente nel servizio basato su cloud.

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

Proprietà dei parametri

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

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

-RestoreTargetFolder

Applicabile: Exchange Online

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 è disponibile solo nelle cassette postali principali e viene ignorato nelle cassette postali di archiviazione. Viene creata una cartella di destinazione se non esiste. I percorsi validi sono:

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

Le attività precedenti o finali / vengono ignorate. Quindi, viene considerato come il percorso relativo del sottoalbero IPM: /Top Of Information Store.

Proprietà dei parametri

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

Set di parametri

Default
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

-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

OnPrem
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 eliminati 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.