Export-Mailbox (RTM)
Se aplica a: Exchange Server 2007
Última modificación del tema: 2007-06-05
Utilice el cmdlet Export-Mailbox para mover el contenido de un buzón a una carpeta de buzón especificada.
Sintaxis
export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-DeleteContent <SwitchParameter>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]
Descripción detallada
Para ejecutar el cmdlet Export-Mailbox, deberá delegar a la cuenta que utilice los elementos siguientes:
- Función de administrador de servidores de Exchange y grupo Administradores local para el servidor 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.
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.
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
Contacts
Notas
Tareas
El cmdlet Export-Mailbox también exporta los mensajes de la recuperación del elemento eliminado. Para obtener más información acerca de los mensajes de la recuperación del elemento eliminado, consulteCómo recuperar un elemento eliminado (en inglés).
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 utilizar los siguientes valores:
Si se envía el objeto comando Get-Mailbox, este parámetro no es necesario. |
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 lleve a cabo 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 se especifique en el cuerpo del mensaje, el contenido de los datos adjuntos, o el asunto, exportará esos mensajes. Nota Este comportamiento es distinto al del uso de los parámetros ContentKeywords y SubjectKeywords. Si utiliza 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. |
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. |
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. |
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, 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. |
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. |
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 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 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, 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. |
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 indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro ValidateOnly, el administrador puede ver los cambios que se producirían sin tener que aplicarlos. 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. |
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 utilizar 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.
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"