Get-SafeLinksAggregateReport
Этот командлет доступен только в облачной службе.
Используйте командлет Get-SafeLinksAggregateReport для возврата общих сведений о результатах безопасных связей за последние 90 дней. Вчера — это последняя дата, которую можно указать.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Get-SafeLinksAggregateReport
[-Action <MultiValuedProperty>]
[-AppNameList <MultiValuedProperty>]
[-EndDate <System.DateTime>]
[-StartDate <System.DateTime>]
[-SummarizeBy <String>]
[<CommonParameters>] Описание
Примечание. При выполнении Get-SafeLinksAggregateReport без указания диапазона дат команда вернет не указанную ошибку.
Безопасные ссылки — это функция в Microsoft Defender для Office 365, которая проверяет ссылки в сообщениях электронной почты на наличие вредоносных веб-сайтов. Когда пользователь выбирает ссылку в сообщении, URL-адрес временно перезаписывается и сверяется со списком известных вредоносных веб-сайтов.
Командлет возвращает следующие сведения за указанный отчетный период:
- Действие
- Приложение
- 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 клиента и Teams для указанного диапазона дат.
Параметры
-Action
Параметр Action фильтрует результаты по действию. Допустимые значения:
- Разрешено
- Заблокировано
- ClickedDuringScan
- ClickedEvenBlocked
- Сканирование
- TenantAllowed
- TenantBlocked
- TenantBlockedAndClickedThrough
Вы можете указать несколько значений, разделив их запятыми.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AppNameList
Параметр AppNameList фильтрует результаты по приложению, в котором была найдена ссылка. Допустимые значения:
- клиент Email
- Документы Office
- Teams
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EndDate
Параметр EndDate указывает дату окончания из диапазона дат.
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года.
Вчера — это последняя дата, которую можно указать. Нельзя указать дату старше 90 дней.
| Type: | System.DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-StartDate
Параметр StartDate указывает дату начала из диапазона дат.
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года.
Вчера — это последняя дата, которую можно указать. Нельзя указать дату старше 90 дней.
| Type: | System.DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SummarizeBy
Параметр SummarizeBy возвращает итоговый результат с учетом указанных значений. Если в вашем отчете данные фильтруются с помощью любого из допустимых значений этого параметра, параметр SummarizeBy можно использовать для вычисления итогового результата с учетом этих значений. Чтобы уменьшить количество строк, возвращаемых в отчете, можно использовать параметр SummarizeBy. Вычисление итогового результата уменьшает количество данных, полученных для отчета, и обеспечивает более быстрое предоставление отчета. Например, вместо просмотра каждого экземпляра определенного значения Action или AppNameList в отдельной строке отчета можно использовать параметр SummarizeBy, чтобы просмотреть общее количество экземпляров этого конкретного действия или приложения в одной строке отчета.
Для этого командлета допустимы следующие значения:
- Действие: возвращаются только значения, заданные параметром Action.
- Приложение: возвращаются только значения, заданные параметром AppNameList.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |