Restore-Mailbox (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-05
Use el cmdlet Restore-Mailbox para extraer contenido del buzón desde una base de datos restaurada en un grupo de almacenamiento de recuperación.
Sintaxis
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>]
Descripción detallada
El cmdlet Restore-Mailbox copia los datos del usuario final desde un grupo de almacenamiento de recuperación en cualquier servidor que ejecute Microsoft Exchange Server 2007 en un buzón en cualquier servidor de buzones de Exchange 2007 en la misma organización que tenga espacio adecuado y recursos para compatibilizar con el buzón.
Un buzón de almacenamiento de recuperación le permite recuperar los datos de una copia de seguridad sin molestar el acceso de usuario a los datos actuales. El grupo de almacenamiento de recuperación puede también ser útil en la recuperación de datos si se produce una pérdida de los mismos. Un servidor contiene sólo un grupo de almacenamiento de recuperación.
Para ejecutar el cmdlet Restore-Mailbox, se debe usar una cuenta en la que se delegue lo siguiente:
- Función Administrador de Exchange Server y grupo Administradores local para los servidores de origen y de destino.
Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.
Los servidores son parte de un bosque único o bosques de recursos. Los datos de buzón pueden exportarse sólo a buzones dentro del mismo bosque. Las cuentas del servicio de directorio de Active Directory asociadas con el buzón pueden estar en un bosque externo, pero los datos del buzón no pueden exportarse a los servidores en distintos bosques.
Las bases de datos recuperadas y de origen deben proceder de un servidor de Exchange 2007.
El cmdlet Restore-Mailbox sólo puede usar buzones desconectados de un grupo de almacenamiento de recuperación de un servidor como fuente de datos y buzones conectados como un destino para los datos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
El parámetro Identity especifica la identidad del buzón de destino. Este parámetro es un nombre o un GUID. Si el buzón de origen no se identifica con el parámetro RSGMailbox, se supone que el buzón de origen tiene el mismo GUID de buzón que el buzón de destino. |
RSGDatabase |
Necesario |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
El parámetro RSGDatabase especifica la base de datos del grupo de almacenamiento de recuperación desde el cual está restaurando el buzón. Puede utilizar los siguientes valores:
|
RSGMailbox |
Necesario |
Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter |
El parámetro RSGMailbox especifica el buzón en el grupo de almacenamiento de recuperación que va a ser usado como buzón origen. Este parámetro es necesario si el buzón de origen es distinto al buzón de destino. |
TargetFolder |
Necesario |
System.String |
El parámetro TargetFolder especifica la carpeta del buzón que se creará en el buzón especificado. |
AllContentKeywords |
Opcional |
System.String[] |
El parámetro AllContentKeywords especifica los filtros de todos los siguientes componentes:
Esto permite una búsqueda O de todos estos campos. Si los criterios de búsqueda forman parte del asunto, cuerpo del mensaje o contenido del archivo adjunto, obtendrá resultados. |
AttachmentFilenames |
Opcional |
System.String[] |
El parámetro AttachmentFilenames especifica el filtro del nombre del archivo adjunto. En la cadena se pueden usar caracteres comodín. Por ejemplo, puede usar "*.txt" para exportar los elementos que tengan la extensión .txt. |
BadItemLimit |
Opcional |
System.Int32 |
El parámetro BadItemLimit especifica el número de elementos dañados en un buzón que se omiten antes de que se produzca un error en la operación de exportación. |
ContentKeywords |
Opcional |
System.String[] |
El parámetro ContentKeywords especifica los filtros de palabras clave del cuerpo del mensaje y el contenido de los archivos adjuntos del buzón de origen. |
EndDate |
Opcional |
System.DateTime |
El parámetro EndDate especifica la fecha final para filtrar contenido que se exportará desde el buzón de origen. Sólo se exportarán elementos del buzón cuya fecha sea anterior a la fecha final. Cuando escriba una fecha específica, utilice el formato de fecha abreviado definido en las opciones de Configuración regional configuradas en el equipo local. Por ejemplo, si el equipo está configurado para utilizar un formato de fecha abreviado mm/dd/aaaa, escriba 03/01/2006 para especificar el 1 de marzo de 2006. |
ExcludeFolders |
Opcional |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
El parámetro ExcludeFolders especifica la lista de carpetas que se excluirán durante la exportación. Las carpetas son excluidas a medida que son introducidas. No se localizan. Por ejemplo, excluyendo calendar sólo se excluirá el calendario en inglés ya que el calendario en otros idiomas es una palabra distinta. |
GlobalCatalog |
Opcional |
Microsoft.Exchange.Data.Fqdn |
El parámetro GlobalCatalog especifica el catálogo global que se utilizará para buscar el buzón de destino. |
IncludeFolders |
Opcional |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
El parámetro IncludeFolders especifica la lista de carpetas que se incluirán durante la exportación. Las carpetas son incluidas a medida que son introducidas. No se localizan. Por ejemplo, incluyendo calendar sólo se incluirá el calendario en inglés ya que el calendario en otros idiomas es una palabra distinta. |
Locale |
Opcional |
System.Globalization.CultureInfo |
El parámetro Locale especifica la configuración local en un mensaje que se va a restaurar. Con esta configuración de filtro, sólo los mensajes establecidos en la configuración regional serán extraídos. |
MaxThreads |
Opcional |
System.Int32 |
El parámetro MaxThreads especifica el número máximo de subprocesos que se van a utilizar. |
ReportFile |
Opcional |
Microsoft.Exchange.Data.LocalLongFullPath |
El parámetro ReportFile especifica la ruta y el nombre de archivo del archivo de registro del informe XML. |
StartDate |
Opcional |
System.DateTime |
El parámetro StartDate especifica la fecha de inicio. La fecha de inicio debe ser anterior a la fecha de finalización. |
SubjectKeywords |
Opcional |
System.String[] |
El parámetro SubjectKeywords especifica los filtros de palabras clave que se aplican a los asuntos de elementos del buzón de origen. Este filtro encontrará la cadena de búsqueda aunque sea parte de una palabra. No se trata de una búsqueda por palabra completa. |
ValidateOnly |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro ValidateOnly indica al comando que simule las acciones que llevaría a cabo en el objeto. El valor predeterminado es $true. |
Tipos de entrada
Tipos de valores devueltos
Errores
Error |
Descripción |
|
|
Excepciones
Excepciones |
Descripción |
|
|
Ejemplo
En el siguiente ejemplo de código, el primer ejemplo restaura un buzón del usuario Chris desde la base de datos del grupo de almacenamiento de recuperación MyRSGDatabase. El segundo ejemplo restaura el contenido del buzón de Ricardo en el buzón de Chris bajo la carpeta Recuperación. El tercer ejemplo restaura sólo los mensajes de correo con el asunto "Meeting" Y que contengan la palabra "business" en el cuerpo del mensaje Y que esté ubicados tanto en la carpeta Bandeja de entrada o Calendario. Este ejemplo supone que el buzón está en inglés. El lote del último ejemplo restaura los buzones en la base de datos de buzón MyDatabase que están igualmente presentes en 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