Export-Mailbox
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2010-05-24
Use el cmdlet Export-Mailbox para mover el contenido de un buzón a una carpeta de buzón especificada.
Sintaxis
export-Mailbox -Identity <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-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>]]
export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AllowMerge <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-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>]]
export-Mailbox -Identity <MailboxIdParameter> -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeAssociatedMessages <SwitchParameter>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Para ejecutar el cmdlet Export-Mailbox, la cuenta que use debe tener delegado lo siguiente:
Función de administrador de servidores de Exchange y grupo Administradores local para el servidor de destino
Acceso total a los buzones de origen y destino
Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.
Para conceder acceso completo a un buzón, use el cmdlet Add-MailboxPermission y especifique FullAccess en el parámetro AccessRights.
No puede exportar datos de un buzón de un bosque a un buzón de un bosque diferente. Los buzones de origen y de destino deben encontrarse en el mismo bosque.
Puede usar el cmdlet Export-Mailbox par exportar los datos a una carpeta o a un archivo .pst. Los buzones de origen y destino deben estar en uno de los siguientes servidores:
Servidor de Exchange 2007
Servidor de Exchange Server 2003 Service Pack 2 (SP2) (o versiones posteriores)
Servidor de Exchange 2000 Server Service Pack 3 (SP3) (o versiones posteriores)
Para exportar datos desde un archivo .pst deberá ejecutar el cmdlet Export-Mailbox desde un equipo de 32 bits que tenga instalado:
La versión de 32 bits de las herramientas de administración de Exchange
Microsoft Office Outlook 2003 SP2 o una versión posterior
Nota
Los artículos 289999 y 813593 de Microsoft Knowledge Base describen un problema relacionado con el uso de Outlook 2003 para eliminar varios objetos de una carpeta. No se puede usar el cmdlet Export-Mailbox para eliminar más de 4.000 objetos de una carpeta. Para exportar más objetos, se debe usar Outlook 2007.
Para obtener información acerca de la descarga de la versión de 32 bits de las herramientas de administración de Exchange 2007, consulte Microsoft Exchange Server 2007 Management Tools (32-Bit) (página en inglés).
No se pueden exportar datos a un archivo .pst desde un buzón de correo situado en un grupo de almacenamiento de recuperación (RSG).
No se pueden exportar datos desde una base de datos de una carpeta pública.
El cmdlet Export-Mailbox exporta todas las carpetas vacías y las carpetas especiales a la ubicación de destino. Las carpetas especiales son las siguientes:
Bandeja de entrada
Elementos eliminados
Borradores
Correo electrónico no deseado
Bandeja de salida
Elementos enviados
Diario
Calendario
Contactos
Notas
Tareas
El cmdlet Export-Mailbox también exporta los mensajes de la recuperación del elemento eliminado. Estos mensajes se convierten en elementos regulares de la carpeta o archivo .pst a que se exportan los datos.
Si se exportan datos a otro buzón con el parámetro TargetMailbox, el cmdlet Export-Mailbox también exportará mensajes desde el volcado de elementos eliminados. Los mensajes del volcado se convierten a mensajes normales durante la exportación.
Nota
Si usa parámetros de palabras clave, Export-Mailbox exportará en primer lugar todos los mensajes, incluidos los del volcado de archivos y, a continuación, buscará en el buzón de destino los mensajes que cumplan los criterios de palabras clave. Los mensajes que se encontraban en el volcado del buzón de origen se convierten en mensajes normales en el buzón de destino, y también se buscará la presencia de palabras claves en ellos. Export-Mailbox eliminará a continuación los mensajes del buzón de destino que no cumplan con los criterios de contraseña. Si usa también el parámetro DeleteContent, Export-Mailbox suprimirá a continuación los mensajes del buzón de origen que cumplan los criterios de palabras clave.
Para obtener más información acerca de los mensajes de la recuperación del elemento eliminado, consulteCómo recuperar un elemento eliminado.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
El parámetro Identity especifica el buzón desde el que se exporta el contenido. Puede usar los siguientes valores:
Si se envía el objeto comando Get-Mailbox, este parámetro no es necesario. |
PSTFolderPath |
Necesario |
Microsoft.Exchange.Data.LongPath |
El parámetro PSTFolderPath especifica la ruta del archivo .pst al que se exportarán los datos. |
TargetFolder |
Necesario |
System.String |
El parámetro TargetFolder especifica la carpeta del buzón de nivel superior que se creará en el buzón especificado por el parámetro TargetMailbox. Esta carpeta contendrá una subcarpeta denominada Datos recuperados - <alias del buzón de origen> - <marca de tiempo>. La subcarpeta contiene los datos exportados. Si la carpeta de destino que ha especificado ya existe en el buzón de destino, los datos exportados se agregarán a la carpeta existente. Si la carpeta de destino no existe, se creará una. |
TargetMailbox |
Necesario |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
El parámetro TargetMailbox especifica el buzón en el que se creará la carpeta de destino. El buzón que se especifique debe existir para que el comando se complete correctamente. |
AllContentKeywords |
Opcional |
System.String[] |
El parámetro AllContentKeywords especifica las palabras clave del contenido que se incluirán en el movimiento. Si el comando encuentra una palabra clave que ha especificado en el cuerpo del mensaje, el contenido de los datos adjuntos o en el asunto, exportará dichos mensajes. El búfer del parámetro AllContentKeywords es de 32 kilobytes. Nota Este comportamiento es distinto al del uso de los parámetros ContentKeywords y SubjectKeywords. Si usa los parámetros ContentKeywords y SubjectKeywords, el comando sólo exportará los mensajes que tengan la palabra clave especificada para el parámetro ContentKeywords en el cuerpo del mensaje o el contenido de los datos adjunto, y la palabra clave especificada para el parámetro SubjectKeywords en el asunto. |
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. |
AllowMerge |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro AllowMerge especifica que el contenido exportado se combinará en la carpeta de destino para evitar duplicados. Si especifica el parámetro AllowMerge, el nombre de la subcarpeta donde se va a exportar el contenido no incluirá una marca de tiempo y fecha. Se pueden exportar datos a la misma carpeta y subcarpeta de destino varias veces con el parámetro AllowMerge. |
AttachmentFilenames |
Opcional |
System.String[] |
El parámetro AttachmentFilenames especifica el filtro para los datos adjuntos. 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. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm. |
ContentKeywords |
Opcional |
System.String[] |
El parámetro ContentKeywords especifica las palabras clave del contenido que se incluirán en el movimiento. Si el comando encuentra una palabra clave que se especifique en el cuerpo del mensaje o en el contenido de los datos adjuntos, exportará esos mensajes. |
DeleteAssociatedMessages |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro DeleteAssociatedMessages especifica que se eliminarán los mensajes asociados. Los mensajes asociados contienen datos ocultos con información sobre reglas, vistas y formularios. Si usa el parámetro DeleteAssociatedMessages y no especifica TargetMailbox y TargetFolder, o PSTFolderPath, no se exportará ningún contenido. |
DeleteContent |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro DeleteContent especifica la opción que elimina el contenido del buzón de origen después de que éste se haya exportado a una carpeta. La carpeta de origen no se eliminará. |
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 o igual 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. |
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. |
IncludeAssociatedMessages |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro IncludeAssociatedMessages especifica que se incluirán los mensajes asociados en la exportación. Los mensajes asociados contienen datos ocultos con información sobre reglas, vistas y formularios. De forma predeterminada, los mensajes asociados no se incluyen en la exportación. |
IncludeFolders |
Opcional |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
El parámetro IncludeFolders especifica la lista de carpetas que se incluirán durante la exportación. |
Locale |
Opcional |
System.Globalization.CultureInfo |
El parámetro Locale especifica la configuración regional de los mensajes que se van a exportar. Este comando sólo exportará los mensajes con la configuración regional especificada. |
MaxThreads |
Opcional |
System.Int32 |
El parámetro MaxThreads especifica el número máximo de subprocesos que se van a usar. El valor predeterminado es 4. |
RecipientKeywords |
Opcional |
System.String[] |
El parámetro RecipientKeywords especifica las direcciones de correo electrónico de destinatarios o nombres para mostrar. Si el comando encuentra un mensaje con un destinatario que coincide con la palabra clave de destinatario que ha especificado, se exportará el mensaje. Si la palabra clave del destinatario que especifique es la misma que un grupo de distribución que sea destinatario de un mensaje, el mensaje se exportará. El comando no amplía grupos de distribución para comparar las palabras claves de destinatarios especificados con los miembros de un grupo de distribución que sea destinatario de un mensaje. |
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 las direcciones de correo electrónico de remitentes o nombres para mostrar. Si el comando encuentra un mensaje con un remitente que sea el mismo que una palabra clave de remitente especificado, exportará el mensaje. |
StartDate |
Opcional |
System.DateTime |
El parámetro StartDate especifica la fecha de inicio para filtrar contenido que se exportará desde el buzón de origen. Sólo se exportarán elementos del buzón cuya fecha sea posterior a la fecha de inicio. 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. |
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. |
ValidateOnly |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro ValidateOnly proporciona la opción de validar la exportación sin exportar los datos. El parámetro ValidateOnly valida los requisitos previos necesarios para el comando. Nota Si ejecuta el comando Export-Mailbox con este parámetro, el comando no aplicará ningún filtro a los mensajes. Únicamente comprobará si existen los buzones de origen y de destino. |
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, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
Ejemplo
El primer ejemplo muestra cómo exportar el contenido del buzón del usuario john@contoso.com a la carpeta "MyData" del buzón "ExportMailbox".
El segundo ejemplo muestra cómo usar filtros para especificar los elementos del buzón de origen que se incluirán en la exportación. En este ejemplo se exportan todos los elementos del buzón del usuario contoso\john que incluyan la palabra clave "merger" en el cuerpo del mensaje o en el contenido de los datos adjuntos, que tengan algún dato adjunto llamado *orgchart*, y cuya fecha sea posterior al 03/01/2006, 12:01:00 a.m.
El tercer ejemplo muestra cómo buscar y eliminar elementos de un buzón. En este ejemplo se obtienen primero todos los buzones de la base de datos DB1 y se buscan los elementos que contengan "Virus message" en el asunto. Los elementos se exportarán a otro buzón y se eliminarán del buzón de origen.
El cuarto ejemplo muestra cómo se pueden canalizar los resultados del comando Get-User al comando Export-Mailbox. En este ejemplo, además, se excluyen de la exportación dos carpetas. Los elementos de las carpetas Correo electrónico no deseado y Contactos del buzón de John no se exportarán al comando ExportMailbox.
Nota
También se pueden canalizar los resultados de los comandos Get-Recipient o Get-Mailbox al comando Export-Mailbox.
El quinto ejemplo muestra cómo exportar el contenido del buzón del usuario john@contoso.com a un archivo .pst llamado john.pst ubicado en C:\PSTFiles.
El sexto ejemplo muestra cómo exportar datos desde todos los buzones de usuarios en la unidad organizativa Marketing. Los datos de cada buzón se exportarán a un archivo .pst ubicado en C:\PSTFiles. El nombre de cada uno de estos archivos será <alias>.pst. Los mensajes que se exportarán serán aquéllos cuyos destinatarios incluyan a tony@fabrikam.com o christine@fabrikam.com.
Export-Mailbox -Identity john@contoso.com -TargetMailbox ExportMailbox -TargetFolder MyData
Export-Mailbox -Identity contoso\john -TargetMailbox ExportMailbox -TargetFolder MyData -ContentKeywords "merger" -AttachmentFilenames "*orgchart*" -StartDate "03/01/2006 12:01:00"
Get-Mailbox -Database DB1 | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder VirusData -SubjectKeywords "Virus message" -DeleteContent
Get-User john | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder MyData -ExcludeFolders "\Junk E-Mail","\Contacts"
Export-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Get-Mailbox -OrganizationalUnit Marketing | Export-Mailbox -PSTFolderPath C:\PSTFiles -RecipientKeywords "tony@fabrikam.com","christine@fabrikam.com"