Export-Message
Этот командлет доступен только в локальной среде Exchange.
Командлет Export-Message используется для копирования сообщения из очереди на сервере почтовых ящиков или пограничном транспортном сервере по указанному пути файла в организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (по умолчанию)
Export-Message
[-Identity] <MessageIdentity>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Описание
Командлет Export-Message копирует сообщения, находящиеся в очереди доставки, очереди недоступных сообщений или в очереди подозрительных сообщений на сервере почтовых ящиков или пограничном транспортном сервере, в указанную папку. Перед экспортом сообщения сначала необходимо приостановить сообщение. Сообщения в очереди опасных сообщений уже приостановлены. Командлет Export-Message копирует сообщения в каталог преобразования другого сервера почтовых ящиков для доставки.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Export-Message ExchSrv1\contoso.com\1234 | AssembleMessage -Path "c:\exportfolder\filename.eml"
В данном примере отдельное сообщение экспортируется в файл по указанному пути. Так как командлет Export-Message возвращает двоичный объект, необходимо использовать фильтр AssembleMessage, чтобы иметь возможность сохранять содержимое сообщения в указанном местоположении.
Пример 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}
В данном примере запрашиваются все сообщения из указанной очереди. Затем результаты выполнения запроса передаются в команду Export-Message, и все сообщения копируются в отдельные файлы EML. В качестве имен файлов используются идентификаторы сообщений Интернета. Для этого команда выполняет следующие действия.
- Возвращает все сообщения в отдельную очередь с помощью командлета Get-Message.
- Результат поступает к командлету ForEach-Object, который подготавливает имя файла, включающее полный путь, с использованием временной переменной $Temp, состоящей из идентификатора интернет-сообщений и расширения EML. Поле Internet Message ID содержит угловые скобки (
<и>), которые необходимо удалить, так как они являются недопустимыми именами файлов. Удалить скобки можно способом Replace временных переменных. - Командлет ForEach-Object также может экспортировать сообщение с использованием подготовленного имени файла.
Параметры
-Confirm
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Параметр Identity определяет сообщение. Чтобы указать этот параметр, используйте синтаксис Server\Queue\MessageInteger, Queue\MessageInteger или MessageInteger, например Mailbox01\contoso.com\5 или 10. Дополнительные сведения об идентификаторе сообщения см. в разделе Удостоверение сообщения.
Свойства параметра
| Тип: | MessageIdentity |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2010 г., Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.