Restore-Mailbox

Questo cmdlet è disponibile solo in Exchange Server 2010.

Usare il cmdlet Restore-Mailbox per estrarre il contenuto della cassetta postale da un database ripristinato.

Nota: in Exchange Server 2010 Service Pack 1 (SP1) o versioni successive usare il cmdlet New-MailboxRestoreRequest anziché il cmdlet Restore-Mailbox per estrarre il contenuto della cassetta postale da un database ripristinato.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Restore-Mailbox
       [-Identity] <MailboxIdParameter>
       -RecoveryDatabase <DatabaseIdParameter>
       -RecoveryMailbox <StoreMailboxIdParameter>
       -TargetFolder <String>
       [-AllowDuplicates]
       [-AllContentKeywords <String[]>]
       [-AttachmentFilenames <String[]>]
       [-BadItemLimit <Int32>]
       [-Confirm]
       [-ContentKeywords <String[]>]
       [-EndDate <DateTime>]
       [-ExcludeFolders <MapiFolderPath[]>]
       [-GlobalCatalog <Fqdn>]
       [-IncludeFolders <MapiFolderPath[]>]
       [-Locale <CultureInfo>]
       [-MaxThreads <Int32>]
       [-RecipientKeywords <String[]>]
       [-SenderKeywords <String[]>]
       [-StartDate <DateTime>]
       [-SubjectKeywords <String[]>]
       [-ValidateOnly]
       [-WhatIf]
       [<CommonParameters>]

Descrizione

Il cmdlet Restore-Mailbox copia i dati dell'utente finale da qualsiasi server che esegue Microsoft Exchange Server 2010 in una cassetta postale in un server Cassette postali di Exchange 2010 nella stessa organizzazione con spazio e risorse sufficienti per supportare la cassetta postale. Il cmdlet Restore-Mailbox può usare solo cassette postali disconnesse in un server come origine dei dati e il cmdlet può usare solo le cassette postali connesse come destinazione per i dati.

È 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-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase

In questo esempio viene ripristinata una cassetta postale per l'utente Scott dal database MyRecoveryDatabase.

Esempio 2

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -RecoveryMailbox John -TargetFolder Recovery

In questo esempio il contenuto della cassetta postale di John viene ripristinato nella cassetta postale di Scott nella cartella Recovery.

Esempio 3

Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -SubjectKeywords "Meeting" -ContentKeywords "business" -IncludeFolders \Inbox,\Calendar

In questo esempio viene ripristinato solo il messaggio con l'oggetto Meeting, con il corpo del messaggio contenente la parola business e con il percorso del messaggio nella cartella Posta in arrivo o Calendario. In questo esempio si presuppone che la cassetta postale sia in inglese.

Esempio 4

Get-Mailbox -Database MyDatabase | Restore-Mailbox -RecoveryDatabase MyRecoveryDatabase

In questo esempio vengono ripristinate in blocco tutte le cassette postali del database delle cassette postali MyDatabase presenti anche in MyRecoveryDatabase.

Parametri

-AllContentKeywords

Il parametro AllContentKeywords specifica i filtri per tutti gli elementi seguenti:

  • Oggetto
  • Corpo del messaggio
  • Contenuto allegato

In questo modo è possibile eseguire una ricerca OR di tutti questi campi. Se i criteri di ricerca fanno parte dell'oggetto, del corpo del messaggio o del contenuto dell'allegato, si ottengono risultati.

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

-AllowDuplicates

L'opzione AllowDuplicates copia gli elementi di posta senza verificare se sono duplicati di elementi esistenti e senza rimuovere gli elementi duplicati. Con questa opzione non è necessario specificare alcun valore.

È consigliabile usare questa opzione con il parametro IncludeFolders.

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

-AttachmentFilenames

Il parametro AttachmentFilenames specifica il filtro per il nome del file allegato. È possibile usare caratteri jolly nella stringa. Ad esempio, è possibile usare *.txt per esportare elementi con estensione .txt.

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

-BadItemLimit

Il parametro BadItemLimit consente di specificare il numero di elementi danneggiati in una cassetta postale da ignorare prima che l'operazione di esportazione non riesca.

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

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ContentKeywords

Il parametro ContentKeywords specifica i filtri delle parole chiave per il corpo del messaggio e il contenuto degli allegati nella cassetta postale di origine.

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

