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 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EntityType
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр EntityType фильтрует результаты по EntityType. Допустимые значения:
- Электронная почта
- SharePoint Online
- Teams (в настоящее время в предварительной версии)
- DataLossPrevention
Свойства параметров
| Тип: | Microsoft.Exchange.Management.FfoQuarantine.EntityType |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ForceConversionToMime
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Ключ ForceConversionToMime преобразует экспортированные сообщения в формате MIME. С этим параметром не нужно указывать значение.
Этот ключ не действует, если сообщение уже закодировано как Base64.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identities
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Identities определяет сообщения, помещенные в карантин, для массовых операций. Вы идентифицируете сообщения с помощью следующего синтаксиса: value1,value2...valueN. Каждое значение является уникальным идентификатором сообщения, помещенного в карантин, в формате GUID1\GUID2 (например c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).
Значение Identity для сообщения в карантине можно найти с помощью командлета Get-QuarantineMessage.
При использовании этого параметра параметр Identity является обязательным, но значение игнорируется. Например, используйте значение 000 в качестве параметра Identity.
Свойства параметров
| Тип: | QuarantineMessageIdentity[] |
| Значение по умолчанию: | 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 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identities
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
IdentityOnly
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Password
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Пароль указывает пароль, необходимый для открытия экспортируемого сообщения.
В качестве значения для этого параметра можно использовать следующие методы:
-
(ConvertTo-SecureString -String '<password>' -AsPlainText -Force). - Прежде чем выполнить эту команду,
$password = Read-Host "Enter password" -AsSecureStringсохраните пароль в виде переменной (например ), а затем используйте переменную ($password) в качестве значения. -
(Get-Credential).passwordдля получения запроса на безопасный ввод пароля при выполнении этой команды.
Чтобы ввести пароль в виде обычного текста, используйте параметр PasswordV2.
Свойства параметров
| Тип: | SecureString |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PasswordV2
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр PasswordV2 определяет текстовое значение пароля, необходимого для открытия экспортируемого сообщения. Заключайте значение в кавычки (например, '<password>').
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ReasonForExport
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр ReasonForExport указывает, почему сообщение было экспортировано. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RecipientAddress
Применимо: Exchange Online, безопасность & соответствие требованиям, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр RecipientAddress фильтрует результаты по адресу электронной почты получателя. Вы можете указать несколько значений, разделив их запятыми.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | 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.