Export-QuarantineMessage
Этот командлет доступен только в облачной службе.
Используйте командлет Export-QuarantineMessage для экспорта сообщений и файлов, помещенных в карантин, из облачной организации. Сообщения экспортируются в файлы сообщений .eml, поэтому их можно открыть в Outlook.
Для файлов, помещенных в карантин безопасными вложениями для SharePoint, OneDrive и Microsoft Teams, файлы экспортируются в формате Base64.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Identities
Export-QuarantineMessage
-Identities <QuarantineMessageIdentity[]>
[-Identity <QuarantineMessageIdentity>]
[-CompressOutput]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-ForceConversionToMime]
[-Password <SecureString>]
[-PasswordV2 <String>]
[-ReasonForExport <String>]
[-RecipientAddress <String>]
[<CommonParameters>]
IdentityOnly
Export-QuarantineMessage
-Identity <QuarantineMessageIdentity>
[-CompressOutput]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-ForceConversionToMime]
[-Password <SecureString>]
[-PasswordV2 <String>]
[-ReasonForExport <String>]
[-RecipientAddress <String>]
[<CommonParameters>]
Описание
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
$e = Export-QuarantineMessage -Identity b28e0706-e50e-4c33-17e8-08daf2898d15\e939baaf-9dac-6126-2137-b82abf373159
$txt = [System.Text.Encoding]::Ascii.GetString([System.Convert]::FromBase64String($e.eml))
[IO.File]::WriteAllText("C:\My Documents\Quarantined Message.eml", $txt)
В этом примере экспортировано указанное сообщение, которое было помещено в карантин как спам:
- Первая команда экспортирует сообщение в карантине в переменную
$e. Сообщение хранится в свойстве Eml ($e.emlзначение) как Base64 (на$e.BodyEncodingоснове значения). - Вторая команда преобразует свойство Eml из Base64 в текст ASCII и сохраняет результат в переменной
$txt. - Третья команда записывает сообщение, помещенное в карантин, в указанный файл .eml.
Примечание. Не заключайте значение Identity в кавычки (может возникнуть ошибка).
Пример 2
$f = Export-QuarantineMessage -Identity 9c6bb3e8-db9e-4823-9759-08d594179bd3\7fec89fe-41b0-ae67-4887-5bede017d111
$bytes = [Convert]::FromBase64String($f.eml)
[IO.File]::WriteAllBytes("C:\My Documents\Quarantined Message with Attachments.eml", $bytes)
В этом примере экспортируются указанное сообщение с вложениями, которые были помещены в карантин как вредоносные программы:
- Первая команда экспортирует помещенное в карантин сообщение и вложения в переменную
$f. Сообщение и вложения хранятся в свойстве Eml ($f.emlзначение) как Base64 (на$f.BodyEncodingоснове значения). - Вторая команда преобразует свойство Eml из Base64 в байты и сохраняет результат в переменной
$bytes. - Третья команда записывает сообщение и вложения в указанный .eml файл.
Параметры
-CompressOutput
Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр CompressOutput экспортирует сообщение в виде сжатого .zip файла. С этим параметром не нужно указывать значение.
Для экспортированных сообщений, включая сообщения с вложениями, файл .zip содержит папку с именем в честь первого значения GUID в идентификаторе. Папка содержит сообщение .eml, которое называется в честь второго значения GUID в идентификаторе.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EntityType
Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр EntityType фильтрует результаты по EntityType. Допустимые значения:
- Электронная почта
- SharePointOnline
- Teams (в настоящее время находится в предварительной версии)
- DataLossPrevention
Свойства параметров
| Тип: | Microsoft.Exchange.Management.FfoQuarantine.EntityType |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ForceConversionToMime
Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр ForceConversionToMime преобразует экспортированные текстовые сообщения в формат MIME. С этим параметром не нужно указывать значение.
Этот параметр не действует, если сообщение уже закодировано как Base64.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identities
Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Удостоверения определяет сообщения, помещенные в карантин для массовых операций. Вы идентифицируете сообщения с помощью синтаксиса: value1,value2...valueN. Каждое значение является уникальным идентификатором сообщения в карантине в формате GUID1\GUID2 (например c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).
Значение Identity для сообщения в карантине можно найти с помощью командлета Get-QuarantineMessage.
При использовании этого параметра параметр Identity является обязательным, но значение игнорируется. Например, используйте значение 000 для параметра Identity.
Свойства параметров
| Тип: | QuarantineMessageIdentity[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identities
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Identity указывает сообщение в карантине, которое необходимо экспортировать. Значение является уникальным идентификатором сообщения в карантине в формате GUID1\GUID2 (например c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).
Значение Identity для сообщения в карантине можно найти с помощью командлета Get-QuarantineMessage.
Свойства параметров
| Тип: | QuarantineMessageIdentity |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identities
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
IdentityOnly
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Password
Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Password указывает пароль, необходимый для открытия экспортированного сообщения.
В качестве значения для этого параметра можно использовать следующие методы:
-
(ConvertTo-SecureString -String '<password>' -AsPlainText -Force). - Перед выполнением этой команды сохраните пароль как переменную (например,
$password = Read-Host "Enter password" -AsSecureString), а затем используйте переменную ($password) в качестве значения. -
(Get-Credential).passwordзапрос на безопасный ввод пароля при выполнении этой команды.
Чтобы ввести пароль в виде обычного текста, используйте параметр PasswordV2.
Свойства параметров
| Тип: | SecureString |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PasswordV2
Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр PasswordV2 указывает текстовое значение пароля, необходимого для открытия экспортированного сообщения. Заключите значение в кавычки (например, '<password>').
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ReasonForExport
Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр ReasonForExport указывает, почему было экспортировано сообщение. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RecipientAddress
Применимо: Exchange Online, соответствие требованиям безопасности &, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр RecipientAddress фильтрует результаты по адресу электронной почты получателя. Вы можете указать несколько значений, разделив их запятыми.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.