Export-QuarantineMessage

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Online, Security & Compliance, Exchange Online Protection

Этот командлет доступен только в облачной службе.

Используйте командлет Export-QuarantineMessage для экспорта сообщений и файлов, помещенных в карантин, из облачной организации. Сообщения экспортируются в EML-файлы сообщений, поэтому их можно открыть в Outlook.

Для файлов, помещенных в карантин безопасными вложениями для SharePoint, OneDrive и Microsoft Teams, файлы экспортируются в формате Base64.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Export-QuarantineMessage
      -Identities <QuarantineMessageIdentity[]>
      [-Identity <QuarantineMessageIdentity>]
      [-CompressOutput]
      [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
      [-ForceConversionToMime]
      [-Password <SecureString>]
      [-ReasonForExport <String>]
      [-RecipientAddress <String>]
      [<CommonParameters>]

Export-QuarantineMessage
      -Identity <QuarantineMessageIdentity>
      [-CompressOutput]
      [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
      [-ForceConversionToMime]
      [-Password <SecureString>]
      [-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

Параметр CompressOutput экспортирует сообщение в виде сжатого .zip файла. Для этого переключателя не требуется указывать значение.

Для экспортированных сообщений, включая сообщения с вложениями, файл .zip содержит папку с именем в честь первого значения GUID в идентификаторе. Папка содержит eml-сообщение, которое называется в честь второго значения GUID в идентификаторе.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance, Exchange Online Protection

-EntityType

Параметр EntityType фильтрует результаты по EntityType. Допустимые значения:

Электронная почта
SharePointOnline
Teams (в настоящее время находится в предварительной версии)

Type:	Microsoft.Exchange.Management.FfoQuarantine.EntityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ForceConversionToMime

Параметр ForceConversionToMime преобразует экспортированные текстовые сообщения в формат MIME. Указывать значение для этого параметра необязательно.

Этот параметр не действует, если сообщение уже закодировано как Base64.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Identities

Параметр Удостоверения определяет сообщения, помещенные в карантин для массовых операций. Вы идентифицируете сообщения с помощью синтаксиса: value1,value2...valueN. Каждое значение является уникальным идентификатором сообщения в карантине в формате GUID1\GUID2 (например c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).

Значение Identity для сообщения в карантине можно найти с помощью командлета Get-QuarantineMessage.

При использовании этого параметра параметр Identity является обязательным, но значение игнорируется. Например, используйте значение 000 для параметра Identity.

Type:	QuarantineMessageIdentity[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Identity

Параметр Identity указывает сообщение в карантине, которое необходимо экспортировать. Значение является уникальным идентификатором сообщения в карантине в формате GUID1\GUID2 (например c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7, ).

Значение Identity для сообщения в карантине можно найти с помощью командлета Get-QuarantineMessage.

Type:	QuarantineMessageIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-Password

Параметр Password указывает пароль, необходимый для открытия экспортированного сообщения.

В качестве значения для этого параметра можно использовать следующие методы:

(ConvertTo-SecureString -String '<password>' -AsPlainText -Force).
Перед выполнением этой команды сохраните пароль как переменную (например, $password = Read-Host "Enter password" -AsSecureString), а затем используйте переменную ($password) в качестве значения.
(Get-Credential).password запрос на безопасный ввод пароля при выполнении этой команды.

Type:	SecureString
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-ReasonForExport

Параметр ReasonForExport указывает, почему было экспортировано сообщение. Если значение содержит пробелы, его необходимо заключить в кавычки (").

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection

-RecipientAddress

Параметр RecipientAddress фильтрует результаты по адресу электронной почты получателя. Вы можете указать несколько значений, разделив их запятыми.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Security & Compliance, Exchange Online Protection