Export-QuarantineMessage
此指令程式只能在雲端式服務中使用。
使用 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 |