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 |