Restore-Mailbox
Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Ultima modifica dell'argomento: 2009-05-14
Il cmdlet Restore-Mailbox consente di estrarre il contenuto di una cassetta postale da un database recuperato in un gruppo di archiviazione di ripristino.
Sintassi
restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> -RSGMailbox <StoreMailboxIdParameter> -TargetFolder <String> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il cmdlet Restore-Mailbox consente di copiare i dati dell'utente finale da un gruppo di archiviazione di ripristino su un qualsiasi server in cui venga eseguito Microsoft Exchange Server 2007 in una cassetta postale di un qualunque server Cassette postali Exchange 2007 della stessa organizzazione che abbia spazio e risorse adeguate per supportare la cassetta postale. Il cmdlet Restore-Mailbox può utilizzare come origine dei dati solo le cassette postali disconnesse da un gruppo di archiviazione di ripristino presente in un server e come destinazione dei dati le cassette postali connesse.
Per eseguire il cmdlet Restore-Mailbox, l'account utilizzato deve disporre della delega del ruolo Exchange Server Administrator e del gruppo Administrators locale sia per il server di origine che per quello di destinazione. Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange 2007, vedere Considerazioni sulle autorizzazioni.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Il parametro Identity consente di specificare l'identità della cassetta postale di destinazione. Questo parametro è un nome o un GUID. Se la cassetta postale di origine non viene identificata con il parametro RSGMailbox, si suppone che la cassetta postale di origine abbia lo stesso GUID della cassetta postale di destinazione. |
RSGDatabase |
Obbligatorio |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Il parametro RSGDatabase consente di specificare il database del gruppo di archiviazione di ripristino da cui viene eseguito il ripristino della cassetta postale. È possibile utilizzare i seguenti valori:
|
RSGMailbox |
Obbligatorio |
Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter |
Il parametro RSGMailbox consente di specificare la cassetta postale nel gruppo di archiviazione di ripristino da utilizzare come cassetta postale di origine. Questo parametro è obbligatorio se la cassetta postale di origine è diversa dalla cassetta postale di destinazione. |
TargetFolder |
Obbligatorio |
System.String |
Il parametro TargetFolder consente di specificare la cartella della cassetta postale che verrà creata nella cassetta postale specificata. Se la cassetta postale ripristinata è diversa dalla cassetta postale presente nel gruppo di archiviazione di ripristino, il cmdlet Restore-Mailbox esegue un'unione. |
AllContentKeywords |
Facoltativo |
System.String[] |
Il parametro AllContentKeywords consente di specificare i filtri per i seguenti elementi:
Consente una ricerca OR all'interno di tutti questi campi. Se i criteri di ricerca specificati fanno parte dell'oggetto, del corpo del messaggio o del contenuto dell'allegato, verranno visualizzati i relativi risultati. |
AllowDuplicates |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro AllowDuplicates viene utilizzato per copiare gli elementi di posta senza controllare se sono duplicati di elementi esistenti e senza rimuovere gli elementi duplicati. Si consiglia di utilizzare il parametro AllowDuplicates insieme al parametro IncludeFolders. |
AttachmentFilenames |
Facoltativo |
System.String[] |
Il parametro AttachmentFilenames consente di specificare il filtro per il nome del file allegato. Nella stringa è possibile utilizzare caratteri jolly. È possibile utilizzare, ad esempio, "*.txt" per esportare gli elementi con estensione .txt. |
BadItemLimit |
Facoltativo |
System.Int32 |
Il parametro BadItemLimit consente di specificare il numero di elementi corrotti in una cassetta postale che devono essere ignorati prima della mancata riuscita dell'operazione di esportazione. |
Confirm |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'amministratore sappia quale operazione eseguirà il comando prima che l'elaborazione continui. Il valore predefinito è $true. |
ContentKeywords |
Facoltativo |
System.String[] |
Il parametro ContentKeywords consente di specificare i filtri per le parole chiave del corpo del messaggio e del contenuto degli allegati nella cassetta postale di origine. |
EndDate |
Facoltativo |
System.DateTime |
Il parametro EndDate consente di specificare la data di fine per l'applicazione del filtro al contenuto che verrà esportato dalla cassetta postale di origine. Verranno esportati solo gli elementi della cassetta postale la cui data è precedente alla data di fine. Quando si immette una data specifica, utilizzare il formato data breve definito nelle impostazioni delle Opzioni internazionali configurate nel computer locale. Ad esempio, se il computer è configurato per l'utilizzo del formato data breve gg/mm/aaaa, immettere 01/03/2006 per specificare il 1° marzo 2006. |
ExcludeFolders |
Facoltativo |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
Il parametro ExcludeFolders specifica l'elenco delle cartelle da escludere durante l'esportazione. Le cartelle vengono escluse man mano che vengono immesse. Le cartelle non sono localizzate. Ad esempio, se si esclude la cartella "calendar" verrà esclusa soltanto la versione inglese della cartella. Il termine "calendar" viene infatti tradotto nelle altre lingue con un termine diverso. |
GlobalCatalog |
Facoltativo |
Microsoft.Exchange.Data.Fqdn |
Il parametro GlobalCatalog consente di specificare il catalogo globale da utilizzare per la ricerca della cassetta postale di destinazione. |
IncludeFolders |
Facoltativo |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
Il parametro IncludeFolders specifica l'elenco delle cartelle da includere durante l'esportazione. Le cartelle vengono incluse man mano che vengono immesse. Le cartelle non sono localizzate. Ad esempio, se si include la cartella calendar verrà inclusa soltanto la versione inglese della cartella. Il termine "calendar" viene infatti tradotto nelle altre lingue con un termine diverso. |
Locale |
Facoltativo |
System.Globalization.CultureInfo |
Il parametro Locale consente di specificare le impostazioni internazionali su un messaggio da ripristinare. Con questo filtro impostato, verranno estratti soltanto i messaggi delle impostazioni internazionali impostate. |
MaxThreads |
Facoltativo |
System.Int32 |
Il parametro MaxThreads specifica il numero massimo di thread da utilizzare. |
RecipientKeywords |
Facoltativo |
System.String[] |
Il parametro RecipientKeywords consente di specificare i filtri per le parole chiave dei destinatari di elementi della cassetta postale di origine. Questo filtro troverà la stringa di ricerca anche se fa parte di una parola. Non si tratta di una ricerca di parole intere. |
ReportFile |
Facoltativo |
Microsoft.Exchange.Data.LocalLongFullPath |
Il parametro ReportFile specifica il percorso e il nome file del registro dei rapporti XML. |
SenderKeywords |
Facoltativo |
System.String[] |
Il parametro SenderKeywords consente di specificare i filtri per le parole chiave dei mittenti di elementi della cassetta postale di origine. Questo filtro troverà la stringa di ricerca anche se fa parte di una parola. Non si tratta di una ricerca di parole intere. |
StartDate |
Facoltativo |
System.DateTime |
Il parametro StartDate consente di specificare la data iniziale. La data iniziale deve essere antecedente alla data finale. |
SubjectKeywords |
Facoltativo |
System.String[] |
Il parametro SubjectKeywords consente di specificare i filtri per le parole chiave degli oggetti degli elementi della cassetta postale di origine. Questo filtro troverà la stringa di ricerca anche se fa parte di una parola. Non si tratta di una ricerca di parole intere. |
TargetFolder |
Facoltativo |
System.String |
Il parametro TargetFolder consente di specificare la cartella della cassetta postale che verrà creata nella cassetta postale specificata. Questo parametro è obbligatorio se la cassetta postale da ripristinare è diversa da quella del gruppo di archiviazione di ripristino. Ad esempio, il valore specificato con il parametro Identity non corrisponde a quello specificato con il parametro RSGMailbox. In questo caso, il cmdlet Restore-Mailbox esegue un'unione. Se i valori corrispondono, il parametro TargetFolder non è obbligatorio. |
ValidateOnly |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro ValidateOnly consente al comando di simulare le azioni da intraprendere sull'oggetto. Il valore predefinito è $true. |
WhatIf |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, l'amministratore può visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Il valore predefinito è $true. |
Tipi di input
Tipi restituiti
Errori
Eccezioni
Esempio
Nell'esempio di codice che segue, nel primo caso viene ripristinata una cassetta postale per l'utente Scott dal database del gruppo di archiviazione di ripristino MyRSGDatabase.
Nel secondo caso viene ripristinato il contenuto della cassetta postale di John nella cassetta postale di Scott nella cartella di ripristino.
Nel terzo caso, il ripristino viene eseguito solo per i messaggi di posta con oggetto "Meeting", il cui corpo del messaggio contiene la parola "business" e collocati nella cartella Posta in arrivo o Calendario. Questo esempio presuppone che la cassetta postale sia in lingua inglese.
L'ultima serie di esempi ripristina tutte le cassette postali del database delle cassette postali MyDatabase presenti anche nel database MyRSGDatabase.
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase -RSGMailbox John -TargetFolder Recovery
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase -SubjectKeywords "Meeting" -ContentKeyword "business" -IncludeFolders \Inbox,\Calendar
Get-Mailbox -Database MyDatabase | Restore-Mailbox -RSGDatabase MyRSGDatabase