Start-HistoricalSearch

構文

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>]

説明

例

例 1

Start-HistoricalSearch -ReportTitle "Fabrikam Search" -StartDate 1/1/2023 -EndDate 1/7/2023 -ReportType MessageTrace -SenderAddress michelle@fabrikam.com -NotifyAddress chris@contoso.com

パラメーター

-BlockStatus

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

BlockStatus パラメーターは、外部に送信されたメッセージ、セキュリティ チェックのためにブロックされたメッセージ、または正常に送信されたメッセージの状態によって、OutboundSecurityReport レポートの結果をフィルター処理します。

パラメーターのプロパティ

パラメーター セット

-CompressFile

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

{{ Fill CompressFile Description }}

パラメーターのプロパティ

パラメーター セット

-ConnectorType

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

ConnectorType パラメーターは、コネクタ タイプで ConnectorReport レポートの結果をフィルタリングします。 有効な値は次のとおりです。

• オンプレミス
• パートナー
• NoConnector

パラメーターのプロパティ

パラメーター セット

-DeliveryStatus

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

DeliveryStatus パラメーターは、メッセージの配信状態で結果をフィルター処理します。 次のいずれかの値を使用できます。

• 配信済み
• Expanded
• 失敗

パラメーターのプロパティ

パラメーター セット

-Direction

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

Direction パラメーターは、メッセージの方向によって結果をフィルター処理します。 有効な値は次のとおりです。

• すべて: 受信メッセージと送信メッセージ。
• 受信済み: 受信メッセージのみ。
• 送信済み: 送信メッセージのみ。

パラメーターのプロパティ

パラメーター セット

-DLPPolicy

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

DLPPolicy パラメーターは、メッセージを処理する DLP ポリシーの名前で結果をフィルター処理します。 複数の DLP ポリシーをコンマで区切って指定できます。

パラメーターのプロパティ

パラメーター セット

-EncryptionTemplate

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

{{ Fill: EncryptionTemplate description }}

パラメーターのプロパティ

パラメーター セット

-EncryptionType

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

{{ EncryptionType の説明の入力 }}

パラメーターのプロパティ

パラメーター セット

-EndDate

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

EndDate パラメーターには、日付範囲の終了日を指定します。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 MM/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

時刻を指定しない場合は、デフォルト値である午前 0:00 が使用されます。 たとえば、値 12/31/2022 は実際には "12/31/2022 0:00 AM" であり、2022 年 12 月 31 日のデータは含まれません (2022/12/30 のデータのみが含まれます)。

また、コマンドで少なくとも 1 つのパラメーター (MessageID、RecipientAddress、または SenderAddress) を使用する必要があります。

パラメーターのプロパティ

パラメーター セット

-Locale

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

Locale パラメーターは、メッセージのロケールで結果をフィルター処理します。

このパラメーターの正しい入力は、Microsoft .NET Framework CultureInfo クラスでサポートされているカルチャ コード値です。 たとえば、デンマーク語の場合には da-DK、日本語の場合には ja-JP となります。 詳細については、「CultureInfo クラス」を参照してください。

パラメーターのプロパティ

パラメーター セット

-MessageID

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

MessageId パラメーターは、メッセージの Message-ID 件名フィールド別に結果をフィルター処理します。 この値はクライアント ID とも呼ばれます。 Message-ID の形式は、メッセージを送信したメッセージング サーバーによって異なります。 値はメッセージごとに一意である必要があります。 ただし、すべてのメッセージング サーバーが同じ方法で Message-ID の値を作成するわけではありません。 メッセージ ID の完全な文字列 (山かっこを含む場合があります) を必ず含め、値を引用符で囲みます (たとえば、"d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com")。

パラメーターのプロパティ

パラメーター セット

-NetworkMessageID

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

NetworkMessageId パラメーターは、NetworkMessageId フィールドの値でメッセージ追跡ログ エントリをフィルター処理します。 このフィールドには、分岐または配布グループの拡張によって作成される可能性があるメッセージのコピー間で保持される一意のメッセージ ID 値が含まれます。 たとえば、1341ac7b13fb42ab4d4408cf7f55890f のような値です。

