Export-Message
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-06-28
Utilice el cmdlet Export-Message para copiar un mensaje desde una cola de un equipo que tenga instalada la función del servidor Concentrador de transporte o transporte perimetral a una ruta de archivo especificada de una organización de Microsoft Exchange Server 2007.
Sintaxis
Export-Message -Identity <MessageIdentity> -Path <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El cmdlet Export-Message copia en una ruta de archivo especificada mensajes de una cola de entrega, la cola Inaccesible, o la cola de mensajes dañados en un servidor de concentrador de transporte o perimetral. Antes de exportar un mensaje, es necesario suspenderlo. Los mensajes de la cola de mensajes dañados ya están suspendidos. Se puede utilizar el comando Export-Message para copiar mensajes al directorio de reproducción de otro servidor de transporte para la entrega. Para copiar un mensaje ubicado en un servidor remoto, es necesario incluir el nombre de servidor como parte de la identidad de mensaje. La identidad es obligatoria y debe identificar de un modo único a un mensaje de una cola.
Para ejecutar el cmdlet Export-Message, la cuenta que utilice debe tener delegados los siguiente elementos:
- Función de administrador de servidores de Exchange y grupo local Administradores para el servidor de destino
Para ejecutar el cmdlet Export-Message en un equipo que tenga instalada la función del servidor Transporte perimetral, debe iniciar sesión mediante una cuenta que sea miembro del grupo Administradores local en dicho equipo.
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.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
El parámetro Identity sirve para especificar el valor entero MessageIdentity. Éste es un valor entero que representa un determinado mensaje y una identidad de servidor y cola opcionales. La sintaxis para este parámetro es la siguiente:
|
Path |
Necesario |
System.String |
El parámetro Path se utiliza para especificar la ruta del archivo al que se exporta el mensaje. El valor del parámetro Path puede ser un nombre de archivo, un directorio y un nombre de archivo, o sólo un directorio. El directorio de destino debe existir antes de exportar mensajes. El directorio no se creará automáticamente. Si no se especifica una ruta absoluta, se utilizará el directorio de trabajo actual del Shell de administración de Exchange. Los directorios utilizados en el parámetro Path pueden ser locales para el equipo de Exchange 2007, o bien una ruta que cumpla la Convención de nomenclatura universal (UNC) y que permita compartirlos en un servidor remoto. Si especifica un directorio existente pero no el nombre de archivo en el valor del parámetro Path, los nombres de mensaje se definirán automáticamente como InternalMessageID.eml. El InternalMessageID es un identificador de mensaje asignado por el servidor de Exchange 2007 en el que se está procesando actualmente el mensaje. La cuenta debe tener permiso de escritura en el directorio de destino. |
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. |
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
En los siguientes ejemplos se muestra cómo exportar mensajes desde una cola a un archivo. En el primer ejemplo se muestra cómo exportar un solo mensaje a la ruta de archivo especificada.
En el segundo ejemplo se muestra cómo se utiliza el comando Get-Message para recuperar todos los mensajes de una cola especificada. Luego los resultados de la consulta se canalizan al comando Export-Message y todos los mensajes se copian a archivos .eml cuyos nombres están basados en InternalMessageID.
Para obtener más información acerca de cómo usar el Shell de administración de Exchange para realizar tareas de visor de cola, consulte Utilización de Shell de administración de Exchange para administrar colas (en inglés).
Export-Message -Identity ExchSrv1\contoso.com\1234 -Path "c:\exportfolder\filename.eml"
Get-Message -Queue "Server1\contoso.com" | Export-Message -Path "c:\exportfolder"