Get-SafeLinksAggregateReport
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Get-SafeLinksAggregateReport コマンドレットを使用して、過去 90 日間の安全なリンクの結果に関する一般的な情報を返します。 昨日は、指定できる最新の日付です。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-SafeLinksAggregateReport
[-Action <MultiValuedProperty>]
[-AppNameList <MultiValuedProperty>]
[-EndDate <System.DateTime>]
[-StartDate <System.DateTime>]
[-SummarizeBy <String>]
[<CommonParameters>]
説明
注: 日付範囲を指定せずに Get-SafeLinksAggregateReport を実行すると、コマンドによって不明なエラーが返されます。
安全なリンクは、電子メール メッセージ内のリンクをチェックして、悪意のある Web サイトにつながるかどうかを確認する Microsoft Defender for Office 365 の機能です。 ユーザーがメッセージ内のリンクをクリックすると、一時的に URL が書き換えられて、悪意のある既知の Web サイトの一覧と照合されます。
指定したレポート期間に関して、コマンドレットは次の情報を返します。
- アクション
- アプリ
- MessageCount
- RecipientCount
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-SafeLinksAggregateReport -StartDate 06-01-2020 -EndDate 06-10-2020 -SummarizeBy App -AppNameList "Email Client","Teams"
この例では、指定された日付範囲の Email Client と Teams の結果によって要約された結果を返します。
パラメーター
-Action
適用対象: Exchange Online
Action パラメーターは、アクションで結果をフィルター処理します。 有効な値は次のとおりです。
- 許可
- Blocked
- ClickedDuringScan
- ClickedEvenBlocked
- スキャン
- TenantAllowed
- TenantBlocked
- TenantBlockedAndClickedThrough
複数の値をコンマで区切って指定できます。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AppNameList
適用対象: Exchange Online
AppNameList パラメーターは、リンクが見つかったアプリで結果をフィルター処理します。 有効な値は次のとおりです。
- Email Client
- OfficeDocs
- Teams
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndDate
適用対象: Exchange Online
EndDate パラメーターには、日付範囲の終了日を指定します。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 MM/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。
昨日は、指定できる最新の日付です。 90 日より前の日付は指定できません。
パラメーターのプロパティ
| 型: | System.DateTime |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-StartDate
適用対象: Exchange Online
StartDate パラメーターは、日付範囲の開始日を指定します。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 MM/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 2018 年 9 月 1 日を指定します。
昨日は、指定できる最新の日付です。 90 日より前の日付は指定できません。
パラメーターのプロパティ
| 型: | System.DateTime |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SummarizeBy
適用対象: Exchange Online
SummarizeBy パラメーターは、指定された値に基づいて合計を返します。 このパラメーターで受け入れられる値のいずれかを使用してレポートでデータをフィルターする場合、SummarizeBy パラメーターを使用してこれらの値に基づいて結果をまとめることができます。 レポートで返される行数を少なくするには、SummarizeBy パラメーターの使用を検討してください。 まとめることでレポート用に取得されるデータ量が少なくなるため、レポートの配信が迅速になります。 たとえば、レポート内の個々の行に Action または AppNameList の特定の値の各インスタンスを表示する代わりに、SummarizeBy パラメーターを使用すると、レポートの 1 行にその特定の Action または App のインスタンスの合計数を表示できます。
このコマンドレットの有効な値は次のとおりです。
- Action: Action パラメーターで指定された値のみが返されます。
- アプリ: AppNameList パラメーターで指定された値のみが返されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。