Поделиться через


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