Get-SafeLinksDetailReport
Этот командлет доступен только в облачной службе.
Используйте командлет Get-SafeLinksDetailReport для возврата подробных сведений о результатах безопасных ссылок за последние 7 дней. Вчера — это последняя дата, которую можно указать.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (по умолчанию)
Get-SafeLinksDetailReport
[-Action <MultiValuedProperty>]
[-AppNameList <MultiValuedProperty>]
[-Domain <MultiValuedProperty>]
[-EndDate <System.DateTime>]
[-Page <Int32>]
[-PageSize <Int32>]
[-RecipientAddress <MultiValuedProperty>]
[-StartDate <System.DateTime>]
[<CommonParameters>]
Описание
Примечание. При выполнении Get-SafeLinksDetailReport без указания диапазона дат команда возвращает не указанную ошибку.
Безопасные ссылки — это функция в Microsoft Defender для Office 365, которая проверяет ссылки в сообщениях электронной почты на наличие вредоносных веб-сайтов. Когда пользователь выбирает ссылку в сообщении, URL-адрес временно перезаписывается и сверяется со списком известных вредоносных веб-сайтов.
Этот командлет возвращает следующие сведения:
- ClickTime
- NetworkMessageId
- ClientMessageId
- SenderAddress
- RecipientAddress
- Url
- UrlDomain
- Действие
- AppName
- SourceId
- Организация
- DetectedBy (безопасные ссылки в Microsoft Defender для Office 365)
- UrlType (в настоящее время пустой)
- Флаги (0: разрешено, 1: заблокировано 2: ClickedEvenBlocked 3: ClickedDuringScan)
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-SafeLinksDetailReport -StartDate 06-07-2020 -EndDate 06-10-2020 -Action Allowed,Blocked -AppNameList "Email Client","Teams" -Domain google.com,teams.com -RecipientAddress faith@contoso.com,chris@contoso.com
В этом примере возвращается фильтрация результатов по следующим сведениям:
- Диапазон дат: с 7 июня 2020 г. по 10 июня 2020 г.
- Действие: разрешено и заблокировано
- AppNameList: клиент Email и Teams
- Домен URL-адресов: google.com и teams.com
- Адрес электронной почты получателя: faith@contoso.com и chris@contoso.com
Параметры
-Action
Применимо: Exchange Online
Параметр Action фильтрует результаты по действию. Допустимые значения:
- Разрешено: URL-адрес был разрешен из-за вердикта "Хороший".
- Заблокировано: URL-адрес был заблокирован из-за "Неправильного" вердикта.
- ClickedDuringScan: пользователь пропустил проверку URL-адреса и перешел к URL-адресу назначения до завершения сканирования безопасных ссылок.
- ClickedEvenBlocked: пользователь был заблокирован во время щелчка по URL-адресу.
- Сканирование: проверяется URL-адрес.
- TenantAllowed: URL-адрес разрешает запись в списке разрешенных и заблокированных клиентов.
- TenantBlocked: запись блока URL-адреса в списке разрешенных и заблокированных клиентов.
- TenantBlockedAndClickedThrough: URL-адрес был заблокирован из-за записи блока в списке разрешенных и заблокированных клиентов, и пользователь щелкнул страницу блокировки, чтобы получить доступ к URL-адресу.
Вы можете указать несколько значений, разделив их запятыми.
Примечание. Для значений этого параметра учитывается регистр. Нет данных, возвращаемых для действия, означает, что действие не произошло.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AppNameList
Применимо: Exchange Online
Параметр AppNameList фильтрует результаты по приложению, в котором была найдена ссылка. Допустимые значения:
- клиент Email
- Документы Office
- Teams
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Domain
Применимо: Exchange Online
Параметр Domain фильтрует результаты по домену в URL-адресе.
Вы можете указать несколько значений, разделив их запятыми.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-EndDate
Применимо: Exchange Online
Параметр EndDate указывает дату окончания из диапазона дат.
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если на компьютере настроен короткий формат даты ММ/дд/гггг, введите 01.09.2018, чтобы указать 1 сентября 2018 г.
Вчера — это последняя дата, которую можно указать. Нельзя указать дату старше 7 дней.
Свойства параметра
| Тип: | System.DateTime |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Page
Применимо: Exchange Online
Параметр Page указывает номер страницы результатов, которую необходимо просмотреть. Допустимое значение для этого параметра — целое число от 1 до 1000. Значение по умолчанию равно 1.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PageSize
Применимо: Exchange Online
Параметр PageSize указывает максимальное число записей на странице. Допустимое значение для этого параметра — целое число от 1 до 5000. Значение параметра по умолчанию — 1000.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RecipientAddress
Применимо: Exchange Online
Параметр RecipientAddress фильтрует результаты по адресу электронной почты получателя.
Вы можете указать несколько значений, разделив их запятыми.
Свойства параметра
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-StartDate
Применимо: Exchange Online
Параметр StartDate указывает дату начала из диапазона дат.
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если на компьютере настроен короткий формат даты ММ/дд/гггг, введите 01.09.2018, чтобы указать 1 сентября 2018 г.
Вчера — это последняя дата, которую можно указать. Нельзя указать дату старше 7 дней.
Свойства параметра
| Тип: | System.DateTime |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.