共用方式為


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