Export-QuarantineMessage

模組:: Exchange PowerShell

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

使用 Export-QuarantineMessage Cmdlet 從雲端組織匯出隔離的郵件和檔案。郵件會匯出至 .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.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

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

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

針對匯出的郵件，包括含有附件的郵件，.zip 檔案包含以身分識別中的第一個 GUID 值命名的資料夾。該資料夾包含以識別中的第二個 GUID 值命名的.eml訊息。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EntityType

適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件

EntityType 參數會依 EntityType 篩選結果。有效值為：

電子郵件
SharePoint Online
Teams (目前處於預覽)
DataLossPrevention

參數屬性

類型:	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、安全性 & 合規性、內部部署信箱的內建安全性附加元件

Identities 參數可識別大量作業的隔離郵件。您可以使用語法來識別訊息： value1,value2...valueN。每個值都是唯一的隔離郵件識別碼，格式 GUID1\GUID2 為 (，例如 c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7) 。

您可以使用 Get-QuarantineMessage Cmdlet，找到已隔離郵件的 Identity值。

使用此參數時，必須使用 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、安全性 & 合規性、內部部署信箱的內建安全性附加元件

Password 參數會指定開啟匯出郵件所需的密碼。

您可以使用下列方法做為此參數的值：

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

意見反應

此頁面對您有幫助嗎？