Restore-Mailbox
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2009-05-14
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[]>] [-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>]]
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. 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.
Para ejecutar el cmdlet Restore-Mailbox, la cuenta que utilice debe tener delegada la función de administrador del servidor de Exchange y el grupo Administradores local tanto en el servidor de origen como en el de destino. Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange 2007, consulte Consideraciones sobre permisos.
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 usar 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. Cuando el buzón que se está restaurando es diferente del buzón del grupo de almacenamiento de recuperación, el cmdlet Restore-Mailbox hará una combinación. |
AllContentKeywords |
Opcional |
System.String[] |
El parámetro AllContentKeywords especifica los filtros de todos los siguientes componentes:
Esto permite realizar 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. |
AllowDuplicates |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro AllowDuplicates se usa para copiar elementos de correo sin comprobar si son duplicados de elementos existentes y sin quitar los elementos duplicados. Se recomienda usar el parámetro AllowDuplicates junto con el parámetro IncludeFolders. |
AttachmentFilenames |
Opcional |
System.String[] |
El parámetro AttachmentFilenames especifica el filtro del nombre del archivo adjunto. Puede usar caracteres comodín en la cadena. 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 corruptos en un buzón que se omiten antes de que falle la operación de exportación. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que el administrador reconozca qué hará el comando antes de seguir con el procesamiento. El valor predeterminado es $true. |
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, use 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 usar 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, cuando se excluye la carpeta calendar, sólo se excluye la versión en inglés de dicha carpeta porque calendario es una palabra diferente en otros idiomas. |
GlobalCatalog |
Opcional |
Microsoft.Exchange.Data.Fqdn |
El parámetro GlobalCatalog especifica el catálogo global que se usará 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, cuando se incluye la carpeta calendar, sólo se incluye la versión en inglés de dicha carpeta porque calendario es una palabra diferente en otros idiomas. |
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 usar. |
RecipientKeywords |
Opcional |
System.String[] |
El parámetro RecipientKeywords especifica los filtros de palabras clave que se aplican a los destinatarios 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. |
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. |
SenderKeywords |
Opcional |
System.String[] |
El parámetro SenderKeywords especifica los filtros de palabras clave que se aplican a los remitentes 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. |
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. |
TargetFolder |
Opcional |
System.String |
El parámetro TargetFolder especifica la carpeta del buzón que se creará en el buzón especificado. Este parámetro es necesario cuando el buzón que se está restaurando es diferente del buzón del grupo de almacenamiento de recuperación. (Por ejemplo, el valor especificado con el parámetro Identity no es el mismo que el valor especificado con el parámetro RSGMailbox.) En este caso, el cmdlet Restore-Mailbox realizará una fusión. Si los valores son iguales, el parámetro TargetFolder no es necesario. |
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. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, el administrador puede ver los cambios que se producirían sin tener que aplicarlos. El valor predeterminado es $true. |
Tipos de entrada
Tipos de valores devueltos
Errores
Excepciones
Ejemplo
En el siguiente ejemplo de código, el primer ejemplo restaura un buzón del usuario Scott desde la base de datos del grupo de almacenamiento de recuperación MyRSGDatabase.
El segundo ejemplo restaura el contenido del buzón de John en el buzón de Scott bajo la carpeta Recuperación.
El tercer ejemplo restaura únicamente el correo con el asunto "Meeting" que contenga la palabra "business" en el cuerpo del mensaje y que esté ubicado 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 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