• Estimated time to complete each procedure: 15 minutes
  
  
• You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Queues" entry in Mail Flow Permissions topic.
  
  
• The messages must be in a Suspended state for the export process to be successful. You can export messages from delivery queues, the Unreachable queue, or the poison message queue. Messages in the poison message queue are already in the Suspended state. You can't suspend or export messages that are in the Submission queue.
  
  
• You can't use Queue Viewer in the Exchange Toolbox to export messages. However, you can use Queue Viewer to locate, identify, and suspend the messages before you export them using the Shell.
  
  
• Verify the following information about the target directory location for the message files:
  
  
  • The target directory must exist before you export any messages. The directory won't be created for you. If an absolute path isn't specified, the current Exchange Management Shell working directory is used.
    
    
  • The path may be local to the Exchange server, or it may be a Universal Naming Convention (UNC) path to a share on a remote server.
    
    
  • Your account must have the Write permission to the target directory.
    
    
  • When you specify a file name for the exported messages, be sure to include the .eml file name extension so the files can be opened easily by email client applications or processed correctly by the Replay directory.
    
    
• For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard Shortcuts in the Exchange Admin Center.
  
  

Tip:
Having problems? Ask for help in the Exchange forums. Visit the forums at: Exchange Server, Exchange Online, or Exchange Online Protection

Use the Shell to export a specific message from a specific queue

To export a specific message from a specific queue, run the following command:

	Copy Code
Export-Message -Identity <MessageIdentity> | AssembleMessage -Path <FilePath>

This example exports a copy of a message that has the InternalMessageID value 1234 that's located in the contoso.com delivery queue on the server named Mailbox01 to the file named export.eml in the path D:\Contoso Export.

	Copy Code
Export-Message -Identity Exchange01\Contoso.com\1234 -Path "D:\Contoso Export\export.eml"

Use the Shell to export all messages from a specific queue

To export all messages from a specific queue and use the InternetMessageID value of each message as the file name, use the following syntax.

	Copy Code
Get-Message -Queue <QueueIdentity> | ForEach-Object {$Temp=<Path>+$_.InternetMessageID+".eml";$Temp=$Temp.Replace("<","_");$Temp=$Temp.Replace(">","_");Export-Message $_.Identity | AssembleMessage -Path $Temp}

Note that the InternetMessageID value contains angled brackets (> and <), which need to be removed because they aren't allowed in file names.

This example exports a copy of all the messages from the contoso.com delivery queue on the server named Mailbox01 to the local directory named D:\Contoso Export.

	Copy Code
Get-Message -Queue Mailbox01\Contoso.com | ForEach-Object {$Temp="D:\Contoso Export\"+$_.InternetMessageID+".eml";$Temp=$Temp.Replace("<","_");$Temp=$Temp.Replace(">","_");Export-Message $_.Identity | AssembleMessage -Path $Temp}

Use the Shell to export specific messages from all the queues on a server

To export specific messages from all queues on a server and use the InternetMessageID value of each message as the file name, use the following syntax.

	Copy Code
Get-Message -Filter {<MessageFilter>} [-Server <ServerIdentity>] | ForEach-Object {$Temp=<Path>+$_.InternetMessageID+".eml";$Temp=$Temp.Replace("<","_");$Temp=$Temp.Replace(">","_");Export-Message $_.Identity | AssembleMessage -Path $Temp}

Note that the InternetMessageID value contains angled brackets (> and <), which need to be removed because they aren't allowed in file names.

This example exports a copy of all the messages from senders in the contoso.com domain from all queues on the server named Mailbox01 to the local directory named D:\Contoso Export.

	Copy Code
Get-Message -Filter {FromAddress -like "@Contoso.com"} -Server Mailbox01 | ForEach-Object {$Temp="D:\Contoso Export\"+$_.InternetMessageID+".eml";$Temp=$Temp.Replace("<","_");$Temp=$Temp.Replace(">","_");Export-Message $_.Identity | AssembleMessage -Path $Temp}

Note:
If you omit the Server parameter, the command operates on the local server.