Set-SafeLinksPolicy
Этот командлет доступен только в облачной службе.
Командлет Set-SafeLinksPolicy используется для изменения политик безопасных ссылок в облачной организации.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Set-SafeLinksPolicy
[-Identity] <SafeLinksPolicyIdParameter>
[-AdminDisplayName <String>]
[-AllowClickThrough <Boolean>]
[-Confirm]
[-CustomNotificationText <String>]
[-DeliverMessageAfterScan <Boolean>]
[-DisableUrlRewrite <Boolean>]
[-DoNotRewriteUrls <MultiValuedProperty>]
[-EnableForInternalSenders <Boolean>]
[-EnableOrganizationBranding <Boolean>]
[-EnableSafeLinksForEmail <Boolean>]
[-EnableSafeLinksForOffice <Boolean>]
[-EnableSafeLinksForTeams <Boolean>]
[-ScanUrls <Boolean>]
[-TrackClicks <Boolean>]
[-UseTranslatedNotificationText <Boolean>]
[-WhatIf]
[<CommonParameters>]
Описание
Безопасные ссылки — это функция в Microsoft Defender для Office 365, которая проверяет ссылки на наличие вредоносных веб-сайтов. Когда пользователь щелкает ссылку, URL-адрес временно переписывается и проверяется в списке известных вредоносных веб-сайтов. "Безопасные ссылки" включает функцию отчетов о трассировке URL-адреса, которая помогает определить пользователя, прошедшего по ссылке на вредоносный веб-сайт.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Set-SafeLinksPolicy -Identity "Engineering Block URL" -AllowClickThrough $false
В этом примере изменяется существующая политика безопасных ссылок с именем URL-адрес инженерного блока, чтобы запретить переход по исходным URL-адресам на страницах предупреждений.
Параметры
-AdminDisplayName
Применимо: Exchange Online
Параметр AdminDisplayName указывает описание политики. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AllowClickThrough
Применимо: Exchange Online
Параметр AllowClickThrough указывает, следует ли разрешить пользователям переходить по исходному URL-адресу на страницах предупреждений. Допустимые значения:
$true: пользователю разрешено переходить по исходному URL-адресу. $false. Пользователю не разрешено переходить по исходному URL-адресу.
В PowerShell значение по умолчанию — $false. В новых политиках безопасных ссылок, созданных на портале Microsoft Defender, значение по умолчанию — $true.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Online
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CustomNotificationText
Применимо: Exchange Online
В пользовательском тексте уведомления указывается настраиваемый текст уведомления, который будет отображаться пользователям. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DeliverMessageAfterScan
Применимо: Exchange Online
Параметр DeliverMessageAfterScan указывает, следует ли доставлять сообщения электронной почты только после завершения проверки безопасных ссылок. Допустимые значения:
- $true. Дождитесь завершения проверки безопасных ссылок перед доставкой сообщения. Это значение является значением по умолчанию. Сообщения, содержащие вредоносные ссылки, не доставляются.
- $false. Если проверка безопасных ссылок не удается завершить, добавьте сообщение в любом случае.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DisableUrlRewrite
Применимо: Exchange Online
Параметр DisableUrlRewrite указывает, следует ли перезаписывать (упаковывать) URL-адреса в сообщениях электронной почты. Допустимые значения:
- $true: URL-адреса в сообщениях не переписываются, но сообщения по-прежнему проверяются безопасными ссылками перед доставкой. Проверка времени нажатия ссылок выполняется с помощью API безопасных ссылок в поддерживаемых клиентах Outlook (в настоящее время Outlook для Windows и Outlook для Mac).
- $false: URL-адреса в сообщениях переписываются. Проверки API по-прежнему выполняются для незавернутых URL-адресов в поддерживаемых клиентах, если пользователь находится в допустимой политике безопасных ссылок.
В PowerShell значение по умолчанию — $false. В новых политиках безопасных ссылок, созданных на портале Microsoft Defender, значение по умолчанию — $true.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DoNotRewriteUrls
Применимо: Exchange Online
Параметр DoNotRewriteUrls указывает URL-адреса, которые не переписываются при проверке безопасных ссылок. Список записей позволяет пользователям, включенным в политику, получать доступ к указанным URL-адресам, которые в противном случае были бы заблокированы безопасными ссылками.
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
Дополнительные сведения о синтаксисе записи см. в разделе Синтаксис записи для списка "Не переписывать следующие URL-адреса".
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EnableForInternalSenders
Применимо: Exchange Online
Параметр EnableForInternalSenders указывает, применяется ли политика безопасных связей к сообщениям, отправляемых между внутренними отправителями и внутренними получателями в одной Exchange Online организации. Допустимые значения:
- $true. Политика применяется к внутренним и внешним отправителям. Это значение является значением по умолчанию.
- $false. Политика применяется только к внешним отправителям.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EnableOrganizationBranding
Применимо: Exchange Online
Параметр EnableOrganizationBranding указывает, отображается ли логотип вашей организации на страницах предупреждений и уведомлений о безопасных ссылках. Допустимые значения:
- $true: фирменная символика организации отображается на страницах предупреждений и уведомлений о безопасных ссылках. Перед настройкой этого значения необходимо выполнить инструкции, описанные в разделе Настройка темы Microsoft 365 для вашей организации для отправки логотипа компании.
- $false: фирменная символика организации не отображается на страницах предупреждений и уведомлений о безопасных ссылках. Это значение является значением по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EnableSafeLinksForEmail
Применимо: Exchange Online
Параметр EnableSafeLinksForEmail указывает, следует ли включить защиту безопасных ссылок для сообщений электронной почты. Допустимые значения:
- $true: для электронной почты включены безопасные ссылки. Это значение является значением по умолчанию. Когда пользователь щелкает ссылку в сообщении электронной почты, ссылка проверяется с помощью безопасных ссылок. Если ссылка окажется вредоносной, в веб-браузере по умолчанию появится страница предупреждения.
- $false. Безопасные ссылки не включены для электронной почты.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EnableSafeLinksForOffice
Применимо: Exchange Online
Параметр EnableSafeLinksForOffice указывает, следует ли включить защиту безопасных ссылок для поддерживаемых классических, мобильных или веб-приложений Office. Допустимые значения:
- $true. Проверка безопасных ссылок включена в приложениях Office. Это значение является значением по умолчанию. Когда пользователь открывает файл в поддерживаемом приложении Office и щелкает ссылку в файле, ссылка проверяется с помощью безопасных ссылок. Если ссылка окажется вредоносной, в веб-браузере по умолчанию появится страница предупреждения.
- $false. Безопасные ссылки не включены для приложений Office.
Эта защита применяется к ссылкам в документах Office, а не к ссылкам в сообщениях электронной почты.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EnableSafeLinksForTeams
Применимо: Exchange Online
Параметр EnableSafeLinksForTeams указывает, включены ли безопасные ссылки для Microsoft Teams. Допустимые значения:
- $true. Безопасные ссылки включены для Teams. Это значение является значением по умолчанию. Когда пользователь щелкает ссылку в беседе Teams, групповом чате или из каналов, ссылка проверяется с помощью безопасных ссылок. Если ссылка окажется вредоносной, в веб-браузере по умолчанию появится страница предупреждения.
- $false. Безопасные ссылки для Teams не включены.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Online
Параметр Identity определяет политику безопасных ссылок, которую требуется изменить. Вы можете использовать любое уникальное значение, определяющее политику. Например:
- имя;
- различающееся имя (DN);
- GUID
Свойства параметров
| Тип: | SafeLinksPolicyIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ScanUrls
Применимо: Exchange Online
Параметр ScanUrls указывает, следует ли включать или отключать сканирование в режиме реального времени для щелчков ссылок в сообщениях электронной почты. Допустимые значения:
- $true: в режиме реального времени включено сканирование ссылок, в том числе ссылок, указывающих на файлы. Это значение является значением по умолчанию.
- $false: сканирование в режиме реального времени для ссылок, в том числе ссылок, указывающих на файлы, отключено.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TrackClicks
Применимо: Exchange Online
Параметр TrackClicks указывает, следует ли отслеживать переходы пользователей, связанные с защитой ссылок от безопасных ссылок. Допустимые значения:
- $true: щелчки пользователей отслеживаются. Это значение является значением по умолчанию.
- $false: щелчки пользователей не отслеживаются.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UseTranslatedNotificationText
Применимо: Exchange Online
UseTranslatedNotificationText указывает, следует ли использовать Microsoft Translator для автоматической локализации пользовательского текста уведомления, указанного с помощью параметра CustomNotificationText. Допустимые значения:
- $true. Перевод пользовательского текста уведомления на язык пользователя.
- $false: не переводите текст пользовательского уведомления на язык пользователя. Это значение является значением по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Online
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.