Get-SafeLinksAggregateReport

Модуль:
Exchange PowerShell

Этот командлет доступен только в облачной службе.

Используйте командлет Get-SafeLinksAggregateReport для возврата общих сведений о результатах безопасных ссылок за последние 90 дней. Вчера — это самая последняя дата, которую можно указать.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Default (По умолчанию) 

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

Применимо: Exchange Online

Параметр Action фильтрует результаты по действию. Допустимые значения:

  • Разрешено
  • Заблокировано
  • ЩелкнулоВо время сканирования
  • ЩелкнулоДажеЗаблокировано
  • Сканирование
  • TenantAllowed
  • TenantBlocked
  • TenantBlockedAndClickedThrough

Вы можете указать несколько значений, разделив их запятыми.

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-AppNameList

Применимо: Exchange Online

Параметр AppNameList фильтрует результаты по приложению, в котором была найдена ссылка. Допустимые значения:

  • Клиент Email
  • OfficeDocs
  • Teams

Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EndDate

Применимо: Exchange Online

Параметр EndDate указывает дату окончания из диапазона дат.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование короткого формата даты ММ/ДД/ГГГГ, введите 01.09.2018, чтобы указать 1 сентября 2018 года.

Вчера — это самая последняя дата, которую можно указать. Нельзя указать дату, которая старше 90 дней.

Свойства параметров

Тип:System.DateTime
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StartDate

Применимо: Exchange Online

Параметр StartDate указывает дату начала из диапазона дат.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование короткого формата даты ММ/ДД/ГГГГ, введите 01.09.2018, чтобы указать 1 сентября 2018 года.

Вчера — это самая последняя дата, которую можно указать. Нельзя указать дату, которая старше 90 дней.

Свойства параметров

Тип:System.DateTime
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SummarizeBy

Применимо: Exchange Online

Параметр SummarizeBy возвращает итоговый результат с учетом указанных значений. Если в вашем отчете данные фильтруются с помощью любого из допустимых значений этого параметра, параметр SummarizeBy можно использовать для вычисления итогового результата с учетом этих значений. Чтобы уменьшить количество строк, возвращаемых в отчете, можно использовать параметр SummarizeBy. Вычисление итогового результата уменьшает количество данных, полученных для отчета, и обеспечивает более быстрое предоставление отчета. Например, вместо отображения каждого экземпляра определенного значения Action или AppNameList в отдельной строке отчета можно использовать параметр SummarizeBy для просмотра общего количества экземпляров этого конкретного действия или приложения в одной строке отчета.

Для этого командлета допустимыми значениями:

  • Действие: возвращаются только значения, указанные в параметре Action.
  • App: возвращаются только значения, указанные в параметре AppNameList.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.