Start-HistoricalSearch
此指令程式只能在雲端式服務中使用。
使用 Start-HistoricalSearch Cmdlet 開始新的歷程記錄搜尋。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Start-HistoricalSearch
-EndDate <DateTime>
-ReportTitle <String>
-ReportType <HistoricalSearchReportType>
-StartDate <DateTime>
[-BlockStatus <String>]
[-CompressFile <Boolean>]
[-ConnectorType <String>]
[-DeliveryStatus <String>]
[-Direction <MessageDirection>]
[-DLPPolicy <MultiValuedProperty>]
[-EncryptionTemplate <String>]
[-EncryptionType <String>]
[-Locale <CultureInfo>]
[-MessageID <MultiValuedProperty>]
[-NetworkMessageID <MultiValuedProperty>]
[-NotifyAddress <MultiValuedProperty>]
[-OriginalClientIP <String>]
[-RecipientAddress <MultiValuedProperty>]
[-SenderAddress <MultiValuedProperty>]
[-SmtpSecurityError <String>]
[-TLSUsed <String>]
[-TransportRule <MultiValuedProperty>]
[-Url <String>]
[<CommonParameters>]
Description
歷程記錄搜尋以逗號分隔值 (CSV) 檔案提供訊息追蹤和報告詳細資料，以處理年齡介於 1 到 4 小時之間的訊息 (視您的環境而定) 到 90 天。 您最多可以提交 250 個歷史搜尋，並在 24 小時內提交。 如果您接近每日配額，您會收到警告。 取消的搜尋會計入每日配額。 此外，在每個 CSV 檔案中，有 100000 個結果或行的限制。
如果您指定通訊群組，結果中可能不會傳回所有訊息。 若要確保所有郵件都會傳回，請指定個別收件者。
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Start-HistoricalSearch -ReportTitle "Fabrikam Search" -StartDate 1/1/2023 -EndDate 1/7/2023 -ReportType MessageTrace -SenderAddress michelle@fabrikam.com -NotifyAddress chris@contoso.com
此範例會開始名為 “Fabrikam Search” 的新歷史搜尋，具有下列屬性：
- 日期範圍：2023 年 1 月 1 日到 2023 年 1 月 6 日。 因為我們沒有指定時間，所以會使用值 0：00 AM。 在此範例中，日期範圍相當於 -StartDate “1/1/2023 0：00 AM” -EndDate “1/7/2023 0：00 AM”
- 報表類型：訊息追蹤
- 寄件者地址： michelle@fabrikam.com
- 內部通知電子郵件地址： chris@contoso.com
參數
-BlockStatus
適用：Exchange Online、內部部署信箱的內建安全性附加元件
BlockStatus 參數會依向外部傳送的訊息、因安全性檢查而封鎖的訊息或成功傳送的訊息的狀態來篩選 OutboundSecurityReport 報告中的結果。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CompressFile
適用：Exchange Online、內部部署信箱的內建安全性附加元件
{{ Fill CompressFile 描述 }}
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ConnectorType
適用：Exchange Online、內部部署信箱的內建安全性附加元件
ConnectorType 參數會依連接器類型篩選 ConnectorReport 報告中的結果。 有效值為：
- 內部部署
- Partner
- NoConnector
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DeliveryStatus
適用：Exchange Online、內部部署信箱的內建安全性附加元件
DeliveryStatus 參數會依訊息的傳遞狀態來篩選結果。 您可以使用下列其中一個值：
- 已傳遞
- Expanded
- 失敗
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Direction
適用：Exchange Online、內部部署信箱的內建安全性附加元件
Direction 參數會依訊息的方向篩選結果。 有效值為：
- 全部： 內送和外寄郵件。
- 已接收：僅限內送郵件。
- 已傳送：僅限傳出訊息。
參數屬性
| 類型: | MessageDirection |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DLPPolicy
適用：Exchange Online、內部部署信箱的內建安全性附加元件
DLPPolicy 參數會依據處理郵件的 DLP 原則名稱來篩選結果。 您可以指定多個 DLP 原則，並以逗號分隔。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-EncryptionTemplate
適用：Exchange Online、內部部署信箱的內建安全性附加元件
{{ Fill EncryptionTemplate 描述 }}
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-EncryptionType
適用：Exchange Online、內部部署信箱的內建安全性附加元件
{{ 填滿加密類型說明 }}
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-EndDate
適用：Exchange Online、內部部署信箱的內建安全性附加元件
EndDate 參數會指定日期範圍的結束日期。
在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如，如果電腦設定為使用簡短的日期格式 MM/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期，或者也可以輸入日期和時間。 如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/2018 5:00 PM"。
如果未指定時間，則會使用預設值 0：00 AM。 例如，值 12/31/2022 實際上是「12/31/2022 0：00 AM」，這表示不包含 2022 年 12 月 31 日的資料 (只包含 2022 年 12 月 30 日的資料) 。
您也必須在命令中使用至少一個下列參數：MessageID、RecipientAddress 或 SenderAddress。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Locale
適用：Exchange Online、內部部署信箱的內建安全性附加元件
Locale 參數會依訊息的地區設定來篩選結果。
此參數的有效輸入是來自 Microsoft .NET Framework CultureInfo 類別的支援文化代碼值。 例如，丹麥文為 da-DK 或日文為 ja-JP。 如需詳細資訊，請參閱 CultureInfo 類別。
參數屬性
| 類型: | CultureInfo |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| 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”) 。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NetworkMessageID
適用：Exchange Online、內部部署信箱的內建安全性附加元件
NetworkMessageId 參數將根據 NetworkMessageId 欄位的值篩選郵件追蹤記錄項目。 此欄位包含唯一的訊息識別碼值，該值會跨可能因分叉或通訊群組擴充而建立的訊息複本保留。 範例值是 1341ac7b13fb42ab4d4408cf7f55890f。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NotifyAddress
適用：Exchange Online、內部部署信箱的內建安全性附加元件
NotifyAddress 參數會指定內部收件者的電子郵件地址，以便在歷史搜尋完成時通知。 電子郵件地址必須位於為您的組織設定的接受網域中。 您可以輸入多個電子郵件地址，並以逗號分隔。
若要檢視歷程記錄搜尋的結果，您必須為 NotifyAddress 參數指定至少一個電子郵件地址。 否則，您必須在 Exchange 系統管理中心的郵件 流程>郵件追蹤中按一下已完成的郵件追蹤。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-OriginalClientIP
適用：Exchange Online、內部部署信箱的內建安全性附加元件
OriginalClientIP 參數會依訊息的原始 IP 位址來篩選結果。 針對傳入郵件，OriginalClientIP 值是寄件者的 IP 位址。 針對外寄郵件，OriginalClientIP 值是接收訊息之外部 SMTP 伺服器的 IP 位址。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecipientAddress
適用：Exchange Online、內部部署信箱的內建安全性附加元件
RecipientAddress 參數會依收件者電子郵件地址來篩選結果。 您可以指定多個以逗號分隔的值。 位址數目上限為 100。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | True |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ReportTitle
適用：Exchange Online、內部部署信箱的內建安全性附加元件
ReportTitle 參數會指定歷程記錄搜尋的描述性名稱。 如果值包含空格，請使用引號 (") 括住值。
您也必須在命令中使用至少一個下列參數：MessageID、RecipientAddress 或 SenderAddress。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ReportType
適用：Exchange Online、內部部署信箱的內建安全性附加元件
ReportType 參數會指定您想要執行的歷史搜尋類型。 您可以使用下列其中一個值：
- ATPReport：適用於 Office 365 的 Defender 檔案類型報告與適用於 Office 365 的 Defender 郵件處置報告
- ConnectorReport：傳入/傳出郵件報表。
- DLP：資料外洩防護報告。
- MessageTrace：訊息追蹤報告。
- MessageTraceDetail： 訊息追蹤詳細資料報告。
- OutboundSecurityReport： 傳輸中的輸出郵件安全性報告。
- P2SenderAttribution：P2 寄件者屬性報告。
- SPAM：垃圾郵件偵測報告。
- 欺騙：欺騙郵件報告。
- TransportRule：傳輸或郵件流程規則報告。
- UnifiedDLP：統一的資料外洩防護報告。
您也必須在命令中使用至少一個下列參數：MessageID、RecipientAddress 或 SenderAddress。
參數屬性
| 類型: | HistoricalSearchReportType |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SenderAddress
適用：Exchange Online、內部部署信箱的內建安全性附加元件
SenderAddress 參數會依寄件者電子郵件地址來篩選結果。 您可以指定多個以逗號分隔的值。 位址數目上限為 100。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SmtpSecurityError
適用：Exchange Online、內部部署信箱的內建安全性附加元件
SmtpSecurityError 參數會依據外部傳送時封鎖郵件的錯誤類型來篩選 OutboundSecurityReport 報告中的結果。
參數屬性
| 類型: | 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"。
參數屬性
| 類型: | DateTime |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-TLSUsed
適用：Exchange Online、內部部署信箱的內建安全性附加元件
TLSUsed 參數會依 TLS 版本篩選 ConnectorReport 報告中的結果。 有效值為：
- 無 TLS
- TLS1.2
- TLS1.3
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TransportRule
適用：Exchange Online、內部部署信箱的內建安全性附加元件
TransportRule 參數會依 Exchange 郵件流程規則 (也稱為對郵件採取作用的傳輸規則) 的名稱來篩選結果。 您可以指定多個傳輸規則，並以逗號分隔。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Url
適用：Exchange Online、內部部署信箱的內建安全性附加元件
{{ 填滿網址說明 }}
參數屬性
| 類型: | 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。
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。