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