Export-QuarantineMessage
此指令程式只能在雲端式服務中使用。
使用 Export-QuarantineMessage 指令碼來匯出雲端組織中隔離的訊息和檔案。 訊息會匯出到.eml訊息檔案，讓你能在 Outlook 中打開。
對於被 SharePoint、OneDrive 和 Microsoft Teams 安全附件隔離的檔案，檔案會匯出為 Base64 格式。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Identities
Export-QuarantineMessage
-Identities <QuarantineMessageIdentity[]>
[-Identity <QuarantineMessageIdentity>]
[-CompressOutput]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-ForceConversionToMime]
[-Password <SecureString>]
[-PasswordV2 <String>]
[-ReasonForExport <String>]
[-RecipientAddress <String>]
[<CommonParameters>]
IdentityOnly
Export-QuarantineMessage
-Identity <QuarantineMessageIdentity>
[-CompressOutput]
[-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
[-ForceConversionToMime]
[-Password <SecureString>]
[-PasswordV2 <String>]
[-ReasonForExport <String>]
[-RecipientAddress <String>]
[<CommonParameters>]
Description
您必須已獲指派權限，才能執行此指令程式。 雖然這篇文章列出了 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.emlBase64，基於$e.BodyEncoding) 值 (。 - 第二個指令將 Eml 屬性從 Base64 轉換成 ASCII 文字，並將結果儲存在變數
$txt中。 - 第三個指令將隔離訊息寫入指定的.eml檔案。
注意：不要用引號包住身份值， (可能會) 錯誤。
範例 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 屬性中，) Base64 ($f.eml，基於$f.BodyEncoding) 值 (。 - 第二個指令將 Base64 的 Eml 屬性轉換為位元組，並將結果儲存在變數
$bytes中。 - 第三個指令將隔離的訊息和附件寫入指定的.eml檔案。
參數
-CompressOutput
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
CompressOutput 開關會將訊息匯出為壓縮後的 .zip 檔案。 您不需要使用此參數指定值。
對於匯出的訊息，包括帶有附件的訊息，.zip 檔案包含一個資料夾，名稱來自 Identity 中的第一個 GUID 值。 資料夾包含以身份碼中第二個 GUID 值命名的.eml訊息。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-EntityType
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
EntityType 參數會依 EntityType 來篩選結果。 有效值為：
- 電子郵件
- SharePointOnline
- 目前 (Teams 處於預覽)
- 資料遺失防止
參數屬性
| 類型: | Microsoft.Exchange.Management.FfoQuarantine.EntityType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ForceConversionToMime
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
ForceConversionToMime 切換器將匯出的純文字訊息轉換為 MIME 格式。 您不需要使用此參數指定值。
若訊息已編碼為 Base64，此交換器無效。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identities
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
身份參數用來識別被隔離的訊息用於批量操作。 你可以透過語法來識別訊息： value1,value2...valueN。 每個值都是唯一的隔離訊息識別碼，格式 GUID1\GUID2 為 (c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 例如) 。
您可以使用 Get-QuarantineMessage Cmdlet，找到已隔離郵件的 Identity值。
使用此參數時，需輸入身份參數，但該值會被忽略。 例如，使用 Identity 參數的值 000。
參數屬性
| 類型: | QuarantineMessageIdentity[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identities
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
Identity 參數會指定你想匯出的隔離訊息。 該值是一個唯一的隔離訊息識別碼，格式為 GUID1\GUID2 (c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 例如) 。
您可以使用 Get-QuarantineMessage Cmdlet，找到已隔離郵件的 Identity值。
參數屬性
| 類型: | QuarantineMessageIdentity |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identities
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
IdentityOnly
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Password
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
密碼參數指定開啟匯出訊息所需的密碼。
你可以用以下方法作為這個參數的值：
-
(ConvertTo-SecureString -String '<password>' -AsPlainText -Force). - 執行這個指令前，先把密碼儲存為變數， (例如)
$password = Read-Host "Enter password" -AsSecureString，然後用變數 ($password) 來表示數值。 -
(Get-Credential).password執行此指令時，系統會提示你安全輸入密碼。
若要以純文字輸入密碼，請使用 PasswordV2 參數。
參數屬性
| 類型: | SecureString |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PasswordV2
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
PasswordV2 參數指定開啟匯出訊息所需的密碼明文值。 以引號包圍該數值，例如 ('<password>') 。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ReasonForExport
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
ReasonForExport 參數會指定為何匯出該訊息。 如果值包含空格，請使用引號 (") 括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecipientAddress
適用：Exchange Online、安全 & 合規、內建本地郵箱安全附加元件
RecipientAddress 參數會依收件者電子郵件地址來篩選結果。 您可以指定多個以逗號分隔的值。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。