Export-Message

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet solo está disponible en el entorno local de Exchange.

Use el cmdlet Export-Message para copiar un mensaje de una cola de un servidor de buzones o un servidor de transporte perimetral a una ruta de archivo especificada en la organización.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Export-Message
      [-Identity] <MessageIdentity>
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Description

El cmdlet Export-Message copia en una ruta de archivo especificada los mensajes de la cola de entrega, la cola inaccesible o la cola de mensajes dudosos en un servidor de buzones o de transporte perimetral. Antes de exportar un mensaje, es necesario suspenderlo. Los mensajes de la cola de mensajes dañados ya están suspendidos. Se puede usar el cmdlet Export-Message para copiar mensajes al directorio de reproducción de otro servidor de buzones para su entrega.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Export-Message ExchSrv1\contoso.com\1234 | AssembleMessage -Path "c:\exportfolder\filename.eml"

En este ejemplo se exporta un único mensaje a la ruta de acceso del archivo especificado. Debido a que el cmdlet Export-Message devuelve un objeto binario, debe usar el filtro AssembleMessage para poder guardar el contenido de los mensajes en una ubicación especificada.

Ejemplo 2

Get-Message -Queue "Server1\contoso.com" -ResultSize Unlimited | ForEach-Object {Suspend-Message $_.Identity -Confirm:$False

$Temp="C:\ExportFolder\"+$_.InternetMessageID+".eml"

$Temp=$Temp.Replace("<","_")

$Temp=$Temp.Replace(">","_")

Export-Message $_.Identity | AssembleMessage -Path $Temp}

En este ejemplo se recupera todos los mensajes de la cola especificada. A continuación, se canalizan los resultados de consulta al comando Export-Message y todos los mensajes se copian a archivos .eml individuales. Los identificadores de mensaje de Internet de cada mensaje se usan como los nombres de archivo. Para realizar esto, el comando hace lo siguiente:

Recupera todos los mensajes en una cola específica utilizando el cmdlet Get-Message.
El resultado se canaliza hacia el cmdlet ForEach-Object, que prepara un nombre de archivo que incluye la ruta completa usando la variable temporal $Temp que consiste en el identificador de mensaje de Internet con la extensión .eml. El campo Internet Message ID contiene corchetes angulares (< y >) que deben quitarse, ya que son nombres de archivo no válidos. Esto se realiza con el método Replace de la variable temporal.
El cmdlet ForEach-Object también exporta el mensaje con el nombre de archivo preparado.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

El parámetro Identity especifica el mensaje. La entrada válida para este parámetro debe usar la sintaxis Server\Queue\MessageInteger, Queue\MessageInteger o MessageInteger, por ejemplo, Mailbox01\contoso.com\5 o 10. Para obtener más información sobre la identidad del mensaje, consulte Identidad del mensaje.

Type:	MessageIdentity
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.

Compartir a través de