Get-MailTrafficEncryptionReport

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

使用 Get-MailTrafficEncryptionReport Cmdlet 來檢視過去 92 天雲端式組織中的加密結果。

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

語法

Default (預設值)

Get-MailTrafficEncryptionReport

    [-Action <MultiValuedProperty>]
    [-AggregateBy <String>]
    [-Direction <MultiValuedProperty>]
    [-Domain <MultiValuedProperty>]
    [-EndDate <System.DateTime>]
    [-EventType <MultiValuedProperty>]
    [-Page <Int32>]
    [-PageSize <Int32>]
    [-ProbeTag <String>]
    [-StartDate <System.DateTime>]
    [-SummarizeBy <MultiValuedProperty>]
    [<CommonParameters>]

Description

針對您所指定的報告期間,Cmdlet 會傳回下列資訊:

  • DateTime
  • 事件類型
  • 方向
  • 動作
  • 訊息計數
  • 收件者計數

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

範例

範例 1

Get-MailTrafficEncryptionReport -Direction Inbound -StartDate 12/13/2021 -EndDate 12/15/2021

本範例擷取 2021 年 12 月 13 日到 2021 年 12 月 15 日之間傳入郵件的加密資訊。

參數

-Action

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

此 Action 參數會依據對郵件採取的動作來篩選報告。 若要檢視此參數有效值的完整清單,請執行命令: Get-MailFilterListReport -SelectionTarget Actions。 您指定的動作必須對應至報表類型。 例如,您只能為惡意程式碼報告指定惡意程式碼篩選動作。

Action 參數會依照 DLP 原則、傳輸規則、惡意程式碼篩選或垃圾郵件篩選所採取的動作篩選報告。若要檢視此參數完整的有效值清單,請執行 Get-MailFilterListReport -SelectionTarget Actions 命令。您指定的動作必須有對應的報告類型。例如,您只能為惡意程式碼報告指定惡意程式碼篩選動作。

參數屬性

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

參數集

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

-AggregateBy

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

AggregateBy 參數會指定報告週期。 有效值為:Hour、Day 或 Summary。 預設值為 Day。

參數屬性

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

參數集

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

-Direction

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

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

  • 輸入
  • 出埠

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

參數屬性

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

參數集

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

-Domain

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

Domain 參數會依雲端式組織中公認的網域來篩選結果。 您可以指定多個以逗號分隔的網域值或是 All 值。

參數屬性

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

參數集

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

-EndDate

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

EndDate 參數會指定日期範圍的結束日期。

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

參數屬性

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

參數集

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

-EventType

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

EventType 參數會依事件類型篩選報告。 有效值為:

  • EncryptionManual
  • EncryptionPolicy

若要檢視此參數有效值的潛在清單,請執行命令: Get-MailFilterListReport -SelectionTarget EventTypes。 事件類型必須與報告相對應。

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

參數屬性

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

參數集

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

-Page

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

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

參數屬性

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

參數集

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

-PageSize

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

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

參數屬性

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

參數集

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

-ProbeTag

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

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

參數屬性

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

參數集

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

-StartDate

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

StartDate 參數會指定日期範圍的開始日期。

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

參數屬性

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

參數集

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

-SummarizeBy

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

SummarizeBy 參數根據您指定的值傳回總和。 若您的報告是使用此參數接受的任何值篩選資料,則可使用 SummarizeBy 參數以基於該類值執行總和運算。 若要減少報告中傳回的列數,您可考慮使用 SummarizeBy 參數。 摘要可減少為報表擷取的資料量,並更快地傳遞報表。 例如:您可以不要在報告中的個別列上查看 EventType 之某個特定值的每個執行個體,而可使用 SummarizeBy 參數來查看報告中某列上 EventType 之值的執行個體總數。

對此 Cmdlet,有效值為:

  • 動作
  • 網域
  • EventType

您可以指定多個以逗號分隔的值。 當您指定 [動作] 或 [網域] 值時,結果中不會顯示該值, (對應資料行中的值為空白) 。

參數屬性

類型:MultiValuedProperty
預設值: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。