Restore-Mailbox (RTM)
Si applica a: Exchange Server 2007
Ultima modifica dell'argomento: 2007-06-05
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[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]
restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> -RSGMailbox <StoreMailboxIdParameter> -TargetFolder <String> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <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.
Un gruppo di archiviazione di ripristino consente di ripristinare i dati da una copia di backup del database senza interferire con l'accesso ai dati correnti dell'utente. Il gruppo di archiviazione di ripristino può anche essere utile per recuperare i dati perduti. Un server può contenere solo un gruppo di archiviazione di ripristino.
Per eseguire il cmdlet Restore-Mailbox, è necessario utilizzare un account che disponga della seguente delega:
- Ruolo Exchange Server Administrator e appartenenza al gruppo Administrators locale sia nel server di origine che in quello di destinazione
Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.
I server sono parte di un'unica foresta o di foreste di risorse. È possibile esportare i dati delle cassette postali solo nelle cassette postali all'interno della stessa foresta. Gli account del servizio directory di Active Directory associati alla cassetta postale possono trovarsi in una foresta esterna ma non è possibile esportare i dati nei server in foreste diverse.
I database ripristinati e di origine devono essere ricavati da un server di Exchange 2007.
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.
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. |
AllContentKeywords |
Facoltativo |
System.String[] |
Il parametro AllContentKeywords consente di specificare i filtri per i seguenti elementi:
Ciò consente una ricerca Or 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. |
AttachmentFilenames |
Facoltativo |
System.String[] |
Il parametro AttachmentFilenames consente di specificare il filtro per il nome del file allegato. Nella stringa è possibile utilizzare caratteri jolly. Ad esempio, è possibile utilizzare "*.txt" per esportare gli elementi con l'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. |
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 calendar verrà esclusa soltanto la versione inglese del calendario. 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 calendar verrà inclusa soltanto la versione inglese del calendario. 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. |
ReportFile |
Facoltativo |
Microsoft.Exchange.Data.LocalLongFullPath |
Il parametro ReportFile specifica il percorso e il nome file del registro dei rapporti XML. |
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. |
ValidateOnly |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro ValidateOnly consente al comando di simulare le azioni da intraprendere sull'oggetto. Il valore predefinito è $true. |
Tipi di input
Tipi restituiti
Errori
Errore |
Descrizione |
|
|
Eccezioni
Eccezioni |
Descrizione |
|
|
Esempio
Nell'esempio di codice che segue, il primo esempio ripristina una cassetta postale per l'utente Chris dal database del gruppo di archiviazione di ripristino MyRSGDatabase. Il secondo esempio ripristina il contenuto della cassetta postale di Ricardo nella cassetta postale di Chris nella cartella di ripristino. Il terzo esempio ripristina soltanto i messaggi con l'oggetto "Meeting" AND contenenti la parola "business" nel corpo AND che si trovano nelle cartelle 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 chris -RSGDatabase MyRSGDatabase
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -RSGMailbox Ricardo -TargetFolder Recovery
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -SubjectKeywords "Meeting" -ContentKeyword "business" -IncludeFolders \Inbox,\Calendar
Get-mailbox -Database MyDatabase | Restore-Mailbox -RSGDatabase MyRSGDatabase