Import-Mailbox
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2011-06-21
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>] [-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 Import-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 completo al buzón de 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.
Para importar datos de un archivo .pst, debe ejecutar el cmdlet Import-Mailbox desde un equipo de 32 bits que tenga instalado lo siguiente:
Versión de 32 bits de las herramientas de administración de Exchange
Microsoft Office Outlook 2003 Service Pack 2 (SP2) o versiones posteriores
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 Herramientas de administración de Microsoft Exchange Server 2007 (32 bits) (en inglés).
Puede usar el cmdlet Import-Mailbox para importar datos a una carpeta o a un archivo .pst. Los buzones de correo origen y destino se deben hallar en un equipo que ejecute una de las siguientes versiones de Exchange:
Exchange Server 2007
Exchange Server 2003 Service Pack 2 (SP2) o versiones posteriores
Exchange 2000 Server Service Pack 3 (SP3) o versiones posteriores
Para importar datos de un archivo .pst en un buzón de correo de otra versión de Exchange, debe usar el Asistente para combinar buzones de Microsoft Exchange Server (ExMerge.exe).
No puede importar datos mediante el cmdlet Import-Mailbox desde un archivo .pst en un buzón de correo que se encuentre en un grupo de almacenamiento de recuperación (RSG).
No puede importar datos mediante el cmdlet Import-Mailbox en una base de datos de carpetas públicas.
Nota
No es necesario configurar un perfil MAPI cuando se usa el cmdlet Import-Mailbox.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
PSTFolderPath |
Necesario |
Microsoft.Exchange.Data.LongPath |
El parámetro PSTFolderPath especifica la ruta de acceso del archivo .pst desde donde 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 que se especifique en el cuerpo del mensaje, el contenido de los datos adjuntos, o el asunto, importará esos 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 sólo importará los mensajes que tengan tanto la palabra clave especificada para el parámetro ContentKeywords en el cuerpo del mensaje o el contenido de los datos adjuntos, como 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. |
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 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 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 la importación. Si el comando encuentra una palabra clave que se especifique en el cuerpo del mensaje o en el contenido de los datos adjuntos, importará esos mensajes. |
EndDate |
Opcional |
System.DateTime |
El parámetro EndDate especifica la fecha final para filtrar contenido que se importará al buzón de destino. Sólo se importarán los elementos del archivo .pst cuya fecha sea anterior o idéntica 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 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. |
IncludeFolders |
Opcional |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
El parámetro IncludeFolders especifica la lista de carpetas que se incluirán durante 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 sólo importará 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 que se especifique en la lista de destinatarios, importará esos mensajes. |
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 palabras clave del contenido que se incluirán en la importación. Si el comando encuentra una palabra clave que se especifique en el remitente, importará esos mensajes. |
StartDate |
Opcional |
System.DateTime |
El parámetro StartDate especifica la fecha inicial para filtrar contenido que se importará al buzón de destino. Sólo se importarán 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 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 archivo .pst. |
ValidateOnly |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro ValidateOnly proporciona la opción de validar la importación sin importar los datos. El parámetro ValidateOnly valida los requisitos previos necesarios para el comando. Nota Si ejecuta el comando Import-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 |
|---|---|
|
Ejemplo
En el primer ejemplo se muestra cómo importar los datos del archivo C:\PSTFiles\john.pst al buzón conectado existente de john@contoso.com.
En el segundo ejemplo se muestra cómo importar los datos de todos los archivos .pst que se encuentran 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 importarán los datos. Para cada archivo .pst, sólo se importarán en el buzón los mensajes recibidos después del 01/01/2007.
En el tercer ejemplo se muestra cómo importar datos de archivos .pst a buzones cuyos usuarios estén en la unidad organizativa de Marketing. Los archivos .pst deben tener el nombre <alias>.pst, donde alias es el alias del buzón al que se importarán los datos. Sólo se importarán los archivos .pst cuyos alias correspondan a un usuario de la unidad organizativa de Marketing. Si no hay ningún archivo .pst en C:\PSTFiles para un usuario de la unidad organizativa de Marketing, se obtendrá un error.
Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2007
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles