Get-QuarantineMessage

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

使用 Get-QuarantineMessage Cmdlet 來檢視雲端式組織中隔離的郵件和檔案。 Files 由 SharePoint、OneDrive 和 Microsoft Teams 的安全附件隔離。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。

語法

Details

Get-QuarantineMessage
    -Identity <QuarantineMessageIdentity>
    [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
    [-RecipientAddress <String[]>]
    [-SenderAddress <String[]>]
    [-TeamsConversationTypes <Microsoft.Exchange.Management.FfoQuarantine.TeamsConversationType[]>]
    [<CommonParameters>]

Summary

Get-QuarantineMessage

    [-Direction <Microsoft.Exchange.Management.FfoQuarantine.QuarantineMessageDirectionEnum>]
    [-Domain <String[]>]
    [-EndExpiresDate <System.DateTime>]
    [-EndReceivedDate <System.DateTime>]
    [-EntityType <Microsoft.Exchange.Management.FfoQuarantine.EntityType>]
    [-IncludeMessagesFromBlockedSenderAddress]
    [-MessageId <String>]
    [-MyItems]
    [-Page <Int32>]
    [-PageSize <Int32>]
    [-PolicyName <String>]
    [-PolicyTypes <QuarantinePolicyTypeEnum[]>]
    [-QuarantineTypes <QuarantineMessageTypeEnum[]>]
    [-RecipientAddress <String[]>]
    [-RecipientTag <String[]>]
    [-ReleaseStatus <ReleaseStatus[]>]
    [-Reported <Boolean>]
    [-SenderAddress <String[]>]
    [-StartExpiresDate <System.DateTime>]
    [-StartReceivedDate <System.DateTime>]
    [-Subject <String>]
    [-TeamsConversationTypes <Microsoft.Exchange.Management.FfoQuarantine.TeamsConversationType[]>]
    [-Type <Microsoft.Exchange.Management.FfoQuarantine.QuarantineMessageTypeEnum>]
    [<CommonParameters>]

Description

請勿使用此 Cmdlet 輸出中傳回給系統管理員的 PermissionTo* 屬性來決定郵件收件者可用的動作。 請改用 Get-QuarantinePolicy Cmdlet 來檢視指派的隔離原則中設定的使用者權限。 PermissionTo* 屬性反映執行 cmdlet 之使用者的權限。 它們不一定代表在指派給郵件的隔離原則下,郵件收件者可用的動作。

例如,有權釋出隔離郵件的系統管理員可能會看到 PermissionToRelease、PermissionToAllowSender 和 PermissionToDownload 屬性的值True,即使指派的隔離原則為 AdminOnlyAccessPolicy。 沒有發行權限的管理員和一般使用者會看到適用的使用者權限值。

您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-QuarantineMessage -StartReceivedDate 06/13/2017 -EndReceivedDate 06/15/2017

本範例會傳回在 2017 年 6 月 13 日到 2017 年 6 月 15 日之間隔離的郵件摘要清單。

範例 2

Get-QuarantineMessage -PageSize 50 -Page 3

此範例每頁呈現 50 個隔離郵件,並傳回結果的第三頁。

範例 3

Get-QuarantineMessage -MessageID "<5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com>"

此範例會傳回具有 Message-ID 值 <5c695d7e-6642-4681-a4b0-9e7a86613cb7@contoso.com>的隔離郵件。

範例 4

Get-QuarantineMessage -Identity c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7 | Format-List

此範例會傳回具有指定身分識別值之隔離郵件的詳細資訊。

範例 5

Get-QuarantineMessage -QuarantineTypes SPOMalware | Format-List

此範例會傳回受 SharePoint、OneDrive 和 Microsoft Teams 安全附件所保護檔案的詳細資訊。

參數

-Direction

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

Direction 參數會依內送或外寄郵件來篩選結果。 有效值為:

  • 輸入
  • 出埠

您可以指定多個以逗號分隔的值。

參數屬性

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

參數集

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

-Domain

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

將保留此參數供 Microsoft 內部使用。

參數屬性

類型:

String[]

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

參數集

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

-EndExpiresDate

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

EndExpiresDate 參數會指定從隔離區中自動刪除的最新郵件。 將此參數與 StartExpiresDate 參數搭配使用。

在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定為使用簡短的日期格式 MM/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。

例如,如果您指定今天日期的 StartExpiresDate 值和今天後三天的日期的 EndExpiresDate 值,您只會看到設定為在未來三天內從隔離區過期的郵件。

參數屬性

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

參數集

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

-EndReceivedDate

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

EndReceivedDate 參數會指定要在結果中傳回的最新訊息。 使用此參數搭配 StartReceivedDate 參數。

在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定為使用簡短的日期格式 MM/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。

參數屬性

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

參數集

Summary
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

-Identity

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

此 Identity 參數會指定您要檢視的隔離郵件。 此值是唯一的隔離郵件識別碼,格式 GUID1\GUID2 為 (,例如 c14401cf-aa9a-465b-cfd5-08d0f0ca37c5\4c2ca98e-94ea-db3a-7eb8-3b63657d4db7) 。

當您使用此參數來識別隔離訊息時,可以使用 RecipientAddress、QuarantineUser 和 ReleasedUser 屬性。 若要查看這些值,您必須使用格式設定 Cmdlet。 例如,Get-QuarantineMessage -Identity <Identity> | Format-List。

警告: Identity 參數的值 $null 或不存在的值會傳回 所有 物件,就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤,且不包含不存在的$null值。

參數屬性

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

參數集

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

-IncludeMessagesFromBlockedSenderAddress

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

IncludeMessagesFromBlockedSenderAddress 參數會指定是否要在結果中包含來自封鎖寄件者的隔離郵件。 您不需要使用此參數指定值。

參數屬性

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

參數集

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

-MessageId

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

MessageId 參數會依郵件的 Message-ID 標頭欄位來篩選結果。 此值也稱為「用戶端識別碼」。 Message-ID 的格式取決於傳送郵件的訊息伺服器。 每封郵件都僅具有唯一值。 然而,並非所有訊息伺服器都使用相同的方法來建立 Message-ID 的值。 請務必包含完整的訊息識別碼字串 (,其中可能包含尖括弧) 並將值括在引號中 ("<d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com>" 例如) 。

參數屬性

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

參數集

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

-MyItems

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

[我的項目] 參數會依您 (執行命令的使用者) 收件者的訊息來篩選結果。 您不需要使用此參數指定值。

參數屬性

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

參數集

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

-Page

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

Page 參數會指定您要檢視的結果頁數。 此參數的有效輸入是 1 與 1000 之間的整數。 預設值為 1。

參數屬性

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

參數集

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

-PageSize

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

PageSize 參數會指定每頁的顯示項目數上限。 此參數的有效輸入是 1 與 1000 之間的整數。 預設值為 100。

參數屬性

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

參數集

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

-PolicyName

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

PolicyName 參數會依隔離郵件的威脅原則 (篩選結果,例如,反惡意程式碼原則或反垃圾郵件原則) 。 您可以使用唯一識別原則的任何值。 例如:

  • 名稱
  • 辨別名稱 (DN)
  • GUID

參數屬性

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

參數集

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

-PolicyTypes

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

PolicyTypes 參數會依隔離訊息的威脅原則類型篩選結果。 有效值為:

  • AntiMalwarePolicy
  • AntiPhishPolicy
  • DataLossPreventionRule
  • ExchangeTransportRule (郵件流程規則)
  • HostedContentFilterPolicy (反垃圾郵件原則)
  • 僅限 Office 365) 的 SafeAttachmentPolicy (Microsoft Defender

您可以指定多個以逗號分隔的值。

參數屬性

類型:

QuarantinePolicyTypeEnum[]

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

參數集

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

-QuarantineTypes

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

QuarantineTypes 參數會根據導致郵件被隔離的原因來篩選結果。 有效值為:

  • 大量
  • DataLossPrevention
  • FileTypeBlock (所有雲端信箱的內建安全性功能中的反惡意程式碼原則篩選器 FileTypeBlock)
  • HighConfPhish
  • 惡意程式碼 (所有雲端信箱的安全附件原則中的反惡意程式碼原則,或適用於 Office 365) 的 Defender 中的安全附件原則
  • 網路釣魚
  • 垃圾郵件
  • SPOMalware (Microsoft Defender 僅適用於 Office 365)
  • TransportRule

您可以指定多個以逗號分隔的值。

您不需要將此參數與 Type 參數搭配使用。

針對由 SharePoint、OneDrive 和 Microsoft Teams 的安全附件隔離的檔案,您可以在輸出的 CustomData 欄位中找到偵測資訊。

參數屬性

類型:

QuarantineMessageTypeEnum[]

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

參數集

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

-RecipientAddress

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

RecipientAddress 參數會依收件者電子郵件地址來篩選結果。 您可以指定多個以逗號分隔的值。

參數屬性

類型:

String[]

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

參數集

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

-RecipientTag

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

RecipientTag 參數會依收件者的使用者標籤值 (例如) Priority Account 來篩選結果。 如需使用者標記的詳細資訊,請參閱適用於 Office 365 的 Defender 中的使用者標記。

您可以指定多個以逗號分隔的值。

參數屬性

類型:

String[]

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

參數集

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

-ReleaseStatus

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

ReleaseStatus 參數會依訊息的發行狀態來篩選結果。 有效值為:

  • 已核准
  • 已拒絕
  • 錯誤
  • NotReleased
  • PreparingToRelease
  • 已釋出
  • 已要求

您可以指定多個以逗號分隔的值。

注意:由於服務問題而由 Microsoft 隔離和發行的郵件具有 SystemReleased 屬性值 TRUE。 若要依系統發行的訊息篩選結果,請執行下列命令: Get-QuarantineMessage | where {$_.systemreleased -like "True"}。

參數屬性

類型:

ReleaseStatus[]

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

參數集

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

-Reported

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

Reported 參數會依據已回報為誤判的郵件來篩選結果。 有效值為:

  • $true:此命令只會傳回已回報為誤判的隔離郵件。
  • $false:命令只會傳回尚未回報為誤判的隔離郵件。

參數屬性

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

參數集

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

-SenderAddress

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

SenderAddress 參數會依寄件者電子郵件地址來篩選結果。 您可以指定多個以逗號分隔的值。

參數屬性

類型:

String[]

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

參數集

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

-StartExpiresDate

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

StartExpiresDate 參數會指定從隔離區中自動刪除的最早訊息。 將此參數與 EndExpiresDate 參數搭配使用。

在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定為使用簡短的日期格式 MM/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。

例如,如果您指定今天日期的 StartExpiresDate 值和今天後三天的日期的 EndExpiresDate 值,您只會看到設定為在未來三天內從隔離區過期的郵件。

參數屬性

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

參數集

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

-StartReceivedDate

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

StartReceivedDate 參數會指定結果中要傳回的最早訊息。 將此參數與 EndReceivedDate 參數搭配使用。

在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定為使用簡短的日期格式 MM/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。

根據預設,如果您未使用 StartReceivedDate 和 EndReceivedDate 參數,此命令會傳回過去 16 天的資料。 此參數的最大值為 30 天。 如果使用超過 30 天的值,則會忽略該值,且只會傳回過去 30 天的資料。

參數屬性

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

參數集

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

-Subject

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

Subject 參數會依郵件的 Subject 欄位篩選結果。 如果值包含空格,請使用引號 (") 括住值。

參數屬性

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

參數集

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

-TeamsConversationTypes

適用對象:安全性 & 合規性

此參數僅適用於安全性 & 合規性 PowerShell。

TeamsConversationTypes 參數會依 Microsoft Teams 交談類型篩選結果。 有效值為:

  • 通道
  • 聊天

您可以指定多個以逗號分隔的值。

參數屬性

類型:

Microsoft.Exchange.Management.FfoQuarantine.TeamsConversationType[]

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

參數集

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

-Type

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

Type 參數會根據導致郵件隔離的原因來篩選結果。 有效值為:

  • 大量
  • DataLossPrevention
  • HighConfPhish
  • 惡意程式碼
  • 網路釣魚
  • 垃圾郵件
  • SPOMalware (Microsoft Defender 僅適用於 Office 365)
  • TransportRule

您不需要將此參數與 QuarantineTypes 參數搭配使用。

對於受 SharePoint、OneDrive 和 Microsoft Teams 的安全附件保護的檔案,您可以在輸出的 CustomData 欄位中找到偵測資訊。

參數屬性

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

參數集

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

CommonParameters

此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。

輸入

Input types

若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。