パラメーターのプロパティ

パラメーター セット

-NotifyAddress

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

NotifyAddress パラメーターは、履歴検索が完了した時に通知する内部の受信者の電子メール アドレスを指定します。 この電子メール アドレスは、組織用に構成された承認済みドメイン内になければなりません。 複数の電子メール アドレスをコンマで区切って入力できます。

履歴検索の結果を表示するには、NotifyAddress パラメーターに少なくとも 1 つの電子メール アドレスを指定する必要があります。 それ以外の場合は、メール フロー>メッセージ追跡の Exchange 管理センターで完了したメッセージ追跡をクリックする必要があります。

パラメーターのプロパティ

パラメーター セット

-OriginalClientIP

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

OriginalClientIP パラメーターは、メッセージの元の IP アドレスで結果をフィルター処理します。 受信メッセージの場合は、OriginalClientIP 値が送信者の IP アドレスです。 送信メッセージの場合、OriginalClientIP 値は、メッセージを受信した外部 SMTP サーバーの IP アドレスです。

パラメーターのプロパティ

パラメーター セット

-RecipientAddress

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

RecipientAddress パラメーターは、受信者の電子メール アドレスで結果をフィルター処理します。 複数の値をコンマで区切って指定できます。 アドレスの最大数は 100 です。

パラメーターのプロパティ

パラメーター セット

-ReportTitle

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

ReportTitle パラメーターは、履歴検索のわかりやすい名前を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

また、コマンドで少なくとも 1 つのパラメーター (MessageID、RecipientAddress、または SenderAddress) を使用する必要があります。

パラメーターのプロパティ

パラメーター セット

-ReportType

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

ReportType パラメーターは、実行する履歴検索の種類を指定します。 次のいずれかの値を使用できます。

• ATPReport: Defender for Office 365 のファイルの種類レポートと Defender for Office 365 メッセージの基質レポート
• ConnectorReport: 受信/送信メッセージ レポート。
• DLP: データ損失防止レポート。
• MessageTrace: メッセージ追跡レポート。
• MessageTraceDetail: メッセージの追跡詳細レポート。
• OutboundSecurityReport: 送信中のメッセージのセキュリティ レポート。
• P2SenderAttribution: P2 送信者属性レポート。
• スパム: スパム検出レポート。
• なりすまし: なりすましメール報告。
• TransportRule: トランスポートまたはメール フロー ルール レポート。
• UnifiedDLP: 統合されたデータ損失防止レポート。

また、コマンドで少なくとも 1 つのパラメーター (MessageID、RecipientAddress、または SenderAddress) を使用する必要があります。

パラメーターのプロパティ

パラメーター セット

-SenderAddress

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

SenderAddress パラメーターは、送信者の電子メール アドレスで結果をフィルター処理します。 複数の値をコンマで区切って指定できます。 アドレスの最大数は 100 です。

パラメーターのプロパティ

パラメーター セット

-SmtpSecurityError

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

SmtpSecurityError パラメーターは、外部から送信されたときにブロックされたメッセージのエラーの種類で、OutboundSecurityReport レポートの結果をフィルター処理します。

パラメーターのプロパティ

パラメーター セット

-StartDate

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

StartDate パラメーターは、日付範囲の開始日を指定します。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 MM/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

パラメーターのプロパティ

パラメーター セット

-TLSUsed

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

TLSUsed パラメーターは、ConnectorReport レポートの結果を TLS バージョン別にフィルタリングします。 有効な値は次のとおりです。

• TLS なし
• TLS1.2
• TLS1.3

パラメーターのプロパティ

パラメーター セット

-TransportRule

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

TransportRule パラメーターは、メッセージに作用した Exchange メール フロー ルール (トランスポート ルールとも呼ばれます) の名前で結果をフィルター処理します。 複数のトランスポート ルールをコンマで区切って指定できます。

パラメーターのプロパティ

パラメーター セット

-Url

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

{{ URL の説明の入力 }}

パラメーターのプロパティ

パラメーター セット

CommonParameters

入力

Input types

出力

Output types