Export-QuarantineMessage

此 cmdlet 仅在基于云的服务中可用。

使用 Export-QuarantineMessage cmdlet 从基于云的组织导出隔离的邮件和文件。 邮件将导出到 .eml 邮件文件,以便你可以在 Outlook 中打开它们。

对于 SharePoint、OneDrive 和 Microsoft Teams 安全附件隔离的文件,这些文件以 Base64 格式导出。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

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>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 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 值命名。 文件夹包含以 Identity 中的第二个 GUID 值命名的 .eml 邮件。

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

Identities 参数标识批量操作的隔离邮件。 使用语法标识消息: value1,value2...valueN。 每个值都是格式的唯一隔离邮件标识符 GUID1\GUID2 , (例如 c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7) 。

可以使用 Get-QuarantineMessage cmdlet 查找已隔离邮件的 Identity 值。

使用此参数时,需要 Identity 参数,但忽略该值。 例如,对 Identity 参数使用值 000。

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) 。

可以使用 Get-QuarantineMessage cmdlet 查找已隔离邮件的 Identity 值。

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