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檔案。

附註：請勿將 [身分] 值括在引號中 (您可能會收到錯誤) 。

範例 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、安全 & 合規、Exchange Online Protection

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

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

參數屬性

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

參數集

(All)

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

-EntityType

適用：Exchange Online、安全 & 合規、Exchange Online Protection

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

電子郵件
線上 SharePoint
Teams (目前處於預覽版)
資料外洩防護

參數屬性

類型:	Microsoft.Exchange.Management.FfoQuarantine.EntityType
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

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

-ForceConversionToMime

適用：Exchange Online、安全 & 合規、Exchange Online Protection

ForceConversionToMime 參數會將匯出的純文字訊息轉換為 MIME 格式。您不需要使用此參數指定值。

如果訊息已編碼為 Base64，則此開關無效。

參數屬性

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

參數集

(All)

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

-Identities

適用：Exchange Online、安全 & 合規、Exchange Online Protection

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

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

當您使用此參數時，需要 Identity 參數，但會忽略該值。例如，將值 000 用於 Identity 參數。

參數屬性

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

參數集

Identities

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

-Identity

適用：Exchange Online、安全 & 合規、Exchange Online Protection

此 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、安全 & 合規、Exchange Online Protection

密碼參數指定開啟匯出訊息所需的密碼。

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

(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、安全 & 合規、Exchange Online Protection

PasswordV2 參數會指定開啟匯出訊息所需的密碼純文字值。將值括在引號中， (例如， '<password>') 。

參數屬性

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

參數集

(All)

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

-ReasonForExport

適用：Exchange Online、安全 & 合規、Exchange Online Protection

ReasonForExport 參數會指定匯出訊息的原因。如果值包含空格，請使用引號 (") 括住值。

參數屬性

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

參數集

(All)

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

-RecipientAddress

適用：Exchange Online、安全 & 合規、Exchange Online Protection

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。

意見反應

此頁面對您有幫助嗎？

共用方式為

Export-QuarantineMessage

語法

Identities

IdentityOnly

Description

範例

範例 1

範例 2

參數

-CompressOutput

參數屬性

參數集

-EntityType

參數屬性

參數集

-ForceConversionToMime

參數屬性

參數集

-Identities

參數屬性

參數集

-Identity

參數屬性

參數集

-Password

參數屬性

參數集

-PasswordV2

參數屬性

參數集

-ReasonForExport

參數屬性

參數集

-RecipientAddress

參數屬性

參數集

CommonParameters

意見反應