Import-Mailbox
Se aplica a: Exchange Server 2010
Última modificación del tema: 2009-07-12
Use el cmdlet Import-Mailbox para importar datos de buzón de correo de un archivo .pst a un buzón.
Sintaxis
import-Mailbox [-Identity <MailboxIdParameter>] -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeAssociatedMessages <SwitchParameter>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Parámetros
Parámetro | Necesario | Tipo | Descripción |
---|---|---|---|
PSTFolderPath |
Necesario |
Microsoft.Exchange.Data.LongPath |
El parámetro PSTFolderPath especifica la ruta del archivo .pst desde el que se importarán los datos. |
AllContentKeywords |
Opcional |
System.String[] |
El parámetro AllContentKeywords especifica las palabras clave del contenido que se incluirán en la importación. Si el comando encuentra una palabra clave especificada en el cuerpo del mensaje, el contenido de los datos adjuntos o el asunto, importa dichos mensajes.
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 solo importa los mensajes que tengan la palabra clave especificada para el parámetro ContentKeywords en el cuerpo del mensaje o el contenido de los datos adjuntos, y la palabra clave especificada para el parámetro SubjectKeywords en el asunto.
|
AllowDuplicates |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro AllowDuplicates especifica si se copian los elementos de correo sin comprobar si son duplicados de elementos existentes. Se recomienda usar el parámetro AllowDuplicates con el parámetro IncludeFolders. |
AttachmentFilenames |
Opcional |
System.String[] |
El parámetro AttachmentFilenames especifica el filtro para los datos adjuntos. Puede usar caracteres comodín en la cadena. Por ejemplo, puede usar *.txt" para importar 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 archivo .pst que se omiten antes de que se produzca un error en la operación de importación. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El modificador Confirm se puede usar para suprimir la pregunta de confirmación que aparece de forma predeterminada cuando se ejecuta este cmdlet. Para quitar la pregunta de confirmación, utilice la sintaxis |
ContentKeywords |
Opcional |
System.String[] |
El parámetro ContentKeywords especifica las palabras clave del contenido que se incluirán en la importación. Si el comando encuentra una palabra clave especificada en el cuerpo del mensaje o el contenido de los datos adjuntos, importa esos mensajes. |
EndDate |
Opcional |
System.DateTime |
El parámetro EndDate especifica la fecha de finalización para filtrar el contenido importado al buzón de destino. Solo se importan los elementos del archivo .pst cuya fecha sea anterior o idéntica a la fecha de finalización. 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 dd/mm/aaaa, escriba 01/03/2010 para especificar el 1 de marzo de 2010. |
ExcludeFolders |
Opcional |
Microsoft.Exchange.Data.MapiFolderPath[] |
El parámetro ExcludeFolders especifica la lista de carpetas que se excluirán durante la importació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. |
Identity |
Opcional |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
El parámetro Identity especifica el objeto de buzón de destino al que se desea importar los datos. Puede usar uno de los siguientes valores:
Si se envía el objeto comando Get-Mailbox, este parámetro no es necesario. |
IncludeAssociatedMessages |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro IncludeAssociatedMessages especifica que los mensajes asociados se incluyen en la importación. Los mensajes asociados contienen datos ocultos con información sobre reglas, vistas y formularios. De forma predeterminada, no se incluyen los mensajes asociados en una importación. |
IncludeFolders |
Opcional |
Microsoft.Exchange.Data.MapiFolderPath[] |
El parámetro IncludeFolders especifica la lista de carpetas que se incluirán durante la importación. Al usar este parámetro, solamente las carpetas contenidas en la lista de parámetros se incluyen en la importación. |
Locale |
Opcional |
System.Globalization.CultureInfo |
El parámetro Locale especifica la configuración regional de los mensajes que se van a importar. Este comando solo importa 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 palabras clave del contenido que se incluirán en la importación. Si el comando encuentra una palabra clave especificada en la lista de destinatarios, importa esos mensajes. |
SenderKeywords |
Opcional |
System.String[] |
El parámetro SenderKeywords especifica las palabras clave del contenido que se incluirán en la importación. Si el comando encuentra una palabra clave especificada en el remitente, importa esos mensajes. |
StartDate |
Opcional |
System.DateTime |
El parámetro StartDate especifica la fecha de inicio para filtrar el contenido importado al buzón de destino. Sólo se importan los elementos del archivo .pst 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 dd/mm/aaaa, escriba 01/03/2010 para especificar el 1 de marzo de 2010. |
SubjectKeywords |
Opcional |
System.String[] |
El parámetro SubjectKeywords especifica los filtros de palabras clave que se aplican a los asuntos de elementos del archivo .pst. |
ValidateOnly |
Opcional |
System.Management.Automation.SwitchParameter |
El modificador de ValidateOnly indica al cmdlet que debe evaluar las condiciones y los requisitos necesarios para realizar la operación e informa si la operación se realizará correctamente o producirá un error. No se realizan cambios cuando se usa el modificador ValidateOnly.
Nota:
Si ejecuta el comando Import-Mailbox con este parámetro, el comando no aplica ningún filtro a los mensajes. Únicamente comprueba si existen los buzones de origen y de destino.
|
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
El modificador WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del modificador WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el modificador WhatIf. |
Descripción detallada
Para importar datos desde un archivo.pst, deberá ejecutar el cmdlet Import-Mailbox en un equipo que ejecute Microsoft Exchange Server 2010 y que tenga instalada la versión de 64 bits de Microsoft Outlook 2010. Recomendamos que ejecute el comando en un servidor Exchange concreto que no tenga buzones.
Solamente puede importar datos de un archivo .pst a un buzón que se encuentre en un servidor Exchange 2010 que tenga instalado el rol de servidor Buzones de correo mediante el cmdlet Import-Mailbox. Para importar datos de un archivo .pst a un buzón en un servidor Exchange Server 2007, utilice la versión de Exchange 2007 del cmdlet Import-Mailbox. Para importar datos de un archivo .pst a un buzón de un servidor Exchange Server 2003, debe usar el Asistente para combinar buzones de Microsoft Exchange (ExMerge.exe).
No puede importar datos mediante el cmdlet Import-Mailbox de un archivo .pst a un buzón que se encuentre en una base de datos de recuperación.
No puede importar datos mediante el cmdlet Import-Mailbox a una base de datos de carpetas públicas.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque todos los parámetros correspondientes a este cmdlet se describen en este tema, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para ver qué permisos necesita, consulte el Entrada "Buzón de importación/exportación" en el tema Permisos de buzones.
Tipos de entrada
Tipos de valores devueltos
Errores
Error | Descripción |
---|---|
|
Ejemplos
EJEMPLO 1
En este ejemplo, se importan los datos del archivo C:\PSTFiles\jesus.pst al buzón conectado existente de jesus@contoso.com.
Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
EJEMPLO 2
En este ejemplo, se importan los datos de todos los archivos .pst ubicados en C:\PSTFiles a buzones existentes. Los archivos .pst deben tener el nombre <alias>.pst, donde alias es el alias del buzón al que se importan los datos. Para cada archivo .pst, solo se importan al buzón los mensajes recibidos después del 01/01/2010.
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2010
EJEMPLO 3
En este ejemplo, se importan los datos de archivos .pst a buzones cuyos usuarios estén en la unidad organizativa Marketing. Los archivos .pst deben tener el nombre <alias>.pst, donde alias es el alias del buzón al que se importan los datos. Solo se importan los archivos .pst cuyos alias correspondan a un usuario de la unidad organizativa Marketing. Si no hay ningún archivo .pst en C:\PSTFiles para un usuario de la unidad organizativa Marketing, recibirá un error.
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles