Export-QuarantineMessage

參考

模組:: ExchangePowerShell

適用於:: Exchange Online, Security & Compliance, Exchange Online Protection

此指令程式只能在雲端式服務中使用。

使用 Export-QuarantineMessage Cmdlet 從雲端式組織匯出隔離的郵件和檔案。訊息會匯出至 .eml 訊息檔案，讓您可以在 Outlook 中開啟它們。

對於由 SharePoint、OneDrive 和 Microsoft Teams 安全附件隔離的檔案，檔案會以 Base64 格式匯出。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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

Description

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 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 根據 $e.BodyEncoding) 值，將值) 為 Base64 (。
第二個命令會將 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 根據 $f.BodyEncoding) 值，將值) 為 Base64 (。
第二個命令會將 Eml 屬性從 Base64 轉換成位元組，並將結果儲存在變數 $bytes 中。
第三個命令會將隔離的訊息和附件寫入指定的 .eml 檔案。

參數

-CompressOutput

CompressOutput 參數會將訊息匯出為壓縮.zip檔。您不需要使用此參數指定值。

對於匯出的訊息，包括附件的訊息，.zip檔案包含以 Identity 中第一個 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

身分識別參數會識別大量作業的隔離訊息。您可以使用下列語法來識別訊息： 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