-EndDate

Il parametro EndDate consente di specificare la data di fine per filtrare il contenuto che verrà esportato dalla cassetta postale di origine. Vengono esportati solo gli elementi nella cassetta postale la cui data è precedente alla data di fine. Quando si immette una data specifica, usare il formato di data breve definito nelle impostazioni opzioni internazionali configurate nel computer locale. Ad esempio, se il computer è configurato per l'uso del formato data breve mm/gg/aaaa, immettere 01/03/2010 per specificare il 1° marzo 2010.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ExcludeFolders

Il parametro ExcludeFolders consente di specificare l'elenco delle cartelle da escludere durante l'esportazione. Le cartelle vengono escluse man mano che vengono immesse. Non sono localizzati. Ad esempio, l'esclusione del calendario esclude solo il calendario in inglese perché il calendario in altre lingue è una parola diversa.

Type:MapiFolderPath[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-GlobalCatalog

Il parametro GlobalCatalog specifica il catalogo globale da utilizzare per cercare la cassetta postale di destinazione.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Identity

Il parametro Identity consente di specificare la cassetta postale da 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)
Type:MailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-IncludeFolders

Il parametro IncludeFolders consente di specificare l'elenco delle cartelle da includere durante l'esportazione. Le cartelle vengono incluse man mano che vengono immesse. Non sono localizzati. Ad esempio, l'inclusione del calendario include solo il calendario in inglese perché il calendario in altre lingue è una parola diversa.

Type:MapiFolderPath[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Locale

Il parametro Locale consente di specificare l'impostazione delle impostazioni locali in un messaggio da ripristinare. Con questo set di filtri, vengono estratti solo i messaggi con l'impostazione delle impostazioni locali specificata.

Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MaxThreads

Il parametro MaxThreads consente di specificare il numero massimo di thread da utilizzare.

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

-RecipientKeywords

Il parametro RecipientKeywords consente di specificare i filtri delle parole chiave per i destinatari degli elementi nella cassetta postale di origine. Questo filtro trova la stringa di ricerca anche se fa parte di una parola. Questa non è un'intera ricerca di parole.

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

-RecoveryDatabase

Il parametro RecoveryDatabase consente di specificare il database di ripristino da cui si sta ripristinando la cassetta postale. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID
Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RecoveryMailbox

Il parametro RecoveryMailbox consente di specificare la cassetta postale da usare come cassetta postale di origine. Questo parametro è obbligatorio se la cassetta postale di origine è diversa dalla cassetta postale di destinazione.

È possibile identificare la cassetta postale in base al relativo valore GUID. È possibile trovare il valore GUID utilizzando i cmdlet Get-Mailbox o Get-MailboxStatistics.

Type:StoreMailboxIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-SenderKeywords

Il parametro SenderKeywords consente di specificare i filtri delle parole chiave per i mittenti degli elementi nella cassetta postale di origine. Questo filtro trova la stringa di ricerca anche se fa parte di una parola. Questa non è un'intera ricerca di parole.

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

-StartDate

Il parametro StartDate consente di specificare la data di inizio. La data di inizio deve essere precedente alla data di fine.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-SubjectKeywords

Il parametro SubjectKeywords specifica i filtri delle parole chiave per gli oggetti degli elementi nella cassetta postale di origine. Questo filtro trova la stringa di ricerca anche se fa parte di una parola. Questa non è un'intera ricerca di parole.

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

-TargetFolder

Il parametro TargetFolder consente di specificare la cartella della cassetta postale creata nella cassetta postale specificata. Questo parametro è obbligatorio se la cassetta postale da ripristinare è diversa dalla cassetta postale di destinazione. Ad esempio, il valore specificato con il parametro Identity non è lo stesso del valore specificato con il parametro RecoveryMailbox. In questo caso, il comando Restore-Mailbox esegue un'unione. Se i valori sono gli stessi, il parametro TargetFolder non è obbligatorio.

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

-ValidateOnly

L'opzione ValidateOnly indica al comando di valutare le condizioni e i requisiti necessari per eseguire l'operazione e quindi segnalare se l'operazione avrà esito positivo o negativo. Con questa opzione non è necessario specificare alcun valore.

Quando si usa questa opzione non vengono apportate modifiche.

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

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.